Model Metrics: Response Format

​

Response format

{
  "data": {
    "dataPoints": [
      {
        "startTimestamp": "2026-04-29T12:00:00.000Z",
        "endTimestamp": "2026-04-29T13:00:00.000Z",
        "total": 1234,
        "<aggregationKey>": 0,
        "<groupByKey>": "value-or-null"
      }
    ]
  }
}

• total: implicit COUNT(*) for the row. Always present.
• <aggregationKey>: one key per requested aggregation. The key is <type><Column> in camelCase (e.g. sumLatencyMs, p99LatencyMs, countModelName, countDistinctToolName).
• <groupByKey>: one key per groupBy entry. The key is the lowerCamelCase form of the underlying column. Two special mappings:
  • userEmail and virtualaccount both map to createdBySubjectSlug in the response (the underlying column is CreatedBySubjectSlug, differentiated by CreatedBySubjectType).
  • team maps to team (the value is a single unnested scalar, not an array). All other groupBy keys preserve their lowerCamelCase name.
• startTimestamp: present only for timeseries responses. Bucket start as an ISO 8601 timestamp string (e.g. "2026-04-29T12:00:00.000Z"). Distribution responses omit it.
• endTimestamp: present only for timeseries responses. Bucket end as an ISO 8601 timestamp string, equal to the next bucket’s startTimestamp (e.g. "2026-04-29T13:00:00.000Z"). Distribution responses omit it.

​

Distribution response example

{
  "data": {
    "dataPoints": [
      {
        "modelName": "gpt-4o",
        "total": 1240,
        "countModelName": 1240,
        "sumInputTokens": 125000,
        "sumOutputTokens": 45000,
        "p99LatencyMs": 2450.5,
        "sumCostInUSD": 8.42
      },
      {
        "modelName": "gpt-3.5-turbo",
        "total": 860,
        "countModelName": 860,
        "sumInputTokens": 89000,
        "sumOutputTokens": 32000,
        "p99LatencyMs": 1820.3,
        "sumCostInUSD": 1.78
      }
    ]
  }
}

​

Timeseries response example

{
  "data": {
    "dataPoints": [
      {
        "startTimestamp": "2026-04-21T00:00:00.000Z",
        "endTimestamp": "2026-04-21T01:00:00.000Z",
        "modelName": "gpt-4o",
        "total": 25,
        "countModelName": 25,
        "sumInputTokens": 15000,
        "p99LatencyMs": 2100.5
      },
      {
        "startTimestamp": "2026-04-21T01:00:00.000Z",
        "endTimestamp": "2026-04-21T02:00:00.000Z",
        "modelName": "gpt-4o",
        "total": 30,
        "countModelName": 30,
        "sumInputTokens": 18500,
        "p99LatencyMs": 2350.2
      }
    ]
  }
}

​

Error responses

{
  "statusCode": 400,
  "message": "Invalid query",
  "details": ["..."]
}

• Operator not allowed on this field, for example, EQUAL on a field that supports only IN/NOT_IN.
• Missing required value (or wrong shape, e.g. scalar where array is expected for IN / BETWEEN).
• Unknown field name for the datasource.
• Invalid interval format (compound expressions, unrecognised unit, non-positive integer).
• Missing required interval for a timeseries query.

• 401 Unauthorized: missing or invalid bearer token.
• 403 Forbidden: caller does not have permission for the requested scope.
• 500 Internal Server Error: unexpected server error while executing the query.