---
title: "Get SMS usage"
method: GET
path: "/sms/usage"
tags: ["SMS"]
---

# Get SMS usage

`GET /sms/usage`

Per-number outbound SMS usage for the selected company. Requires account:read. Test sends count only toward testSends, not totalSends, delivered, failed or creditsCharged. lastSentAt may include a test send. Rows are ordered by totalSends descending.

## Response `200`

Per-number usage returned

- object
  - `success` boolean, required
  - `usage` object[], required
    - `fromNumber` string, required — Sending phone number.
    - `totalSends` integer, required
    - `delivered` integer, required
    - `failed` integer, required
    - `creditsCharged` number, required
    - `lastSentAt` string, date-time, nullable, required
    - `testSends` integer, required

## Other responses

- `401` — Missing or invalid API key
- `403` — Missing account:read or company access
- `500` — Failed to load SMS usage

## Changes

- **2026-09-08** `f1d8cfd9faaf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/sms/usage/get.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sequenzy/apis/sequenzy-api/revisions/e93563b0d37e?raw)