> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperline.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Error handling

> Handle Hyperline API errors safely: HTTP status codes, error response payloads, validation failures, retry guidance, and common troubleshooting.

The Hyperline API uses conventional HTTP response codes to indicate the success or failure of an API request. This page details how to handle errors effectively and what to expect in error responses.

## HTTP status codes

The API uses standard HTTP status codes to indicate the success or failure of requests:

* **2xx Success**: The request was successful
* **4xx Client error**: The request was invalid or cannot be processed
* **5xx Server error**: An internal server error occurred

## Error response format

When an error occurs, the API returns a JSON response with a `message` property containing a human-readable description of the error:

```json theme={null}
{
  "message": "The requested resource was not found"
}
```

## Common error codes

### 400 Bad request

The request was malformed or contains invalid parameters.

```json theme={null}
{
  "message": "Cannot assign a subscription to a customer without a currency set"
}
```

Common validation errors include:

* Missing required fields
* Invalid parameter values

### 401 Unauthorized

The request lacks valid authentication credentials.

```json theme={null}
{
  "message": "Missing authentication token"
}
```

### 404 Not found

The requested resource was not found.

```json theme={null}
{
  "message": "Product not found"
}
```

### 429 Too many requests

You exceeded the request rate limit. See [Rate limiting](./rate-limiting) for more details.

## Getting help

If you encounter an error that you cannot resolve:

1. Check the error message for guidance
2. Verify your request format and parameters
3. Ensure your authentication credentials are valid
4. Contact the Hyperline team via the in-app chat with the error details and request information


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.