Skip to main content
GET
Get location details

Request contract

  • Method and path: GET /apis/v1/social/accounts/{accountId}/gmb-location-details
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details
  • accountId: path; required
  • locationId: query; optional
  • readMask: query; optional
  • Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

accountId
string
required

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$

Query Parameters

locationId
string

Override which location to query. If omitted, uses the account's selected location. Use GET /gmb-locations to list valid IDs.

readMask
string

Comma-separated fields to return. Available: name, title, phoneNumbers, categories, storefrontAddress, websiteUri, regularHours, specialHours, serviceArea, serviceItems, profile, openInfo, metadata, moreHours.

title and metadata are always included in the response so the location summary block can be populated, even if you omit them here.

location is a derived response field, not a Google readMask value: passing it returns 400.

Response

Location details fetched successfully

accountId
string

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
categories
object

Business categories (returned when readMask includes 'categories')

location
object | null

Compact public-facing summary derived from Google's metadata. Useful for surfacing the "leave a review" URL (e.g. behind a QR code) without parsing the raw block. Always populated regardless of readMask. For unverified or new locations Google omits placeId/reviewUrl/mapsUri, so those return as null and isVerified is false.

locationId
string
phoneNumbers
object
profile
object
regularHours
object
serviceItems
object[]

Services offered (returned when readMask includes 'serviceItems')

specialHours
object
success
boolean
title
string

Business name

websiteUri
string