Add Agent
POST/api/experian/agents/:agentId
Registers a new individual agent and initiates the authentication process.
Agents are leasing professionals who need to view renter Experian reports for lease-worthiness evaluation.
Request
Responses
- 200
- 400
- 403
- 409
- 423
- 503
Agent registered (or registration step-up required). The payload is the
Experian passive-user response passed through unchanged — depending on the
outcome it contains the authentication challenge (KBA questions or OTP
requirement) plus session identifiers, or the completed registration result.
If the agent is already registered and authenticated, the current
registration state is returned.
Invalid request data
Invalid API key
Agent already registered (errorCode 292)
Agent blocked by Experian after repeated failed attempts (errorCode 300)
Experian token service unavailable (errorCode 123)