Skip to main content
GET
Get your team's spend this billing period
It is an estimate; the invoice is authoritative.
  • Owners and Admins only. An API key needs team:manage.
  • Days are UTC days. Each day’s calls beyond its included calls are overage at that day’s price.
  • status no_terms: the team has no billing terms with Pomerado yet.
  • Callers: an API key, an MCP OAuth token or a Dashboard session.
  • Permission: team:manage; an API key also needs team:manage.
  • Effect: Changes nothing.
  • Errors: business_account_required, role_permission_missing, and the errors any request can get.

Authorizations

Authorization
string
header
required

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

Response

Your team's spend this period

status
enum<string>
required
Available options:
ready
as_of
string
required
currency
enum<string>
required
Available options:
usd
period
object
required
included_calls_per_day
integer
required

Tool calls included each UTC day, today's; unused ones don't carry over

Required range: x >= 0
overage_unit_amount_cents
string
required

Today's price of each call beyond the included ones, in cents with up to four decimal places, such as 1.0000

included_calls_used
integer
required

Calls in the period within each day's included calls

Required range: x >= 0
overage_calls
integer
required

Calls in the period beyond each day's included calls

Required range: x >= 0
monthly_fee_cents
integer
required

The team's monthly fee, in US cents

Required range: x >= 0
estimated_overage_cents
integer
required

Each day's overage calls at that day's price, so far, in US cents

Required range: x >= 0
estimated_total_cents
integer
required

The period's invoices so far, in US cents: on monthly terms the monthly fee plus the estimated overage; on weekly or daily terms the estimated overage alone, since the monthly fee is invoiced on its own each month

Required range: x >= 0
projected_overage_cents
integer
required

The overage by the period's end at the period's pace so far: the estimated overage over days_elapsed, times days, in US cents

Required range: x >= 0
today
object
required

Today, the UTC day, so far