# Receipt OCR & Parser

Receipt OCR to JSON for expenses: merchant, date, items, tax, total and payment method from a photo or scan.

Send a photo or scan of a receipt as a PNG, JPEG, WebP or PDF, by link or as base64. You get the merchant with its address (and its tax ID when printed on a line of its own), date and time, each item, subtotal, tax, total, currency, payment method and the last four card digits when printed. It copes with tilted and slightly blurred photos. Amounts are read as printed and parsed by fixed rules, and the printed text comes back beside each number. Runs on our own hardware in the EU; receipts are read in memory and never stored. A model can misread: check the total before you reimburse on it.

- Amounts are read as printed and parsed by fixed rules, and the printed text comes back beside each number.
- Copes with tilted and slightly blurred phone photos, and returns the payment method and last four card digits when printed.
- Receipts are read in memory on our own hardware in the EU and never stored.

## Calls

### `POST https://readymadeapi.com/v1/receipts/parse`

Send a receipt and get the merchant, date, time, items, subtotal, tax, total, currency and payment method as JSON. Each page read is one unit.

- Price: $0.008 per page, up to 2 per call
- MCP tool: `receipt_parser_parse`
- Answers in the same call.

Request:

```json
{
  "file_url": "https://readymadeapi.com/samples/receipt.jpg"
}
```

Answer:

```json
{
  "fields": {
    "merchant": {
      "name": "CAFE LUMINA",
      "address": "Str. Exemplu 12, Cluj-Napoca",
      "tax_id": "RO87654321"
    },
    "date": "2026-11-19",
    "time": "13:42",
    "currency": "RON",
    "items": [
      {
        "description": "2 x Flat white",
        "amount": 28.0
      },
      {
        "description": "1 x Avocado toast",
        "amount": 32.0
      },
      {
        "description": "1 x Lemon tart",
        "amount": 19.5
      },
      {
        "description": "1 x Still water 0,5 l",
        "amount": 8.0
      }
    ],
    "subtotal": 80.25,
    "tax": 7.25,
    "total": 87.5,
    "payment_method": "CARD",
    "card_last4": "4417"
  },
  "as_printed": {
    "items.0.amount": "28,00",
    "items.1.amount": "32,00",
    "items.2.amount": "19,50",
    "items.3.amount": "8,00",
    "subtotal": "80,25",
    "tax": "7,25",
    "total": "87,50"
  },
  "pages_read": 1,
  "pages": 1
}
```

## Limits

- Up to 2 pages per call: PNG, JPEG, WebP or PDF.
- By link, up to 15 MB.

## Questions

**Which files?**

PNG, JPEG, WebP or PDF, by link or as base64, up to two pages; each page read is one unit.

**How accurate is it?**

It is a model and it can misread. Check the total before you reimburse on it; the printed text beside each number makes that quick.

## Using it

- Send `Authorization: Bearer <key>` and a JSON body. Keys and credit: https://readymadeapi.com/account
- Every answer carries `X-Request-Id`, `X-Units` and `X-Charged-Usd`.
- An error is a JSON problem with a `title` to act on and a `detail` in plain words; nothing is charged for it.
- Full schema: https://readymadeapi.com/openapi.json
