Skip to navigation

List the KYC evidence files of an accreditation

Returns the KYC artifacts archived for the accreditation — the company documents you uploaded, the signed evidence set produced by the identity provider (unico_evidence_set, a JWT) and the holder selfie (unico_selfie). Each item already carries a pre-signed downloadUrl valid for about 10 minutes, so there is no second round trip.

downloadUrl is omitted while scanStatus is not APPROVED: uploads go through type checking, antivirus and sanitisation before being archived.

Two independent switches gate this endpoint, because it returns the holder’s biometrics:

  • the kyc_artifacts feature must be enabled for your tenant (contact CorpX — it requires a contractual clause), otherwise 403 feature_disabled;
  • the API credential must carry the kyc.read scope. The generic read scope is deliberately not accepted, so no existing credential starts downloading faces without an explicit decision.

BaaS integrators only.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accreditationIdstringRequired

Accreditation identifier (acr_*).

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.

Response

Archived artifacts, newest first.
accreditationIdstringOptional
countintegerOptional
itemslist of objectsOptional

Errors

403
Forbidden Error
404
Not Found Error
500
Internal Server Error