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

# Errors

JazzHQ APIs use standard HTTP status codes to indicate whether a request was successful.

Error responses are returned as JSON and include a machine-readable `message` that can be used to identify the error.

## Error response

```
{
  "message": "VALIDATION_FAILED",
  "status": 400,
  "success": false,
  "errors": [
    {
      "field": "companyName",
      "error": "COMPANY_NAME_MANDATORY"
    }
  ],
  "timestamp": "2026-08-01T09:15:00"
}
```

For validation errors, the `errors` array contains details about the fields that caused the request to fail.

## Error codes

| HTTP status | Code                    | Description                                        |
| ----------- | ----------------------- | -------------------------------------------------- |
| `400`       | `VALIDATION_FAILED`     | One or more request fields are invalid or missing. |
| `400`       | `INVALID_REQUEST`       | The request could not be processed.                |
| `400`       | `DUPLICATE_ENTRY`       | The request conflicts with an existing resource.   |
| `403`       | `API_KEY_MISSING`       | The API key was not provided.                      |
| `403`       | `INVALID_API_KEY`       | The provided API key is invalid.                   |
| `404`       | `RESOURCE_NOT_FOUND`    | The requested resource could not be found.         |
| `500`       | `INTERNAL_SERVER_ERROR` | An unexpected error occurred.                      |

## Examples

### Authentication errors

```json title="No X-API-KEY header sent"
{
  "success": false,
  "message": "API_KEY_MISSING",
  "data": null,
  "timestamp": "2026-08-01T09:15:00"
}
```

```json title="Invalid API key"
{
  "success": false,
  "message": "INVALID_API_KEY",
  "data": null,
  "timestamp": "2026-08-01T09:15:00"
}
```

### Validation errors

```json title="Required fields are missing"
{
  "message": "VALIDATION_FAILED",
  "status": 400,
  "success": false,
  "errors": [
    {
      "field": "companyName",
      "error": "COMPANY_NAME_MANDATORY"
    },
    {
      "field": "contactEmailAddress",
      "error": "CONTACT_EMAIL_MANDATORY"
    }
  ],
  "timestamp": "2026-08-01T09:15:00"
}
```

### Resource errors

```json title="Requested resource was not found"
{
  "message": "RESOURCE_NOT_FOUND",
  "status": 404,
  "success": false,
  "errors": [
    {
      "field": "resource",
      "error": "The requested resource was not found."
    }
  ],
  "timestamp": "2026-08-01T09:15:00"
}
```

For validation errors, check the `errors` array for field-level details.