GET / v3/ usage/ limits
On this page
Show what is left of your limits this month.
Gives requests used, the monthly allowance, and what is left, for your organization. Also gives whether prepaid credit covers requests past the allowance, and how many requests it still pays for. Also gives billable bytes used and the byte allowance, the per-second rate limit and what is left of it now, and when the month resets.
API key: required. See Authentication.
Group: Coverage, usage and service
Try it
This route takes no parameters.
This route needs an API key. Sign in to send it with yours; a free account comes with a key.
Response
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/usage/limits",
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())Parameters
This route takes no parameters.
Response body
A successful answer (200) is a UsageLimits object.
| Field | Type | Always present | Description |
|---|---|---|---|
as_ | date-time (RFC 3339, UTC) | yesalways present | When these figures were read. UTC, ISO 8601. |
bytes | object | yesalways present | This month's billable response bytes, counted before compression. |
bytes. | integer | null | yesalways present | Bytes included each month. In bytes. Null when there is no byte limit. |
bytes. | boolean | yesalways present | True when requests past the byte allowance get 429 quota_exceeded. False means the bytes are counted but never refused. |
bytes. | integer | null | yesalways present | Bytes left of the allowance. In bytes. Null when there is no byte limit or usage is not counted. |
bytes. | integer | null | yesalways present | Billable response bytes this month. In bytes. Null when usage is not counted. |
key | object | yesalways present | The key that made the request. |
key. | string | yesalways present | The first 12 hex digits of the key's SHA-256 hash. |
org_ | integer | null | yesalways present | Your organization's ID. Null when the key belongs to no organization. |
period | object | yesalways present | This month, as SEC Blast counts it: midnight to midnight New York time. |
period. | date-time (RFC 3339, UTC) | yesalways present | When this month ends. UTC, ISO 8601, such as 2026-12-01T05:00:00Z. |
period. | date-time (RFC 3339, UTC) | yesalways present | When the monthly allowances start again; the same time as end. UTC, ISO 8601. |
period. | string | yesalways present | The reset in New York time, in words, such as December 1, 2026 at 00:00 ET. |
period. | date-time (RFC 3339, UTC) | yesalways present | When this month started. UTC, ISO 8601, such as 2026-11-01T04:00:00Z. |
plan | string | null | yesalways present | Your plan ID, such as free, builder, or business. Null when the plan cannot be read. |
rate | object | yesalways present | The per-second rate limit. |
rate. | integer | null | yesalways present | Number of requests allowed at once above the per-second rate. Null when no rate limit applies to you. |
rate. | boolean | yesalways present | True when requests over the rate get 429 rate_limited. |
rate. | integer | null | yesalways present | Number of requests allowed per second. Null when no rate limit applies to you. |
rate. | integer | null | yesalways present | Requests you can send right now, after this one. Null when no rate limit applies to you. |
requests | object | yesalways present | This month's requests. |
requests. | integer | null | yesalways present | Number of requests included each month. Null when there is no request limit. |
requests. | integer | yesalways present | Number of requests past the allowance that your prepaid credit still pays for. 0 when the plan has no overage. |
requests. | boolean | yesalways present | True when requests past the allowance and credit get 429 quota_exceeded. |
requests. | boolean | yesalways present | True when prepaid credit pays for requests past the allowance; false when the allowance is a hard stop. |
requests. | integer | null | yesalways present | Requests left of the allowance. Null when there is no request limit or usage is not counted. |
requests. | integer | null | yesalways present | Number of requests counted this month. 5xx and 429 responses, webhook deliveries, and this route do not count. Null when usage is not counted. |
scope | string | yesalways present | Whose monthly allowance the figures are. One of: org (shared by all keys of your organization) or key (this key's own; an older key that belongs to no organization). |
Details
This route is not billed
- it never counts as a request or toward bytes.
- It is never refused for a used-up allowance.
- The per-second rate limit applies, so over it the answer is 429 rate_limited.
Headers: While the request allowance is enforced, the answer carries X-Quota-Used-Requests, X-Quota-Limit-Requests, X-Quota-Remaining-Requests, X-Credit-Remaining-Requests, and X-Quota-Reset, as every response to a key does. Takes no query parameters.
Responses
| Status | Body | Meaning |
|---|---|---|
200 | UsageLimits (application/json) | OK |
429 | Problem (application/problem+json) | Over the per-second rate limit (code rate_limited, with Retry-After). A used-up monthly allowance never refuses this route. |
Like every route, it can also answer with an error: 401, 503, or another status. See Errors.
More in Coverage, usage and service
Previous: GET /v3/usage
Markdown version: /docs/reference/get-usage-limits.md