# 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`](https://docs.maitento.com/reference/types/usage-run-row.md)`[]` | The runs. |
| `truncated` | `boolean` | More runs matched than were returned. |

## Example

```json
{
  "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`](https://docs.maitento.com/reference/api/usage.md) (`GET /usage/runs`)