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

Get window latency percentiles

p50 and p95 of latency and time to first token over every request in the window, estimated from fixed histogram buckets (milliseconds).

Authentication: Bearer API key in the Authorization header

Path parameters

  • org_idstringrequired

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

Query parameters

  • windowenum

    Lookback window ending now. 24h buckets hourly, 7d and 30d daily.

    "24h""7d""30d"
    Default: "7d"
  • modelstring

    Restrict to one model slug (the alias the caller requested).

  • api_key_idstring

    Restrict to one API key (uuid).

  • laneenum

    Restrict to one money lane: platform (platform credits) or byok (your own provider key, never charged). A lane cut excludes requests where nothing was dispatched.

    "platform""byok"

Responses

  • 200

    Percentiles.

    Response
    • windowenumrequired
      "24h""7d""30d"
    • measured_fromstringrequired
    • requestsintegerrequired

      Every request in the window.

    • latencyobject | nullrequired

      End-to-end latency; null when no request recorded it.

      One of

      object

      • samplesintegerrequired
      • p50_msintegerrequired
      • p95_msintegerrequired
    • ttftobject | nullrequired

      Time to first token; null when none recorded it.

      One of

      object

      • samplesintegerrequired
      • p50_msintegerrequired
      • p95_msintegerrequired
  • 400

    Unknown window or lane, or a malformed api_key_id.

    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).

  • 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

    Unknown organization, or not the key's own 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).

  • 429

    Too many reads. rate_limited: this organization's API-key reads of the request log are over about 10 per second (burst 30) or 4 in flight on one server (sessions are not limited). build_capacity: the shared analytics read slots are busy. Retry after Retry-After.

    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 temporarily unavailable. Retry shortly.

    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/usage/latency?window=24h&model=gpt-6-luna&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&lane=platform \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "window": "7d",
  "measured_from": "2026-11-11T14:32:00Z",
  "requests": 11840,
  "latency": {
    "samples": 11790,
    "p50_ms": 1840,
    "p95_ms": 7420
  },
  "ttft": {
    "samples": 9120,
    "p50_ms": 390,
    "p95_ms": 1610
  }
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/usage/latency?window=24h&model=gpt-6-luna&api_key_id=6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33&lane=platform