UsageRunPage

The individual runs behind a range’s usage, largest first by the chosen measure.

Kind: an object, used in responses.

Fields

Every field is present in a response; empty ones are null.

Field	Type	Description
from	datetime	The start of the range, in UTC.
to	datetime	The end of the range, in UTC.
sort	string	The measure the runs are ordered by.
items	UsageRunRow[]	The runs.
truncated	boolean	More runs matched than were returned.

Example

{
  "from": "2026-10-26T12:00:00.0000000Z",
  "to": "2026-10-26T12:00:00.0000000Z",
  "sort": "...",
  "items": [
    {
      "processId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "type": "App",
      "definitionId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "definitionName": "...",
      "definitionVersion": 0,
      "namespaceId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "namespaceName": "...",
      "outcome": "InProgress",
      "dateStarted": "2026-10-26T12:00:00.0000000Z",
      "dateEnded": "2026-10-26T12:00:00.0000000Z",
      "date": "2026-10-26T12:00:00.0000000Z",
      "runtimeMs": 0,
      "executionMs": 0,
      "tokens": {},
      "totalTokens": {},
      "steps": 0,
      "toolCalls": 0,
      "startedBy": "User",
      "triggerId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "triggerName": "...",
      "parentProcessId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "parentProcessType": "App",
      "rootProcessId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "rootType": "App",
      "rootDefinitionId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "rootDefinitionName": "...",
      "available": false,
      "status": "...",
      "state": "Active",
      "retentionLease": {},
      "retentionExpiresAtUtc": "2026-10-26T12:00:00.0000000Z"
    }
  ],
  "truncated": false
}

Where it’s used

• usage.runs (GET /usage/runs)