# runs.trace

Read an authorized process trace with its stage timeline, logs, model metadata, and linked Workflow SDK run, steps, and events. Restricted mail remains visible only to a security administrator.

`GET | POST /api/v1/accounting/runs.trace`

Permissions: `accounting:read`, `mail:read` · Roles: admin, finance

MCP tool: `accounting_runs_trace`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `id` | string (ID) | Yes | The record's ID. |
| `limit` | integer |  | How many results to return at most. 1 to 1000. Default `500`. |

## Example request

```bash
curl -G https://app.getoatmilk.com/api/v1/accounting/runs.trace \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'id=9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d'
```

Reference page: https://app.getoatmilk.com/docs/api/runs.trace