List KYC documents submitted by an agent

GET 
/agents/:id/kyc/documents

Returns every KYC document currently attached to the agent, including status (pending/verified/rejected), reference numbers and expiry dates. Requires the agent-kyc:read permission (staff) or agent-kyc:read:own (agents viewing their own file).

Request

Responses

200

Array of AgentKycDocument records.

401

Missing or invalid access token.

403

Caller lacks read access to this agent.

404

Agent not found.

429

Rate limit exceeded. Global default is 120 requests/minute per IP; auth-flow, OTP, self-registration, WebAuthn, IRA lookup, and public-lead endpoints carry tighter per-endpoint limits. Retry after the delay indicated by the Retry-After header.

Response Headers

Retry-After

Seconds to wait before retrying.

500

Unhandled server error. The response carries a meta.requestId correlator you can hand to platform operations to trace the failure through structured logs and the hash-chained audit trail. Retry with the same Idempotency-Key header if the endpoint accepts idempotency.