API reference

Usage

What you have processed this billing period, so costs never surprise you.

Get usage

GET

Calls and documents processed in the current billing period, with a per-day breakdown. Useful for tracking spend against your plan's included documents. Requires the usage:read scope.

curl "https://api.invoi.st/v1/usage" \
  -H "Authorization: Bearer $INVOIST_API_KEY"

Response · 200

JSON

123456789{
  "period_start": "2026-08-01T00:00:00Z",
  "total_calls": 412,
  "total_documents": 389,
  "total_cost_cents": 3112,
  "by_day": [
    { "day": "2026-08-18", "calls": 31, "documents": 29 }
  ]
}