Skip to main content
POST
Dispute Suggested Business Name
Requires an account-owned live API key with an associated user. The business must belong to that account, be non-archived and unlocked, and have verificationStatus: "name_confirm_required".
expectedIdentityRevision must equal the value from the latest business response. reason is an optional string or null; whitespace-only text is treated as absent. Returns 200 with {"businessProfile": {...}} and verificationStatus: "admin_review". The transition is audited and uses the existing business-profile status webhook. It does not mark the business verified or submit a number request. A missing or stale revision returns 409 business_identity_changed. A business no longer awaiting name confirmation returns 409 invalid_state, including a repeated completed dispute. Fetch the current business to reconcile a lost response. Sandbox keys or keys without a user return 403; another account’s business returns 404. To accept the suggested name, use PATCH Business Profile with companyLegalName and expectedIdentityRevision instead.