---
title: "Your sending limits and current usage"
method: GET
path: "/v1/send-limit"
tags: ["Accounts"]
---

# Your sending limits and current usage

`GET /v1/send-limit`

## Request

- Base URL: `https://api.honkio.ca`
- URL: `https://api.honkio.ca/v1/send-limit`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

The daily cap (a rolling 24 hours), how much of it is used, the per-recipient cap, the probation status that gates "request a higher volume", any active pause, and your past requests. The top-level cap and usage are for sends from local numbers; toll_free holds the separate allowance for sends from toll-free numbers, which has no probation. number_queues shows each of your numbers' carrier queue: the parts a minute it sends, the parts waiting now, and when they should have gone out (an estimate).

Requires `account:r`.

## Response `200`

Sending limits, usage and past volume requests.

- SendLimit: The account's sending limits, current usage and past volume requests.
  - `daily_limit` integer, required: Live sends from local numbers allowed in a rolling 24 hours.
  - `sent_last_24h` integer, required
  - `remaining` integer, required
  - `window_hours` integer, required
  - `approved_daily_limit` integer, required: The standard volume a request is granted by default.
  - `probation_days` integer, required
  - `recipient_rate_per_hour` integer, required: Messages one recipient may receive from the account in an hour.
  - `recipient_rate_per_day` integer, required: Messages one recipient may receive from the account in a day.
  - `probation` object, required
    - `started_at` string, date-time, nullable, required: The first live send; null before it.
    - `ends_at` string, date-time, nullable, required
    - `eligible_to_request` boolean, required
  - `paused_until` string, date-time, nullable, required: Set while sending is paused.
  - `pause_reason` string, nullable, required: Why sending is paused: OPT_OUT_RATE, FAILURE_RATE or MANUAL.
  - `toll_free` object, required: The separate allowance for sends from toll-free numbers. Sends from local numbers count toward the top-level figures only.
    - `daily_limit` integer, required: Live sends from toll-free numbers allowed in a rolling 24 hours. There is no probation.
    - `sent_last_24h` integer, required: Live sends from toll-free numbers in the last 24 hours.
    - `remaining` integer, required
    - `fanout_max_recipients` integer, required: Distinct recipients one identical body may reach from toll-free numbers in 24 hours.
    - `broadcast_max_recipients` integer, required: Members a contact-group broadcast from a toll-free number may reach.
    - `broadcasts_per_day` integer, required: Contact-group broadcasts from toll-free numbers per rolling 24 hours.
  - `number_queues` object[], required: Each of your active numbers' carrier queue: the carrier sends a number's message parts at a fixed pace, so a list takes time. An estimate, from the parts already handed over.
    - `phone_number` string, required
    - `parts_per_minute` integer, required: Message parts the carrier sends from this number a minute (10 for a local number).
    - `queued_parts` integer, required: Parts waiting now. A single send is refused with NUMBER_RATE_LIMITED while a minute's worth are waiting.
    - `clears_at` string, date-time, nullable, required: When the parts waiting now should all have gone out; null when none are waiting.
  - `requests` SendLimitRequest[], required
    - `id` string, required
    - `requested_limit` integer, nullable, required: Messages per day asked for; null asks for the standard approved volume.
    - `limit_at_request` integer, required
    - `sent_last_30d_at_request` integer, required
    - `reason` string, required
    - `status` 'PENDING' | 'APPROVED' | 'DENIED', required
    - `granted_limit` integer, nullable, required
    - `staff_note` string, nullable, required
    - `decided_at` string, date-time, nullable, required
    - `created_at` string, date-time, required

## Other responses

- `401`: Missing, invalid, revoked or expired API key.
- `402`: The account has no balance, or a LIVE key was used before the first top-up.
- `403`: The API key lacks the permission this operation requires, or the account is suspended or closed.
- `404`: NOT_FOUND: no such resource on this account.
- `429`: Rate limit reached: 100 requests per second per account, or a route-specific limit (Retry-After set where one applies).
- `500`: Unexpected server error.

---

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