Create a KYC check

POST/kyc-checks

Verify a customer through the provider and record the decision

Headers

Idempotency-KeystringOptional

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

Returns

201 Created

The KYC Check object.

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503

Request

curl -X POST 'https://api.dev.bank.corgi.com/kyc-checks' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm"
  }'

Response201

{
  "business_parties_version": 0,
  "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "decision": "string",
  "evidence": {
    "entity_tokens": [
      "string"
    ],
    "evaluation_tokens": [
      "string"
    ],
    "journey_application_token": "string",
    "journey_token": "string",
    "outcome": "string",
    "provider": "string",
    "reason_codes": [
      "string"
    ],
    "recorded_at": "2026-09-17T14:30:00Z",
    "response_digest": "string",
    "status": "string"
  },
  "id": "kycc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "provider": "string",
  "provider_ref": "string",
  "reasons": [
    "string"
  ],
  "risk_rating": "string"
}