Receipt parsing

Convert Receipts to JSON

Upload a receipt file and receive a structured JSON object with merchant, total, tax, date, currency, receipt ID, payment method, and line items. One API call. No parser to build.

Get API Key View Docs

Start with 20 documents/month and full API access. No credit card required.

JSON structure

What the JSON includes

Named fields your application can read directly — no parsing required

merchant
Store or vendor name
total
Final charged amount
subtotal
Pre-tax total
tax
Tax amount
date
Transaction date
currency
ISO 3-letter code
receipt_id
Receipt identifier
payment_method
Card, cash, etc.
merchant_email
Vendor email if present
merchant_address
Store address if present
line_items
Products or services list

Receipt file → JSON object

Send the file. Receive structured data. No custom parsing, no regex, no layout detection.

Before — receipt file

EXAMPLE MARKET
123 Commerce Street
Date: 05/10/2026
Receipt #R-10492
Example item x1 ..... $19.50
Subtotal: $39.00
Tax (10%): $3.90
Total: $42.90
Payment: Card

After — JSON response

{
  "success": true,
  "document_type": "receipt",
  "merchant": "Example Market",
  "date": "2026-05-10",
  "total": "42.90",
  "subtotal": "39.00",
  "tax": "3.90",
  "currency": "USD",
  "receipt_id": "R-10492",
  "payment_method": "Card",
  "line_items": [
    {
      "description": "Example item",
      "quantity": 1,
      "amount": "19.50"
    }
  ],
  "extraction_source": "rule"
}

Request

curl -X POST https://docuparseapi.com/api/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@receipt.pdf"

Response

{
  "success": true,
  "document_type": "receipt",
  "merchant": "Example Market",
  "date": "2026-05-10",
  "total": "42.90",
  "subtotal": "39.00",
  "tax": "3.90",
  "currency": "USD",
  "receipt_id": "R-10492",
  "payment_method": "Card",
  "line_items": [
    {
      "description": "Example item",
      "quantity": 1,
      "amount": "19.50"
    }
  ],
  "extraction_source": "rule"
}

Frequently asked questions

What formats does DocuParse API accept for receipts?

DocuParse API accepts PDF, JPG, PNG, and CSV files. Both digital receipts and scanned paper receipts are supported.

What JSON fields are returned for a receipt?

The response includes merchant, total, subtotal, tax, date, currency, receipt_id, payment_method, merchant_email, merchant_address, line_items, and extraction_source.

Does it work with scanned receipts?

Yes. DocuParse handles scanned receipts automatically. The extraction returns the same named fields regardless of scan quality.

Can I use this in a Node.js or Python app?

Yes. The API is a standard REST endpoint that accepts multipart file uploads. Any HTTP client works. The docs include copy-paste examples for Node.js and Python.

Is the output always JSON?

Yes. Every response from the extract endpoint is a JSON object. There is no raw text mode.

What if the receipt does not have all fields?

Fields that cannot be extracted are omitted from the response or returned as null. Use your own validation rules for any required fields.

Related pages

Receipt OCR API

Full guide to the receipt OCR API with all supported fields.

Learn more

PDF to JSON API

Convert business PDFs into structured JSON data.

Learn more

Document Extraction API

Overview of the full document extraction API.

Learn more

Invoice to JSON

Convert invoice PDFs into structured JSON.

Learn more

Start converting receipts to JSON

Start with 20 documents/month and full API access. No credit card required.

Get API Key View Docs