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 drawn from the evidence recorded against it.

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
vendorstringrequired
screeningobjectrequired
+ show properties
sanctions"clear" | "hit" | "pending"required
pep"clear" | "hit" | "pending"required
completed_atstring | nullrequired
created_atstringrequired
expires_atstring | nullrequired
reason_codesarray of string
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