Skip to main content

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

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.