# inbox.list

List receipt submissions and their review or processing state.

`GET | POST /api/v1/accounting/inbox.list`

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

MCP tool: `accounting_list_submissions`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `status` | enum |  | Only include records with this status. One of: `prepared`, `queued`, `processing`, `review`, `completed`, `quarantined`, `failed`. |
| `source` | enum |  | Where the record came from. One of: `email`, `upload`, `mcp`. |
| `sort` | enum |  | One of: `newest`, `oldest`. |
| `limit` | integer |  | How many results to return at most. 1 to 100. Default `30`. |
| `cursor` | string (date-time) |  | Where the next page starts: the nextCursor value from the previous response. |

## Example request

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

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