Partners

Aggregated wholesale usage for a date range

Per-user call counts + wholesale cost for the given period. Used by partners to reconcile their monthly invoice.

Default period: current calendar month. per_user array is capped at 5000 rows ordered by cost descending — pagination.truncated flags when totals exceed that. Totals row is unaffected by truncation.

Auth: ptx_live_… provisioning key. Rate limit: 30/min per partner key.

get/api/v1/partner/usage

Request

  • Base URL: https://www.agenttax.io
  • URL: https://www.agenttax.io/api/v1/partner/usage
  • Auth: API key in header X-API-Key

Query parameters

fromstring date-time

ISO date-time. Defaults to start of current calendar month (usage) / previous month (revshare).

tostring date-time

ISO date-time. Must be after from. Exclusive upper bound.

Response

Aggregated usage and per-user breakdown.

Example response

{
  "period": {
    "from": "2026-04-01T00:00:00Z",
    "to": "2026-04-01T00:00:00Z"
  },
  "totals": {
    "wholesale_cost_usd": "12.3400"
  },
  "per_user": [
    {
      "cost_usd": "12.3400"
    }
  ],
  "pagination": {
    "per_user_cap": 5000
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.