Read a receipt from your own code.

Upload one receipt as multipart/form-data. Extraction happens asynchronously — this returns as soon as the file is stored.

curl -X POST \
  https://smartreceipt-api.zajelsoft.com/api/v1/receipts \
  -H "Authorization: Bearer $KEY" \
  -F "file=@transfer_slip.jpg"

{
  "receipt_id": "9c2b1e4a-...",
  "duplicate": false
}

• Accepted types: JPEG, PNG, WEBP, HEIC/HEIF, TIFF, PDF. Max 20 MB.
• Poll GET /api/v1/receipts/{id} until status leaves queued / processing.
• Safe to retry — uploading identical bytes again for the same tenant returns the original receipt with duplicate: true, never a second row. Retry blindly on a timeout.

List receipts, newest first.

Query params (all optional): batch_id, status, bank, currency, date_from, date_to, q (searches extracted text), cursor (from the previous page's next_cursor), limit (default 50, max 200).

{
  "receipts": [
    {
      "id": "9c2b1e4a-...",
      "status": "approved",
      "bank_name": "Bank of Palestine",
      "amount": "1250.00",
      "currency": "ILS",
      "reference_number": "TX-88213940",
      "transaction_date": "2026-08-14",
      "review_reasons": [],
      "confidence": "0.95",
      "created_at": "2026-08-14T10:02:11Z"
    }
  ],
  "next_cursor": null
}

Money is always a string — "1250.00", never a JSON number. Parse it as a decimal, or you'll lose precision the same way this platform refuses to.

Full detail — the list shape above, plus raw_text, sender_name, receiver_name, account_number, transaction_type, notes, provenance fields (provider, model, prompt_version, token counts), and original_url — a short-lived signed link to the source file, null once it's aged past your retention window.

A cross-tenant or nonexistent id returns a plain 404, never a 403 — this API never confirms a receipt exists in an account that isn't yours.

Correct one or more extracted fields — only while the receipt is extracted or needs_review. Once approved, a correction is rejected: that status is a sign-off on specific values, not a draft.

Send only the fields you're changing, from: bank_name, bank_name_original, amount, currency, reference_number, transaction_date, transaction_time, sender_name, receiver_name, account_number, transaction_type, primary_language, notes. Anything else in the body is rejected by name.

Returns the updated detail object. Correcting the last thing flagging a receipt moves its status to extracted automatically.

Build a CSV or JSON export — the same engine behind the web app's Export screen. Only approved receipts are ever included.

{
  "format": "csv",
  "filters": {
    "currency": "ILS",
    "date_from": "2026-08-01",
    "date_to": "2026-08-31"
  },
  "columns": [
    { "field": "transaction_date", "header": "Date" },
    { "field": "amount", "header": "Amount" },
    { "field": "currency", "header": "Currency" }
  ]
}

• format: "csv" or "json" (XLSX isn't built yet). Only formats your plan includes are accepted.
• columns is optional — omit for the default set. Selecting amount requires also selecting currency: a bare amount column is a list of numbers in mixed currencies that adds up to nothing real.
• Returns immediately with status: "queued".

{
  "id": "b7e1...",
  "format": "csv",
  "status": "ready",
  "row_count": 42,
  "error_message": null,
  "created_at": "2026-09-05T09:00:00Z",
  "expires_at": "2026-09-06T09:00:00Z",
  "download_url": "https://smartreceipt-files.zajelsoft.com/...&signature=..."
}

download_url only appears while status == "ready" and unexpired — a fresh signed URL on every poll, always valid for whatever remains of the original 24-hour window.