Skip to main content
POST
Renew Business Verification
Requires an account-owned live API key with an associated user. The business must belong to that account and be non-archived and unlocked. The customer must confirm the current identity before a renewal can be queued.
Only these two fields are accepted. expectedIdentityRevision is the current positive integer revision; confirmed must be the JSON boolean true. Renewal is available for matching successful provider verification whose recorded decision is at least 365 days old. A status label or edited expiry timestamp alone does not establish renewal eligibility. Other unproven or historical manual businesses need the appropriate review path.

Response and retry

Returns 202 with {"businessProfile": {...}}. Queue acceptance does not mean verification has completed. Poll Get Business Profile, read submission history, or follow the existing status webhooks. A request already pending returns 202 without another submission. Concurrent renewal attempts share the guarded verification lifecycle and cannot independently pay for the same renewal. Account holds, attempt limits, and daily verification caps remain enforced.

Errors

After renewal, inspect each number request’s businessVerification summary and reconfirm its binding when required.