Zum Inhalt springen
Esc
↑↓navigieren↵öffnen⌘Jvorschau

Get usage

Your plan, its send, domain, contact, inbox and webhook endpoint limits, today’s accepted send count (UTC day), on a monthly plan this billing period’s usage, and this month’s deep verification. BillionSend extension.

GET/usage
Autorisierung
AuthorizationBearer-Token · headererforderlich

A BillionSend API key (bs_…).

Antworten
200

Effective plan, its send, domain, contact, inbox and webhook endpoint limits, today's accepted send count (UTC day), on a monthly plan the billing period's usage, and this quota month's deep verification. BillionSend extension.

objectstringerforderlich
Erlaubt:usage
planstring | nullerforderlich

Effective plan

Erlaubt:freestarterproscalenull
limitsobjecterforderlich
Eigenschaften anzeigen
emails_per_dayinteger | nullerforderlich

Daily cap (UTC day) on Free; null on monthly plans

emails_per_monthinteger | nullerforderlich

Emails included per billing period on Starter, Pro and Scale; null on Free

domainsinteger | nullerforderlich

null = unlimited

contactsinteger | nullerforderlich

Contacts the team may hold; null = unlimited

inboxesinteger | nullerforderlich

Inboxes the team may hold at once; null = unlimited

webhook_endpointsinteger | nullerforderlich

Webhook endpoints the team may hold; null = unlimited

todayobjecterforderlich
Eigenschaften anzeigen
emails_sentintegererforderlich

Emails accepted so far this UTC day

resets_atstringerforderlich

Next UTC midnight, when the daily counter resets

periodobject | nullerforderlich

Billing-period usage on monthly plans; null on daily plans

Eigenschaften anzeigen
emails_sentintegererforderlich

Emails accepted so far this billing period

includedintegererforderlich

Emails the plan includes per period

overage_enabledbooleanerforderlich

Whether sends past included bill overage instead of being refused

overage_usd_per_1knumbererforderlich

Overage price per 1,000 emails, in USD

starts_atstringerforderlich

Billing period start

ends_atstringerforderlich

Billing period end, when the counter resets

verificationobjecterforderlich

Deep verification of contacts this quota month (POST /verifications)

Eigenschaften anzeigen
verifiedintegererforderlich

Addresses deep verification gave a definite verdict this quota month

from_grantintegererforderlich

Of them, covered by the free credit

meteredintegererforderlich

Of them, billed on the monthly invoice

cost_centsintegererforderlich

What the billed addresses cost, in cents

price_per_1k_centsintegererforderlich

Price per 1,000 verified addresses past the credit, in cents

teamobjecterforderlich
Eigenschaften anzeigen
idstring<uuid>erforderlich
namestringerforderlich
app_urlstring | nullerforderlich

Dashboard origin, for building links; null when unset

401

Missing, malformed, unknown or revoked API key

statusCodenumbererforderlich
namestringerforderlich
messagestringerforderlich
403

Restricted API key

statusCodenumbererforderlich
namestringerforderlich
messagestringerforderlich
429

Over the rate limit (rate_limit_exceeded, with Retry-After)

statusCodenumbererforderlich
namestringerforderlich
messagestringerforderlich
Ausprobieren
Server
Autorisierung
Anfrage
curl -X GET 'https://api.billionsend.com/usage' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Antwort
{
  "object": "usage",
  "plan": "free",
  "limits": {
    "emails_per_day": 0,
    "emails_per_month": 0,
    "domains": 0,
    "contacts": 0,
    "inboxes": 0,
    "webhook_endpoints": 0
  },
  "today": {
    "emails_sent": 0,
    "resets_at": "string"
  },
  "period": {
    "emails_sent": 0,
    "included": 0,
    "overage_enabled": true,
    "overage_usd_per_1k": 0,
    "starts_at": "string",
    "ends_at": "string"
  },
  "verification": {
    "verified": 0,
    "from_grant": 0,
    "metered": 0,
    "cost_cents": 0,
    "price_per_1k_cents": 0
  },
  "team": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string"
  },
  "app_url": "string"
}

War diese Seite hilfreich?