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

# Errors

## Overview

The Partoo API uses standard HTTP response codes to indicate success or failure. This guide covers the most common error codes and how to respond to them effectively.

<Info>
  HTTP status codes are grouped into three categories:

  * **2xx**: Success
  * **4xx**: Client Errors
  * **5xx**: Server Errors
</Info>

<AccordionGroup>
  <Accordion title="400 - Bad Request">
    The request is malformed or missing required fields.

    ```json theme={null}
    {
      "error": {
        "json": {}
      }
    }
    ```
  </Accordion>

  <Accordion title="401 - Unauthorized">
    No valid API key was provided.

    ```json theme={null}
    {
      "error": {
        "authentication": "User not authenticated"
      }
    }
    ```
  </Accordion>

  <Accordion title="403 - Forbidden">
    The API key doesn't have permission to perform this request.

    ```json theme={null}
    {
      "error": {
        "authorization": "Operation not allowed"
      }
    }
    ```
  </Accordion>

  <Accordion title="404 - Not Found">
    The resource you're looking for doesn't exist.

    ```json theme={null}
    {
      "error": {
        "json": "Resource not found"
      }
    }
    ```
  </Accordion>

  <Accordion title="415 - Unsupported Media Type">
    Ensure that the `Content-Type` header is set to `application/json` on POST, PUT, and PATCH requests.

    ```json theme={null}
    {
      "errors": {
        "json": "Unsupported media type. Please use application/json"
      }
    }
    ```
  </Accordion>

  <Accordion title="429 - Too Many Requests">
    Your application has hit the rate limit.

    See <Link href="/guides/api/getting-started/api-fundamentals/rate-limits">Rate Limits</Link> for more information.
  </Accordion>
</AccordionGroup>