LogoLogo
Sign InCertnCertn Help
Certn API
Certn API
  • Certn API
  • Getting Started
    • Request a demo account
      • Get your access token
      • Understand your general resources
      • Create your first application
      • Retrieve the results
  • Guides
    • Manage your settings
    • Manage your integration users
    • Use the API
      • Get and use an Authorization Token
      • Use webhooks
        • Webhook parameters and example
      • Get the applicant's consent
    • Run a check
      • Address Reference Check
      • Australia Right To Work Check
      • Basic Disclosure And Barring Service Check
      • Basic Disclosure Scotland Check
      • Canadian Criminal Record Check
      • Credential Verification
      • Credit Check
      • Education Verification
      • Employment Verification
      • Employment Reference Check
      • Enhanced Identity Verification
      • International Criminal Record Check
      • Motor Vehicle Record Check / Driver's Abstract
      • Softcheck
      • Social Media Check
      • SOQUIJ
      • UK Right To Work Check
      • US Criminal Record Check
    • Understanding statuses and scores
  • API Reference
    • Settings and packages
    • Human Resources
      • Available checks
    • Property Management
      • Available checks
    • Resources
      • Application parameters
        • Request flags
        • Package settings
      • Error codes
      • Regional codes
      • Report field mappings
  • FAQ
  • Changelogs
  • Contact us
Powered by GitBook

The Certn Group of companies includes Certn, Credence & InterCheck. For educational purposes, these companies are referred to as “Certn” in this website. For questions about any of the aforementioned companies, contact support@certn.co. ©2023 Certn.

On this page
  • 400 Bad Request
  • 401 Unauthorized
  • 403 Forbidden
  • 404 Not Found
  • 500 Internal Server Error

Was this helpful?

Export as PDF
  1. API Reference
  2. Resources

Error codes

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

PreviousPackage settingsNextRegional codes

Last updated 1 year ago

Was this helpful?

400 Bad Request

You may receive a 400 Bad Request if:‌

There are issues in the body of your request

  • A required field is missing.

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

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."]

How to fix this issue

Format all your fields according to their .

There's an issue with your account

  • Your account isn't configured to run this check or your account does not have payment configured.

"request_equifax": ["Account not configured to \"request_equifax\".
 Please contact support@certn.co to update your plan."]

How to fix this issue

to have your account configured for this check or to confirm that your payment method is correctly configured.

For a demo account, use this .

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."]

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.

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

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.

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

How to fix this issue

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

How to fix this issue

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

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

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.

"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

How to fix this issue

  • 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

How to fix this issue

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

500 Internal Server Error

You may receive a 500 Internal Server Error if:‌

You sent something we didn't expect

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

<HTML Page> Server Error (500)

How to fix this issue

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

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

Format all your fields according to their . Most fields in our API take strings, while take booleans.

authorization header
data type
payment method
data type
request flags
application ID
Contact our support team