# documents.history.list

Read an agreement template's history, newest first: sessions of saves (who, when, through the writer, Ask AI, an AI app, the API, an accepted suggestion or a restore, and what changed: text, name, fields, signers, letterhead, footer or logo), publishing and archiving, and suggestions made, accepted or rejected. Pass before (the nextBefore it returned) for older history.

`GET | POST /api/v1/accounting/documents.history.list`

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

MCP tool: `accounting_documents_history_list`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `documentType` | "agreement_template" | Yes |  |
| `documentId` | string (ID) | Yes | The ID of the related record. |
| `before` | string (date-time) |  |  |
| `limit` | integer |  | How many results to return at most. 1 to 200. Default `100`. |

## Example request

```bash
curl -G https://app.getoatmilk.com/api/v1/accounting/documents.history.list \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'documentType=agreement_template' \
  --data-urlencode 'documentId=1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d'
```

Reference page: https://app.getoatmilk.com/docs/api/documents.history.list