# runs.get

Read one run, or the latest run for a subject, with its ordered step events: steps started and finished, model calls, outputs, decisions, and errors. Use afterEventId to fetch only new events while a run is active.

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

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

MCP tool: `accounting_runs_get`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `id` | string (ID) |  | The record's ID. |
| `subjectType` | string |  | The kind of record this is about, such as entry, invoice or mail. Matches ^[a-z][a-z0-9_]{1,40}$. |
| `subjectId` | string |  | The ID of the record this is about. 1–200 characters. |
| `afterEventId` | integer |  | 0 to 9007199254740991. Default `0`. |
| `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.get \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'id=9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d'
```

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