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_artifactsfeature must be enabled for your tenant (contact CorpX — it requires a contractual clause), otherwise403 feature_disabled; - the API credential must carry the
kyc.readscope. The genericreadscope 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
accreditationId
Accreditation identifier (acr_*).
Headers
X-Tenant-Id
Tenant context used for authorization and routing.
Response
Archived artifacts, newest first.
accreditationId
count
items
Errors
403
Forbidden Error
404
Not Found Error
500
Internal Server Error