# documents.assets.list

List the images kept in the agreement library (logos, diagrams, stamps) with their titles, sizes and private links that show them for about an hour. Pass ids to get links for specific images, such as the ones a template places with asset:<id>.

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

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

MCP tool: `accounting_documents_assets_list`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `ids` | array of strings (ID) |  | 1–100 items. |
| `search` | string |  | Text to search for. at most 120 characters. |
| `includeArchived` | boolean |  | Also include archived records. |
| `limit` | integer |  | How many results to return at most. 1 to 100. Default `50`. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/documents.assets.list \
  -H "Authorization: Bearer $OATMILK_API_KEY"
```

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