Skip to main content
GET
/
v1
/
usage
Get Usage
curl --request GET \
  --url https://api.oneinbox.ai/v1/usage \
  --header 'Authorization: Bearer <token>'
{
  "calls_made_today": 123,
  "max_calls_per_day": 123,
  "calls_remaining_today": 123,
  "calls_this_month": 123,
  "minutes_used_this_month": 123,
  "cost_cents_this_month": 123,
  "kb_token_budget": 123,
  "period_start": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Your API key sent as a Bearer credential — Authorization: Bearer <api_key>, where <api_key> starts with oi_sk_ (create one via POST /v1/api-keys). Although the field is labelled 'token', paste your API key here. A dashboard JWT is also accepted on this header for the same endpoints.

Response

200 - application/json

Successful Response

Developer-facing usage snapshot for GET /v1/usage (PDF API-mgmt #4).

Daily figures reset at 00:00 UTC; monthly figures cover the current calendar month (UTC). minutes_used_this_month is the billed credit total (1 credit == 1 active minute). cost_cents_this_month is the estimated carrier spend.

​
calls_made_today
integer
required
​
max_calls_per_day
integer
required
​
calls_remaining_today
integer
required
​
calls_this_month
integer
required
​
minutes_used_this_month
number
required
​
cost_cents_this_month
integer
required
​
kb_token_budget
integer
required
​
period_start
string<date-time>
required