GET/api/orgs/{org_id}/provider/usage

Get daily lane usage

Per-day traffic across every org that called your lanes, in whole UTC settlement days. Consumers appear only as distinct counts, never identities. Money is in US dollars. 503 when usage analytics are unavailable on this deployment; 429 with Retry-After: 1 when the analytics store is busy.

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

    Daily rows, oldest first.

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

        UTC settlement day.

      • request_countintegerrequired
      • error_countintegerrequired
      • input_tokensintegerrequired
      • output_tokensintegerrequired
      • cost_usdnumberrequired

        Settled charged money in US dollars.

      • estimated_cost_usdnumberrequired

        List-price estimate of traffic not charged by the platform (customer-key traffic), in US dollars.

      • distinct_api_keysintegerrequired

        Count of distinct calling keys (no identities).

      • distinct_orgsintegerrequired

        Count of distinct calling orgs (no identities).

      • ttft_p50_msinteger | nullrequired

        Median time to first token in milliseconds.

      • ttft_p90_msinteger | nullrequired
      • timeout_countintegerrequired
  • 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?days=30 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "days": 30,
  "rows": [
    {
      "day": "2026-11-18",
      "request_count": 48210,
      "error_count": 37,
      "input_tokens": 182044901,
      "output_tokens": 21455092,
      "cost_usd": 82.3341,
      "estimated_cost_usd": 4.1022,
      "distinct_api_keys": 214,
      "distinct_orgs": 96,
      "ttft_p50_ms": 380,
      "ttft_p90_ms": 910,
      "timeout_count": 4
    }
  ]
}

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