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.
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
The Zernio account ID (from /v1/accounts)
Query Parameters
Override which location to target. If omitted, uses the account's selected location.
The verification method. Selects which method-specific field below is required.
"ADDRESS" | "EMAIL" | "PHONE_CALL" | "SMS" | "AUTO" | "VETTED_PARTNER"For PHONE_CALL / SMS.
For EMAIL.
For ADDRESS (postcard) verification.
ServiceBusinessContext (e.g. service address). Required for service-area businesses.
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"
}
}{
"error": "string",
"details": {}
}{
"error": "string",
"details": {}
}{
"error": "Not found"
}Fetch verification options POST
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 POST
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.