List KYC document requirements for an agent
GET/agents/:id/kyc/requirements
Returns the list of KYC documents required for the agent (driven by ZFA operational policies with built-in defaults per agent type), together with which mandatory items are still missing and the current KYC status. Requires the agent-kyc:requirements:read permission.
Request
Responses
- 200
- 401
- 403
- 404
- 429
- 500
KYC requirements and progress for the agent.
Missing or invalid access token.
Caller lacks the required permission or object-level access to the agent.
Agent not found.
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
Seconds to wait before retrying.
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.