Skip to content
rigid.fi

Attest a cardholder

POST/v1/cardholders/{id}/attestation

Requires an API client bearer token.

Records admin attestation of a cardholder's identity — a human-only override of the KYC gate. Requires a console admin session; API clients and other machine callers are rejected. The attestation is recorded in the audit trail.

Parameters

Path parameters

NameRequiredDescription
idrequired

Request body

programme_idstring (uuid)required

Example

curl -X POST https://api.rigid.fi/v1/cardholders/{id}/attestation \
  -H "Authorization: Bearer $RIGID_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "programme_id": "uuid"
}'

Responses

200

The attested cardholder.

idstring (uuid)required
programme_idstring (uuid)required
full_namestringrequired
emailstringrequired
phonestring | nullrequired
countrystringrequired
kyc_state"unverified" | "pending" | "passed" | "failed" | "in_review"required
attestedbooleanrequired
attested_bystring | nullrequired
attested_atstring | nullrequired
kyc_completebooleanrequired
funding_account_idstring | nullrequired
funding_currencystring | nullrequired
created_atstringrequired
400

Validation error

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
401

Authentication required

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
403

Forbidden

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
404

Cardholder not found

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
500

Internal server error

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring