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

# Responses

> Learn how all of our API responses are structured.

All of our API responses are structured in the same way, providing consistency across endpoints. The following fields are included:

<ResponseField name="code" type="number">
  An HTTP status code indicating the result of the request.
</ResponseField>

<ResponseField name="message" type="string">
  A brief, human-readable message indicating the result of the request.
</ResponseField>

<ResponseField name="data" type="object?">
  The requested information. This field is not always provided depending on the endpoint and request.
</ResponseField>

```json Example Response theme={null}
{
  "code": 200,
  "message": "Bot statistics were fetched successfully.",
  "data": {
    "guilds": 10597,
    "users": 796787,
    "links": 38577
  }
}
```

Some more error responses can be found below as a reference.

<Tabs>
  <Tab title="400">
    ```json 400 Bad Request theme={null}
    {
      "code": 400,
      "message": "An invalid ID was provided."
    }
    ```
  </Tab>

  <Tab title="401">
    ```json 401 Unauthorized theme={null}
    {
      "code": 401,
      "message": "Header 'Token' was not provided."
    }
    ```
  </Tab>

  <Tab title="403">
    ```json 403 Forbidden theme={null}
    {
      "code": 403,
      "message": "You are blacklisted from Ducky."
    }
    ```
  </Tab>

  <Tab title="405">
    ```json 405 Method Not Allowed theme={null}
    {
      "code": 405,
      "message": "Method POST is not supported on endpoint /statistics."
    }
    ```
  </Tab>

  <Tab title="429">
    ```json 429 Too Many Requests theme={null}
    {
      "code": 429,
      "message": "Too many requests, please try again later."
    }
    ```

    <Note>
      For more information regarding ratelimiting, please refer to the [Ratelimits](/information/ratelimits) page.
    </Note>
  </Tab>

  <Tab title="500">
    ```json 500 Internal Server Error theme={null}
    {
      "code": 500,
      "message": "An internal error occurred while processing this request. Please try again later."
    }
    ```
  </Tab>
</Tabs>