> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# get_kyc_status

> Check whether the user has passed identity verification.

Checks the user's identity verification (KYC) status. Use it to poll after the user opens the verification URL from [start\_kyc](/companies/mcp/tools/start_kyc) or [create\_card](/companies/mcp/tools/create_card).

## Parameters

This tool takes no parameters.

## Returns

A `verified` boolean plus the raw `status`: `verified`, `pending`, `requires_input`, `duplicate_identity`, `canceled`, or `null` if verification was never started. When the status is `requires_input`, a `reason` explains the failure (for example `id_document_quality_poor`) and the message suggests calling [start\_kyc](/companies/mcp/tools/start_kyc) for a fresh URL. A `duplicate_identity` status means the identity is already associated with another account and the user should contact support.

## Example

```json theme={null}
{ "name": "get_kyc_status", "arguments": {} }
```