Initiate Agent Re-Authentication
POST/api/experian/agents/:agentId/auth
Initiates re-authentication for an existing agent.
Returns an authentication challenge (KBA questions or OTP requirement) and
establishes the authSession that the follow-up auth/kba or auth/otp
call requires. Call this before submitting answers.
This endpoint is for re-authentication only, not initial registration.
Only jscPayload and ipAddress are used — this endpoint takes a small,
dedicated body and does not require the agent registration fields (name, SSN,
address, etc.). Both values are forwarded to Experian for device recognition;
omitting them may cause Experian to fail the recognition step (Experian error 103).
Request
Responses
- 200
- 400
- 403
- 404
Authentication challenge generated. The payload is the Experian
authentication response passed through unchanged — it indicates whether
KBA or OTP is required and includes the KBA questions when applicable.
Agent has no consumer token (errorCode 138, errorOnField: consumerToken)
Invalid API key
Agent not found