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

# Get Inbox Stats

> Retrieve inbox statistics with counts by category.

## Response

<ResponseField name="data" type="object">
  <Expandable title="Stats object">
    <ResponseField name="total" type="integer">Total number of replies.</ResponseField>
    <ResponseField name="unread" type="integer">Number of unread replies.</ResponseField>
    <ResponseField name="interested" type="integer">Replies categorized as interested.</ResponseField>
    <ResponseField name="notInterested" type="integer">Replies categorized as not interested.</ResponseField>
    <ResponseField name="outOfOffice" type="integer">Out-of-office replies.</ResponseField>
    <ResponseField name="uncategorized" type="integer">Replies not yet categorized.</ResponseField>
    <ResponseField name="unknown" type="integer">Replies from unknown senders.</ResponseField>
    <ResponseField name="totalSent" type="integer">Total replies sent from inbox.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.foxreach.io/api/v1/inbox/stats" \
    -H "X-API-Key: otr_your_key"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.foxreach.io/api/v1/inbox/stats",
      headers={"X-API-Key": "otr_your_key"}
  )
  data = response.json()
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch(
      "https://api.foxreach.io/api/v1/inbox/stats",
      {
          method: "GET",
          headers: { "X-API-Key": "otr_your_key" }
      }
  );
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "data": {
      "total": 142,
      "unread": 23,
      "interested": 45,
      "notInterested": 38,
      "outOfOffice": 12,
      "uncategorized": 8,
      "unknown": 16,
      "totalSent": 67
    }
  }
  ```
</ResponseExample>

## Rate Limit

* **100 requests per minute, per API key.** Fixed 60-second window.
* Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` (unix epoch seconds).
* A `429` response includes a `Retry-After` header (seconds until the bucket resets).

For client-side patterns (`Retry-After`, exponential backoff, monitoring `X-RateLimit-Remaining`), see [Rate Limiting](/rate-limiting).