---
title: "Ask Google to verify the brand behind this agent"
method: POST
path: "/v1/agents/{id}/request-verification"
tags: ["Google & carriers"]
---

# Ask Google to verify the brand behind this agent

`POST /v1/agents/{id}/request-verification`

## Request

- Base URL: `https://api.cadencercs.com`
- URL: `https://api.cadencercs.com/v1/agents/{id}/request-verification`
- Auth: HTTP bearer

Refuses if the profile is still incomplete at Google, because this is the last moment any of it can be changed. Google also requires all five verification-contact fields, and the brand contact must be a **named individual** — they email it a mandatory authorisation request and a shared alias is a rejection.

## Path parameters

- `id` string, required

## Request body

- object
  - `confirm` 'irreversible'

## Response `200`

Submitted.

- object
  - `ok` boolean, required
  - `status` 'submitted', required
  - `frozen` string[], required: The profile fields now permanently locked.
  - `note` string
  - `nextStep` string

## Other responses

- `401`: Not signed in, and no account-linked API key was sent.
- `404`: No such agent on this account.
- `409`: Not confirmed (`CONFIRMATION_REQUIRED`), brand not ready (`NOT_READY`), verification contact incomplete (`VERIFICATION_CONTACT_INCOMPLETE`), profile still empty at Google (`PROFILE_NOT_FINAL`), or the agent isn't at Google yet (`AGENT_NOT_MAPPED`). Nothing happened.
- `500`: Unexpected server error. The body is always JSON.
- `502`: Google rejected the request.
- `503`: RBM not configured.

---

[API](https://skmtc.dev/cadencercs/apis/cadence-api.md) · [All operations](https://skmtc.dev/cadencercs/apis/cadence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cadencercs/apis/cadence-api/revisions/9438443c2081?raw)