GET/api/orgs/{org_id}/provider/usage/by-model

Get daily usage per model

Per-day, per-model rows across all calling orgs. Only settled charged money (platform-funded traffic) counts toward cost_usd, in US dollars. Same 429 and 503 behavior as the daily usage read.

Authentication: Bearer API key in the Authorization header

Path parameters

  • org_idstringrequired

    Your organization id (uuid). GET /api/whoami returns it.

Query parameters

  • daysinteger

    Window length in days, counted back from now.

    Default: 30

Responses

  • 200

    One row per (day, model).

    Response
    • daysintegerrequired
    • rowsarray<object>required
      rows
      • daystringrequired
      • aliasstringrequired

        Model slug.

      • request_countintegerrequired
      • input_tokensintegerrequired
      • output_tokensintegerrequired
      • cost_usdnumberrequired

        Settled charged money in US dollars.

  • 401

    Missing, unknown or revoked API key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    The resource does not exist or belongs to another organization.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    The body or query failed validation.

    Response
    • detailarray<object>required
      detail
      • typestring
      • locarray<string | integer>
      • msgstring
  • 429

    The usage analytics store is busy; retry after the Retry-After seconds.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 503

    Usage analytics are unavailable on this deployment or temporarily failing.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

Request

curl https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/usage/by-model?days=30 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "days": 30,
  "rows": [
    {
      "day": "2026-11-18",
      "alias": "llama-4.1-70b-instruct",
      "request_count": 31877,
      "input_tokens": 120511330,
      "output_tokens": 14002871,
      "cost_usd": 54.7811
    }
  ]
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/usage/by-model?days=30