GET
/
location
/
updates
cURL
curl --request GET \
  --url https://api.gmbapi.com/external-api/gmb/location/updates \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "payload": {
    "data": [
      {
        "api_token_id": "external-token-doc-id",
        "update_source": "API_UPDATE",
        "update_type": "LOCATION",
        "location_update_status": "IN_PROGRESS",
        "updateMask": [
          "title",
          "websiteUri"
        ],
        "timestamp": 1769795413131,
        "locationDto": {}
      },
      {
        "api_token_id": "external-token-doc-id",
        "update_source": "API_UPDATE",
        "update_type": "LOCATION",
        "location_update_status": "IN_PROGRESS",
        "updateMask": [
          "categories"
        ],
        "timestamp": 1769795413131,
        "locationDto": {
          "categories": {
            "primaryCategory": {
              "displayName": "Hair salon",
              "name": "categories/gcid:hair_salon"
            },
            "additionalCategories": [
              {
                "displayName": "Barber shop",
                "name": "categories/gcid:barber_shop"
              },
              {
                "displayName": "Beauty salon",
                "name": "categories/gcid:beauty_salon"
              }
            ]
          }
        }
      }
    ],
    "pagination": {
      "has_more": true,
      "next_page_token": "MTc2NDIzNDA5NjU2MQ==",
      "page_size": 5
    }
  }
}
Returns update history for a Google Business Profile location. Each update record describes the source of the update, its current processing status, the GBP field paths that were sent in updateMask, and the submitted locationDto.

​
Update Record

{
  "api_token_id": "external-token-doc-id",
  "update_source": "API_UPDATE",
  "update_type": "LOCATION",
  "location_update_status": "IN_PROGRESS",
  "updateMask": ["title", "websiteUri"],
  "timestamp": 1769795413131,
  "locationDto": {}
}

​
Response Fields

FieldTypeDescription
api_token_idstringID of the external API token that created the update.
update_sourcestringSource of the update, for example API_UPDATE.
update_typestringType of update. Location updates return LOCATION.
location_update_statusstringCurrent processing status, for example IN_PROGRESS, COMPLETED, or FAILED.
updateMaskstring[]Google Business Profile location fields included in the update.
timestampnumberUnix timestamp in milliseconds when the update was created.
locationDtoobjectLocation object in the format sent to the Google Business Profile API.

​
locationDto

locationDto contains the exact GBP API location payload that was submitted for the update. For example, a category update is returned in GBP API format: 
{
  "categories": {
    "primaryCategory": {
      "displayName": "Hair salon",
      "name": "categories/gcid:hair_salon"
    },
    "additionalCategories": [
      {
        "displayName": "Barber shop",
        "name": "categories/gcid:barber_shop"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
account_id
string

Account ID. Required when using an organization token.

​
location_id
string
required

Location ID to retrieve update history for

​
per_page
integer<int32>

Number of results per page. Minimum is 5, maximum is 10.

Required range: 5 <= x <= 10
​
page_token
string

Token for pagination. Use the next_page_token from the previous response to get the next page.

​
update_id
string

Specific update document ID. If provided, returns only the update with this ID instead of the full history.

Response

Location updates history response

Response containing location update history

​
success
boolean

Indicates if the request was successful

​
payload
object