---
title: "Fetch verification options"
method: POST
path: "/v1/accounts/{accountId}/gmb-verifications/options"
tags: ["GMB Verifications"]
---

# Fetch verification options

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

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/accounts/{accountId}/gmb-verifications/options`
- Auth: HTTP bearer

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.

## Path parameters

- `accountId` string, required

## Query parameters

- `locationId` string

## Request body

- object
  - `languageCode` string, required
  - `context` object: ServiceBusinessContext. Required for service-area businesses (must include the service address).

## Response `200`

Verification options fetched

- object
  - `success` boolean
  - `accountId` string
  - `locationId` string
  - `options` object[]
    - `verificationMethod` 'ADDRESS' | 'EMAIL' | 'PHONE_CALL' | 'SMS' | 'AUTO' | 'VETTED_PARTNER'
    - `phoneNumber` string: Present for PHONE_CALL / SMS.

## Other responses

- `400`: Invalid request (e.g. missing service business context, or missing languageCode)
- `401`: Unauthorized or token invalid
- `404`: Resource not found

## Changes

- **2026-10-06** `f8c8f34fb41a`: 2 warning
  - added the new `account` enum value to the `details/budgetScope` response property for the response status `400`
  - added the new `account` enum value to the `details/budgetScope` response property for the response status `401`
- **2026-10-02** `d556591af3f6`: 2 info
  - added the optional property `docUrl` to the response with the `400` status
  - added the optional property `docUrl` to the response with the `401` status
- **2026-09-30** `16a7b9d5373e`: 2 info
  - removed the `platform` enum value from the `details/budgetScope` response property for the response status `400`
  - removed the `platform` enum value from the `details/budgetScope` response property for the response status `401`
- **2026-09-25** `2c04683ce694`: 8 info
  - added the optional property `details/adAccountId` to the response with the `400` status
  - added the optional property `details/adAccountId` to the response with the `401` status
  - added the optional property `details/createdObjects` to the response with the `400` status
  - added the optional property `details/createdObjects` to the response with the `401` status
  - …4 more
- **2026-09-16** `3e6ddf2a99ea`: 2 info
  - added the optional property `details/budgetScope` to the response with the `400` status
  - added the optional property `details/budgetScope` to the response with the `401` status

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/accounts/:accountId/gmb-verifications/options/post.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/4e74db179e73?raw)
