PATCH
/
location
/
validate
/
update
cURL
curl --request PATCH \
  --url https://api.gmbapi.com/external-api/gmb/location/validate/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "GMBapi Coffee Shop",
  "address": "Bakkerstraat 38A",
  "postal": "5612EP",
  "city": "Eindhoven",
  "country_code": "NL",
  "administrative_area": "North Brabant",
  "description": "A cozy neighborhood coffee shop serving artisanal coffee and fresh pastries",
  "phone_number": "+31627511129",
  "additional_phone_numbers": [
    "+31627511130"
  ],
  "website_uri": "https://gmbapi.com",
  "regular_hours": [
    {
      "open_day": "MONDAY",
      "close_day": "MONDAY",
      "open_time": {
        "hours": "09",
        "minutes": "00"
      },
      "close_time": {
        "hours": "17",
        "minutes": "00"
      }
    },
    {
      "open_day": "TUESDAY",
      "close_day": "TUESDAY",
      "open_time": {
        "hours": "09",
        "minutes": "00"
      },
      "close_time": {
        "hours": "00",
        "minutes": "00"
      }
    },
    {
      "open_day": "WEDNESDAY",
      "close_day": "WEDNESDAY",
      "open_time": {
        "hours": "09",
        "minutes": "00"
      },
      "close_time": {
        "hours": "03",
        "minutes": "00"
      }
    },
    {
      "open_day": "THURSDAY",
      "close_day": "THURSDAY",
      "open_time": {
        "hours": "09",
        "minutes": "00"
      },
      "close_time": {
        "hours": "17",
        "minutes": "00"
      }
    },
    {
      "open_day": "FRIDAY",
      "close_day": "FRIDAY",
      "open_time": {
        "hours": "09",
        "minutes": "00"
      },
      "close_time": {
        "hours": "05",
        "minutes": "00"
      }
    }
  ],
  "categories": {
    "primaryCategory": {
      "name": "gcid:coffee_shop",
      "displayName": "Coffee shop"
    },
    "additionalCategories": [
      {
        "name": "gcid:cafe",
        "displayName": "Cafe"
      }
    ]
  }
}
'
{
"success": true,
"validationIssues": []
}

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 validate updates for

service_items_combination
enum<string>

If set to 'true', combines new service items with existing ones. If 'false', replaces all service items.

Available options:
true,
false

Body

application/json

Location fields to validate. Only include fields you want to validate for updates. Phone numbers (primary and additional) must be validated together per Google API requirements.

name
string

The name of the location

address
string

The street address of the location

postal
string

The postal code of the location

city
string

City of the location

country_code
string

The ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'NL')

administrative_area
string

The administrative area, state, or province

description
string

The description of the location (max 750 characters)

phone_number
string

Primary phone number of the location. Must be updated together with additional_phone_numbers per Google API requirements.

additional_phone_numbers
string[]

Array of additional phone numbers (max 2). Must be updated together with phone_number per Google API requirements.

Maximum length: 2
website_uri
string

Website URL of the location

regular_hours
object[]

Regular business hours

special_hours
object[]

Special hours for holidays or events

more_hours
object[]

Additional hours types (e.g., ACCESS, BREAKFAST, DELIVERY, TAKEOUT, DRIVE_THROUGH)

Example:
[
{
"hoursTypeId": "ACCESS",
"periods": [
{
"open_day": "MONDAY",
"close_day": "MONDAY",
"open_time": { "hours": "9", "minutes": null },
"close_time": { "hours": "17", "minutes": null }
},
{
"open_day": "FRIDAY",
"close_day": "FRIDAY",
"open_time": { "hours": "9", "minutes": null },
"close_time": { "hours": "17", "minutes": null }
}
]
},
{
"hoursTypeId": "BREAKFAST",
"periods": [
{
"open_day": "FRIDAY",
"close_day": "FRIDAY",
"open_time": { "hours": "9", "minutes": null },
"close_time": { "hours": "17", "minutes": null }
}
]
}
]
categories
object

Business categories

service_items
object[]

Services offered by the business

service_area
object

Service area for businesses that serve customers at their locations

Response

Validation successful - Returns validation results from Google Business Profile API

success
boolean

Indicates if validation passed

validationIssues
object[]

Array of validation issues if any were found