Error codes

A list of API error codes and how to fix them.

400 Bad Request

You may receive a 400 Bad Request when:‌

There are issues in the body of your request

  • You are missing required fields.

"information": {
     "addresses": ["This field is required."]
}
  • You used the wrong format or data type for a field.

"city": ["Not a valid string."]

There's an issue with your account

  • Your account isn't configured to run this check.

"request_equifax": ["Account not configured to \"request_equifax\".
 Please contact [email protected] to update your plan."]

Something is preventing your request from completing

  • You tried to generate a report, but the application is still processing.

"non_field_errors": ["Cannot generate report for incomplete hr applicant."]
or
"non_field_errors": ["Cannot generate report for incomplete applicant."]
  • You requested a check with a min and a max but set your min value to a number greater than your max value.

"non_field_errors": [
    "employer_references_max must be greater than employer_references_min."
]

401 Unauthorized

You may receive a 401 Unauthorized if:‌

Your authorization header is missing or incorrect

  • You sent your request without an authorization header.

"detail": "Authentication credentials were not provided."
  • You sent your request with an authorization header, but without an API Key.

  • You provided an incorrect API key in the header of your request.

"detail": "Invalid token."

403 Forbidden

You may receive a 403 Forbidden if:

You don't have permission to make this request

  • You sent your request to an endpoint you don't have access to.

"detail": "You do not have permission to perform this action."

404 Not found

You may receive a 404 Not found if:‌

The resource you called doesn't exist

  • You sent a request to retrieve all your applications, but the page number you provided doesn't exist.

"detail": "Invalid page."
  • You sent a request to retrieve an application or a report, but the application ID you provided couldn't be found.

"detail": "Not found."
  • You sent a request to retrieve an application or a report, but the application ID you provided is a string of letters.

<HTML Page> NOT FOUND
  • You sent a request to retrieve questionnaire reference templates for a team, but the team ID you provided couldn't be found.

"detail": "Not found."
  • You sent a request to retrieve questionnaire reference templates for a team, but the team ID you provided is a string of letters.

<HTML Page> NOT FOUND

500 Internal Server Error

You may receive a 500 Internal Server Error when:‌

You sent something we didn't expect

  • Some fields in your request are using the wrong data type.

<HTML Page> Server Error (500)

Last updated