Skip to main content
Four calls show your balance, what you spent and your limits. They are free and need an API key. Every amount is in dollars. Each response also has older fields that count the same amounts in steps of $0.002. This page leaves them out. Use the dollar fields.

Check your limits and balance

This is a real response. The balance is an example.
GET /v1/limits counts as one call toward the per-minute limit. See Rate limits for what each limit means.

Check what you have used

balanceMicros is the balance in millionths of a dollar. costUsd is what all your calls have cost, and requestCount is how many paid calls you made. This response has no success or data wrapper. The numbers are an example.

Read your spending over time

GET /v1/usage/history groups your paid calls into buckets.
This is a real response.
The window can span at most 31 days for hour and 366 days for day and month, and from must be before to, or the call answers invalidRequest. start is the UTC start of the bucket. Buckets with no paid calls are left out, and calls that cost nothing are not counted. totals adds the buckets.

Read your monthly spend

GET /v1/team/credit-usage returns your balance. GET /v1/team/credit-usage/historical returns one row for each month of the last year, with what you spent. The first call returns balanceUsd. There are no plans, so its plan and period fields are null.
This is the real shape, cut to the last three months. The amounts are an example. Send byApiKey=true to split each month by the key that made the calls. Each row then has the key’s name in apiKey. For the model use of extract and agent, see Usage and logs.