search
Sign InCertnCertn Help

Error codes

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

hashtag
400 Bad Request

You may receive a 400 Bad Request when:‌

hashtag
There are issues in the body of your request

  • You are missing required fields.

"information": {
     "addresses": ["This field is required."]
}
circle-check

How to fix this issue

Add all the required fields to the body of your request.

  • You used the wrong format or data type for a field.

"city": ["Not a valid string."]
circle-check

How to fix this issue

Format all your fields according to their data typearrow-up-right.

hashtag
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."]
circle-check

How to fix this issue

Contact our support team to have your account configured for this check.

hashtag
Something is preventing your request from completing

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

circle-check

How to fix this issue

Wait for the application's status field to show Returned before generating the final report.

  • You requested a check with a min and a max but set your min value to a number greater than your max value.

circle-check

How to fix this issue

Edit the request's check settings to make sure that any min values are less than or equal to the corresponding max values

hashtag
401 Unauthorized

You may receive a 401 Unauthorized if:‌

hashtag
Your authorization header is missing or incorrect

  • You sent your request without an authorization header.

  • 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.

circle-check

How to fix this issue

Add an authorization header to your request, and make sure it includes your API Key.‌

hashtag
403 Forbidden

You may receive a 403 Forbidden if:

hashtag
You don't have permission to make this request

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

circle-check

How to fix this issue

Use the URL that corresponds to your industry, and make sure you're authorized to access this endpoint.

hashtag
404 Not found

You may receive a 404 Not found if:‌

hashtag
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.

circle-check

How to fix this issue

Make sure the page number you entered is a valid integer and within the bounds of your expected results.

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

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

circle-check

How to fix this issue

Add your application ID to the URL and make sure it's in the proper format.

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

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

circle-check

How to fix this issue

Add your team ID to the URL and make sure it's in the proper format.

hashtag
500 Internal Server Error

You may receive a 500 Internal Server Error when:‌

hashtag
You sent something we didn't expect

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

circle-check

How to fix this issue

Format all your fields according to their data typearrow-up-right. Most fields in our API take strings, while request flags take booleans.

PreviousRequest flagsNextRegional codes

Last updated