Skip to content
rigid.fi

Retrieve a KYC check

GET/v1/kyc/checks/{id}

Requires an API client bearer token.

Fetch a KYC check by id (tenant-scoped; the underlying identity is never surfaced). Includes reason_codes from the check's latest decision, and awaiting — the applicant-facing step(s) still outstanding — when non-empty.

Parameters

Path parameters

NameRequiredDescription
idrequired

Example

curl https://api.rigid.fi/v1/kyc/checks/{id} \
  -H "Authorization: Bearer $RIGID_API_TOKEN"

Responses

200

The KYC check.

idstringrequired
cardholder_idstringrequired
state"pending" | "in_review" | "passed" | "failed" | "expired"required
completed_atstring | nullrequired
created_atstringrequired
expires_atstring | nullrequired
reason_codesarray of string
awaitingarray of string
document_type"passport" | "national_id" | "residence_permit" | "driving_licence"
flow_keystringrequired
400

Validation error

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
401

Authentication required

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
403

Forbidden

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
404

KYC check not found

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
500

Internal server error

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring