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

# KYC verification

> Run individual and business KYC through Verify Group, check verification status, sync results to participants, and trigger organization-wide KYC.

## Run KYC

```bash theme={null}
POST /api/v1/kyc
```

```json theme={null}
{
  "participant_id": "uuid",
  "type": "individual",
  "scenario": "identity",
  "payload": {
    "identifier_type": "national_id",
    "identifier_number": "12345678",
    "country": "KE"
  }
}
```

## Check status

```bash theme={null}
GET /api/v1/kyc/{id}
```

| Status          | Meaning            |
| --------------- | ------------------ |
| `pending`       | Queued             |
| `processing`    | In progress        |
| `verified`      | Identity confirmed |
| `failed`        | Could not verify   |
| `manual_review` | Needs human review |

## Sync result to participant

```bash theme={null}
POST /api/v1/kyc/{id}/sync
```

Updates the participant with verified name, date of birth, address, and extracted face photo.

## Organization KYC

```bash theme={null}
POST /api/v1/organizations/{id}/run-kyc
```

```json theme={null}
{"autoSync": true}
```

Creates participant records for all identified directors automatically.