> For the complete documentation index, see [llms.txt](https://eshop.gitbook.io/eshopbox-developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eshop.gitbook.io/eshopbox-developers/basics/errors.md).

# Errors

Eshopbox uses standard HTTP status codes to indicate the success or failure of an API request. 

Code in the range of 

`2xx` indicates success,

`4xx` indicates there was a problem with the request provided (e.g., a required field was missing)

`5xx` indicates an error occurred with Eshopbox API.

## Example Errors

Here are some example error responses from the Eshopbox API.

### Forbidden

You'll receive a `401: Unauthorized` response when you provide an invalid access token

```
{
    "error": {
        "errors": [
            {
                "domain": "global",
                "reason": "conditionNotMet",
                "message": "401:Authentication failed: com.google.api.auth.UnauthenticatedException: No auth token is contained in the HTTP request"
            }
        ],
        "code": 412,
        "message": "401:Authentication failed: com.google.api.auth.UnauthenticatedException: No auth token is contained in the HTTP request"
    }
}
```

### Bad Request

You'll get a `400: Bad Request` when you fail validation.

```javascript
{
    "error": {
        "errors": [
            {
                "domain": "global",
                "reason": "badRequest",
                "message": "null value for parameter 'type' not allowed"
            }
        ],
        "code": 400,
        "message": "null value for parameter 'type' not allowed"
    }
}
```

### Not Found

When a resource is not found you will get a `404: Not Found` response

```javascript
Not Found
```

### Internal Server Error

You'll receive a `503: Internal Server Error` response when something goes wrong on our side. We're automatically notified of these errors, and work to resolve them as quickly as possible.

```javascript
{
    "error": {
        "errors": [
            {
                "domain": "global",
                "reason": "backendError",
                "message": "backend error"
            }
        ],
        "code": 503,
        "message": "backend error"
    }
}
```

**Unauthorized Error**

You'll receive a `401Unauthorized Error` response code when access Token has been expired. To resolve this error you have to regenerate the access token.

```javascript
{
    "message": "Expired token"
}
```

**Unprocessable Entity**

You'll receive a `422 unprocessbale` entity error response code, when something missing or any validation fails in the request. To resolve this error please re-check the request and do the changes as per the error message. 

```javascript
{
  "customerOrderNumber": [
    "The customerOrderNumber has already been taken."
  ],
  "items.0.itemID": [
    "The items.0.itemID field is required."
  ],
  "items.1.itemID": [
    "The items.1.itemID field is required."
  ]
}
```