Usage

Check your balance and usage stats.

Endpoint

GET

/v1/usage

Retrieve current balance and usage statistics

Response fields

Parameter	Type	Required	Description
balance_cents	integer	No	Current account balance in cents.
requests_today	integer	No	Total API requests made today (UTC).
spend_this_month_cents	integer	No	Total spend so far this calendar month in cents.

Example

bash

curl https://api.tierup.ai/v1/usage \
  -H "Authorization: Bearer $TIERUP_API_KEY"

json

{
  "balance_cents": 2150,
  "requests_today": 42,
  "spend_this_month_cents": 350
}

Low balance warning

When your balance drops below $5, every API response includes the header:

bash

X-TierUp-Balance-Low: true

Tip: Check for X-TierUp-Balance-Low: true in your response headers and proactively call POST /v1/billing/add-credits to avoid service interruption.