User API

REST APIs for Users

User API calls must originate from the end-client

Equifax end-points are accessible by first using the User API /users/efx-config response data, and then the Equifax /oauth/token call.

User API and Equifax API calls are intended to be called from the end-client/user's device.

Endpoints

Preauth Token
User Identity
Phone Verify
Send Mobile Code
Renew Mobile Code
Verify Mobile Code
Get Identity Quiz
Verify Identity Quiz
Get EFX Config
/users/preauth-token
/users/identity
/users/get-mobile
/users/send-code
/users/renew-code
/users/verify-code
/users/get-quiz
/users/verify-quiz
/users/efx-config

Endpoints above are all available to the customer and require a preauth token, returned from /direct/user-reg or /direct/preauth-token


Start
Initialize
Customer Login
Register New User
Password Recovery
Recovery Token Verify
Password Reset
Action Token
Change Email
Change Phone
Change Password
Change Recovery
Close Account
/users/start
/users/initialize
/users/login
/users/register
/users/password-recovery
/users/recovery-token
/users/password-reset
/users/action-token
/users/change-email
/users/change-phone
/users/change-password
/users/change-recovery
/users/close-account

Endpoints above are not available for use when Direct API calls are used.


  1. Preauth Token (get)
  2. /users/preauth-token/{paToken}

    • This request uses userId (from the response of /direct/user-reg) to generate a User Token.

      The Preauth Token needed for this request is also generated by /direct/user-reg or /direct/preauth-token

  3. User Identity (post)
  4. /users/identity

    This endpoint is most useful for checking whether the user's identity needs to be verified.

    If the response has idpass set to true, then the user's identity is already verified.

    If idpass is false, then the user's identity needs to be verified.

    The user's identity can be verified with either:

    • /users/get-mobile (phone sms verification)
    • /users/get-quiz (an identity quiz)

    The user's identity must be verified in order to enable the user's device to request the Equifax config data.

    The data in the Equifax config provides the necessary credentials for making requests to the Equifax API from the consumer's device.

  5. Phone Verify (get)
  6. /users/get-mobile

  7. Send Mobile Code (post)
  8. /users/send-code/{mtoken}

  9. Renew Mobile Code (post)
  10. /users/renew-code

  11. Verify Mobile Code (post)
  12. /users/verify-code

  13. Get Identity Quiz (get)
  14. /users/get-quiz

  15. Verify Identity Quiz (post)
  16. /users/verify-quiz

  17. Get EFX Config (get)
  18. /users/efx-config

    Use this endpoint to get the Equifax credentials and url

    These will be needed for the consumer app to send requests to the Equifax API.

changeNotificationsDeprecated

Security
Request
Request Body schema: application/json
required
smsMsg
boolean
emailMsg
boolean
pushMsg
boolean
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/change-notifications
Request samples
application/json
{
  • "smsMsg": true,
  • "emailMsg": true,
  • "pushMsg": true
}

changePassword

Security
Request
Request Body schema: application/json
required
username
required
string
oldPassword
required
string
newPassword
required
string
Responses
204

No Content

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/change-password
Request samples
application/json
{
  • "username": "string",
  • "oldPassword": "string",
  • "newPassword": "string"
}

changeRecovery

Security
Request
Request Body schema: application/json
required
recoveryQuestion
required
integer <int32> [ 1 .. 10 ]
recoveryAnswer
required
string
oldRecoveryAnswer
required
string
token
required
string
Responses
204

No Content

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/change-recovery
Request samples
application/json
{
  • "recoveryQuestion": 1,
  • "recoveryAnswer": "string",
  • "oldRecoveryAnswer": "string",
  • "token": "string"
}

changeUserEmail

Security
Request
Request Body schema: application/json
required
email
required
string
recoveryAnswer
required
string
token
required
string
Responses
204

No Content

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/change-email
Request samples
application/json
{
  • "email": "string",
  • "recoveryAnswer": "string",
  • "token": "string"
}

closeUserAccount

Security
Request
Request Body schema: application/json
required
recoveryAnswer
required
string
token
required
string
Responses
204

No Content

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/close-account
Request samples
application/json
{
  • "recoveryAnswer": "string",
  • "token": "string"
}

efxLatestReport

Security
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/efx-latest-report
Request samples

efxLatestReportSummary

Security
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/efx-latest-report/summary
Request samples

exchangePreauthToken

Request
path Parameters
token
required
string
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/preauth-token/{token}
Request samples

getActionToken

Security
Request
Request Body schema: application/json
required
username
required
string
password
required
string
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/action-token
Request samples
application/json
{
  • "username": "string",
  • "password": "string"
}

getEfxAlerts

Security
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/efx-alerts
Request samples

getEfxConfig

Security
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/efx-config
Request samples

getEfxLatestEFXScoreDeprecated

Security
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/efx-latest-efx-score
Request samples

getEfxLatestScores

Security
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/efx-latest-scores
Request samples

getEfxScoreHistory

Security
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/efx-score-history
Request samples

getEfxScoresDeprecated

Security
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/efx-scores
Request samples

getIdentityQuiz

Security
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/get-quiz
Request samples

getMobileAuthorization

Security
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/get-mobile
Request samples

getUser

Security
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users
Request samples

initialize

Request
header Parameters
referer
string
ctoken
string
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/initialize
Request samples

initializeWithKey

Request
path Parameters
key
required
string <uuid>
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/initialize/{key}
Request samples

loginUser

Request
header Parameters
referer
string
ctoken
string
Request Body schema: application/json
required
username
required
string
password
required
string
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/login
Request samples
application/json
{
  • "username": "string",
  • "password": "string"
}

recoverPassword

Request
header Parameters
referer
string
ctoken
string
Request Body schema: application/json
required
email
required
string
Responses
204

No Content

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/password-recovery
Request samples
application/json
{
  • "email": "string"
}

recoveryQuestion

Request
Request Body schema: application/json
required
token
required
string
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/recovery-token
Request samples
application/json
{
  • "token": "string"
}

refreshUserToken

Request
query Parameters
token
string
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/refresh-token
Request samples

registerUser

Request
header Parameters
referer
string
ctoken
string
Request Body schema: application/json
required
email
required
string
mobile
string = 10 characters
fname
required
string
lname
required
string
password
required
string [ 8 .. 20 ] characters
recoveryQuestion
required
integer <int32> [ 1 .. 10 ]
recoveryAnswer
required
string
smsMsg
boolean
emailMsg
boolean
pushMsg
boolean
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/register
Request samples
application/json
{
  • "email": "string",
  • "mobile": "stringstri",
  • "fname": "string",
  • "lname": "string",
  • "password": "stringst",
  • "recoveryQuestion": 1,
  • "recoveryAnswer": "string",
  • "smsMsg": true,
  • "emailMsg": true,
  • "pushMsg": true
}

renewMobileCode

Security
Request
Request Body schema: application/json
required
key
required
string
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/renew-code
Request samples
application/json
{
  • "key": "string"
}

resetPassword

Request
Request Body schema: application/json
required
token
required
string
recoveryAnswer
required
string
password
required
string [ 8 .. 20 ] characters
Responses
204

No Content

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/password-reset
Request samples
application/json
{
  • "token": "string",
  • "recoveryAnswer": "string",
  • "password": "stringst"
}

sendMobileCode

Security
Request
path Parameters
token
required
string
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/send-code/{token}
Request samples

setIdentity

Security
Request
Request Body schema: application/json
required
dob
string <date>
mobile
string = 10 characters
ssn
required
string = 9 characters
street1
required
string
street2
string
city
required
string
state
required
string = 2 characters
zip
required
string = 5 characters
country
string
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/identity
Request samples
application/json
{
  • "dob": "2019-08-24",
  • "mobile": "stringstri",
  • "ssn": "stringstr",
  • "street1": "string",
  • "street2": "string",
  • "city": "string",
  • "state": "st",
  • "zip": "strin",
  • "country": "string"
}

startUserSession

Request
query Parameters
key
string
ocf
string
oct
string
ocl
string
view
string
header Parameters
referer
string
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

get/users/start
Request samples

verifyIdentityQuiz

Security
Request
Request Body schema: application/json
required
key
required
string
id
required
integer <int32>
Array of objects (Answer)
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/verify-quiz
Request samples
application/json
{
  • "key": "string",
  • "id": 0,
  • "answers": [
    ]
}

verifyMobileCode

Security
Request
Request Body schema: application/json
required
key
required
string
code
required
string
Responses
200

OK

400

Bad Request

401

Unauthorized

409

Conflict

500

Internal Server Error

503

Service Unavailable

post/users/verify-code
Request samples
application/json
{
  • "key": "string",
  • "code": "string"
}