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

# Get SMS Usage

> Per-number SMS send volume, delivery outcomes, and credits spent

# Get SMS Usage

Returns send volume and outcomes broken down **per phone number**, the same
breakdown shown on each number's detail page in `Settings -> SMS`. Use it to
see what a specific number actually costs and how healthy its delivery is on
its own, without pulling raw send records.

Test sends are counted separately in `testSends` and excluded from
`totalSends`, `delivered`, `failed`, and `creditsCharged`.

## Request

No request body. Pass `X-Company-Id` if your API key has access to multiple
companies.

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/sms/usage" \
  -H "Authorization: Bearer seq_live_xxx"
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "usage": [
      {
        "fromNumber": "+18885550123",
        "totalSends": 1204,
        "delivered": 1180,
        "failed": 8,
        "creditsCharged": 1204,
        "lastSentAt": "2026-08-28T14:32:00.000Z",
        "testSends": 6
      }
    ]
  }
  ```

  ```json 401 theme={null}
  {
    "error": "Invalid API key"
  }
  ```

  ```json 500 theme={null}
  {
    "error": "Failed to load SMS usage"
  }
  ```
</ResponseExample>