Zernio
Zernio
API Reference

Google Business Profile

Reviews

Get reviewsGETGet a reviewGETBatch get reviewsPOSTReply to a reviewPOSTDelete a review replyDELETE

Food Menus

Get food menusGETUpdate food menusPUT

Location Details

Get location detailsGETUpdate location detailsPUT

Services

Get servicesGETReplace servicesPUT

Verification

Get verification stateGETFetch verification optionsPOSTStart a verificationPOSTComplete a verificationPOST

Media

List mediaGETUpload photoPOSTDelete photoDELETE

Attributes

Get attributesGETUpdate attributesPUTGet attribute metadataGET

Place Actions

List action linksGETCreate action linkPOSTUpdate action linkPATCHDelete action linkDELETE
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Google Business Profile

Start a verification

Starts a verification for the location. This is a mutating action: depending on method, Google mails a postcard, places a call, or sends an SMS/email to the business. Submit the resulting code with POST /gmb-verifications/{verificationId}/complete. Use POST /gmb-verifications/options first to discover which methods are eligible.

POST
/v1/accounts/{accountId}/gmb-verifications

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

accountId*string

The Zernio account ID (from /v1/accounts)

Query Parameters

locationId?string

Override which location to target. If omitted, uses the account's selected location.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.gmbverifications.startGoogleBusinessVerification({  path: {    accountId: 'account_abc123',  },  body: {    method: 'ADDRESS',  },});console.log(data);
{  "success": true,  "accountId": "string",  "locationId": "string",  "verification": {    "name": "string",    "method": "ADDRESS",    "state": "PENDING",    "createTime": "2019-08-24T14:15:22Z"  }}
Was this page helpful?

Fetch verification options

Reports the verification methods Google currently offers for the location. Non-mutating (nothing is sent to the business). `languageCode` is required; service-area ("CUSTOMER_LOCATION_ONLY") businesses also require `context.address`, otherwise Google returns 400.

Complete a verification

Completes a PENDING verification by submitting the PIN/code Google sent the business (postcard code, SMS PIN, etc.). On success the verification moves to COMPLETED.

method*string

The verification method. Selects which method-specific field below is required.

Value in

  • "ADDRESS"
  • "EMAIL"
  • "PHONE_CALL"
  • "SMS"
  • "AUTO"
  • "VETTED_PARTNER"
languageCode?string
phoneNumber?string

For PHONE_CALL / SMS.

emailAddress?string

For EMAIL.

mailerContact?

For ADDRESS (postcard) verification.

context?

ServiceBusinessContext (e.g. service address). Required for service-area businesses.