# agents.playground.receipt

Dry run of the receipt reader: read a sample receipt (filename, mimeType, contentBase64 of up to 2 MB; JPEG, PNG, WebP, HEIC, PDF or .eml) the same way intake does and return the extracted facts and validation flags. Nothing is saved: no submission, evidence, entry or run.

`GET | POST /api/v1/accounting/agents.playground.receipt`

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

MCP tool: `accounting_agents_playground_receipt`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `filename` | string | Yes | The file's name, including its extension. 1–200 characters. |
| `mimeType` | enum | Yes | The file's type, such as image/jpeg or application/pdf. One of: `image/jpeg`, `image/png`, `image/webp`, `image/heic`, `image/heif`, `application/pdf`, `message/rfc822`. |
| `contentBase64` | string | Yes | The file's exact bytes, encoded as base64. 4–2800000 characters; Matches ^[A-Za-z0-9+/]+={0,2}$. |

## Example request

```bash
curl -G https://app.getoatmilk.com/api/v1/accounting/agents.playground.receipt \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'filename=receipt.jpg' \
  --data-urlencode 'mimeType=image/jpeg' \
  --data-urlencode 'contentBase64=contentBase64'
```

Reference page: https://app.getoatmilk.com/docs/api/agents.playground.receipt
