> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.a1.uk.astutepayroll.in/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.a1.uk.astutepayroll.in/_mcp/server.

# Errors

> Error codes and responses returned by the Deel. PayAndBill API

The Deel. PayAndBill API uses standard HTTP status codes to indicate the success or failure of a request.

## Status Codes

| Status Code | Meaning               | Description                                                                       |
| ----------- | --------------------- | --------------------------------------------------------------------------------- |
| `200`       | OK                    | The request succeeded.                                                            |
| `201`       | Created               | A new resource was created successfully.                                          |
| `400`       | Bad Request           | The request was invalid. Check required fields and validation rules.              |
| `401`       | Unauthorized          | Authentication failed. The token is missing, invalid, or expired.                 |
| `404`       | Not Found             | The requested resource does not exist. Verify the ID or UUID.                     |
| `429`       | Too Many Requests     | Rate limit exceeded. See [Rate Limits](/getting-started/rate-limits) for details. |
| `500`       | Internal Server Error | An unexpected error occurred on the server.                                       |

## Error Details

### 400 Bad Request

Returned when creating or updating a record and not all required values are present, or when any other validation fails.

```json
{
  "error": "Bad Request",
  "message": "Validation failed: entityName is required"
}
```

### 401 Unauthorized

Returned when the request does not include a valid Bearer token or the token has expired.

> **Info**
>
> If you receive a `401` response, re-authenticate using the [OAuth Token](/api-reference/authentication/o-auth-token) endpoint or refresh your token.

### 404 Not Found

Returned when the requested resource could not be found (e.g. incorrect UUID).

The response body is typically empty.

### 429 Too Many Requests

Returned when the rate limit has been exceeded. Check the `X-RateLimit-Reset` header for when you can resume making requests.