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

# Error Handling

Our API uses standard HTTP status codes to indicate the success or failure of API requests.

### Client Errors (4XX)

These errors are typically caused by issues in your request and can usually be resolved by modifying the request.

* **400 - Bad Request**: The request was malformed or contains invalid syntax. Check that all required fields are present and that parameter values are correctly formatted.
* **401 - Unauthorized**: Authentication failed. Your access token may be invalid, expired, or missing. Verify your authentication credentials and ensure you're including the Bearer token in the Authorization header.
* **403 - Forbidden**: You don't have permission to access the requested resource or perform this action. This may indicate insufficient privileges for your account.
* **404 - Not Found**: The requested resource could not be found. Verify the endpoint URL and any resource IDs in your request.
* **413 - Payload Too Large**: The request payload exceeds the maximum allowed size. Check the endpoint documentation for size limits, particularly for file uploads.
* **415 - Unsupported Media Type**: The request content type is not supported. Verify that you're using the correct Content-Type header and file format as specified in the endpoint documentation.
* **422 - Unprocessable Entity**: The request is well-formed but contains semantic errors or validation failures. This typically occurs with invalid data formats, out-of-range values, or business rule violations.
* **429 - Too Many Requests**: You've exceeded the API rate limit of 30 requests in 10 seconds per bearer token. Implement exponential backoff and retry after the rate limit window resets.

### Server Errors (5XX)

These errors indicate problems on our server side and are typically temporary.

* **500 - Internal Server Error**: An unexpected error occurred on our servers. Please contact support if you see this.
