Record a KYC decision; only the compliance service's result or staff may set verified

POST/customers/{id}/kyc-decisions

Path parameters

idstringRequired

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

business_parties_versionintegerOptional

provider_refstringRequired

reasonstringOptional

risk_ratingstringOptional

statusstringRequired

Returns

200 OK

The Customer 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/customers/{id}/kyc-decisions' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "provider_ref": "string",
    "status": "string"
  }'

Response200

{
  "address": {
    "city": "string",
    "country": "string",
    "line1": "string",
    "line2": "string",
    "postal_code": "string",
    "state": "string"
  },
  "backup_withholding": false,
  "backup_withholding_reason": "string",
  "created_at": "2026-09-17T14:30:00Z",
  "date_of_birth": "string",
  "death": {
    "date_of_death": "string",
    "report_id": "strp_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "revision": 0
  },
  "email": "string",
  "id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "kyc_decided_at": "2026-09-17T14:30:00Z",
  "kyc_status": "string",
  "legal_name": "string",
  "phone": "string",
  "risk_rating": "string",
  "status": "string",
  "tax_form": "string",
  "tax_form_expires_at": "2026-09-17T14:30:00Z",
  "tax_form_received_at": "2026-09-17T14:30:00Z",
  "tax_id_last4": "string",
  "tax_id_on_file": false,
  "tax_status_recorded_at": "2026-09-17T14:30:00Z",
  "tin_certified": false,
  "treaty_country": "string",
  "type": "string",
  "updated_at": "2026-09-17T14:30:00Z"
}