# Error codes

### 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."]
}
```

{% hint style="success" %}
**How to fix this issue**

Add all the required fields to the body of your request.
{% endhint %}

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

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

{% hint style="success" %}
**How to fix this issue**

Format all your fields according to their [data type](https://www.w3schools.com/js/js_json_datatypes.asp).
{% endhint %}

#### 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 support@certn.co to update your plan."]
```

{% hint style="success" %}
**How to fix this issue**

[Contact our support team](https://docs.certn.co/api/certn-api-v-1.0/contact#api) to have your account configured for this check.
{% endhint %}

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

{% hint style="success" %}
**How to fix this issue**

Wait for the application's `status` field to show `Returned` before generating the final report.
{% endhint %}

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

{% hint style="success" %}
**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
{% endhint %}

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

{% hint style="success" %}
**How to fix this issue**

Add an [authorization header](https://docs.certn.co/api/certn-api-v-1.0/guides/use-the-api/authorization-header) to your request, and make sure it includes your API Key.‌
{% endhint %}

### 403 Forbidden <a href="#id-401-unauthorized" id="id-401-unauthorized"></a>

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

{% hint style="success" %}
**How to fix this issue**

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

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

{% hint style="success" %}
**How to fix this issue**

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

* 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
```

{% hint style="success" %}
**How to fix this issue**

Add your [application ID](https://docs.certn.co/api/certn-api-v-1.0/getting-started/demo-account/retrieve-results#send-the-request) to the URL and make sure it's in the proper format.
{% endhint %}

* 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
```

{% hint style="success" %}
**How to fix this issue**

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

### 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)
```

{% hint style="success" %}
**How to fix this issue**

Format all your fields according to their [data type](https://www.w3schools.com/js/js_json_datatypes.asp)![](https://content.gitbook.com/content/eZkqafrC0u1Q3f9BlDlZ/blobs/m9xwRSjmAt5YfSWGltnA/externalLink.png). Most fields in our API take strings, while [request flags](https://docs.certn.co/api/certn-api-v-1.0/api-reference/resources/application-parameters/request-flags) take booleans.
{% endhint %}
