Skip to main content
GET
/
v2
/
budgets
/
{budget_id}
/
consumption
Get current-period consumption
curl --request GET \
  --url https://api.orq.ai/v2/budgets/{budget_id}/consumption \
  --header 'Authorization: Bearer <token>'
{
  "budget_id": "<string>",
  "period_date": "<string>",
  "cost": 123,
  "tokens": "<string>",
  "requests_in_window": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
budget_id
string
required

Budget id whose counters should be returned.

Response

200 - application/json

OK

​
budget_id
string

Budget id whose counters are reported.

​
period
enum<string>

Period the cost / tokens counters bucket against.

Available options:
BUDGET_PERIOD_UNSPECIFIED,
BUDGET_PERIOD_DAILY,
BUDGET_PERIOD_WEEKLY,
BUDGET_PERIOD_MONTHLY,
BUDGET_PERIOD_YEARLY,
BUDGET_PERIOD_ONE_TIME
​
period_date
string

Period bucket label (e.g. "2025-05-27" for DAILY, "2025-05" for MONTHLY). Empty when no counters exist for the current period.

​
cost
number<double>

Cost accumulated in the current period, in USD.

​
tokens
string

Tokens accumulated in the current period.

​
requests_in_window
integer<int32>

Requests counted in the current 60-second rolling window.