The Business Profile Performance API is now launched! Migration work is required.
Review the deprecation schedule and instructions to migrate over to new v1 APIs from older deprecated v4 API.
Help us improve the food menu experience by filling in this survey to better understand what place, menu, and dish attributes you can provide about the merchants you support

Manage verification

Stay organized with collections Save and categorize content based on your preferences.

Providers who offer listing management directly on their platform can verify a merchant's business within their site. This eliminates the need to redirect the merchant into the Business Profile UI.

Get current state

Users can call locations.getVoiceOfMerchantState on a location to retrieve its current status. If the hasVoiceOfMerchant boolean is true, then the location is already in good standing and no additional action is required. Otherwise, if the gain_voice_of_merchant action in the response contains verify, you must complete verification. Follow the instructions below for more information.

Fetch verification options

Providers can use the locations.fetchVerificationOptions method to prompt merchants to choose a preferred contact method from a list of available verification methods.

To fetch the verification options, use the following:

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

Initiate the verification process

After you choose a verification method, initiate the verification process with locations.verify. As a result of this call, the location moves to a verified state or an error status is returned.

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
:verify

// Use only one of the below verification methods

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "addressInput": {
    "mailerContactName": "Ann Droyd"
  }
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailInput": {
    "emailAddress": "ex@google.com"
  }
}

Retrieve current verifications

The locations.verifications.list call retrieves the history of verification requests along with their status for the location specified in the call.

To retrieve all verification requests, use the following:

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

Complete a pending verification

A PIN code and the locations.verifications.complete method is usually required to complete the verification of a business.

To complete a pending verification, use the following:

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}