Usage reconciliation

Aggregates monthly usage for an account, including the number of requests (every endpoint the client calls) and the number of invoices (the billing basis). This endpoint is free.

GET /tax-accounts/{accountId}/usage?month=YYYY-MM

Example response

{
  "accountId": "cf00eea0-af08-4e84-9aa3-e12d23b3a568",
  "month": "2025-03",
  "invoices": {
    "jobs": 3, "syncJobs": 2, "detailJobs": 1,
    "windows": 2, "invoicesNew": 1200, "billableInvoices": 2160.0
  },
  "requests": {
    "total": 84,
    "byEndpoint": [
      { "method": "GET", "route": ".../invoices", "count": 40 },
      { "method": "POST", "route": ".../sync", "count": 2 }
    ]
  }
}

Field	Meaning
invoices.windows	Number of ≤31-day windows (used for the per-window/sync fee when syncing)
invoices.invoicesNew	Number of new invoices (deduplicated) — the billing basis
invoices.billableInvoices	Weighted billable invoices (×1.5 if detail is fetched)
requests.total	Total number of requests the client made during the month
requests.byEndpoint	Request count by endpoint — used to compute read fees (list / detail = 10% of the sync fee per request)

See how this converts to money at API request pricing.