Iteration Layer
Products
Use Cases
Resources

Benchmarks

OCR
Pricing
Login Get Started

Extract Receipt Data

Extract merchant, date, line items, tax, and total from receipts.

Get Your Free API Key

No credit card required — start with free trial credits

Who this is for

Finance teams and expense management apps use this recipe to automate receipt processing. Upload a receipt photo or PDF and receive structured JSON with merchant name, date, individual items, and total — ready for an expense report or reimbursement workflow.

Finance & Accounting
Request
curl -X POST https://api.iterationlayer.com/document-extraction/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [
      {
        "type": "url",
        "name": "receipt.pdf",
        "url": "https://example.com/receipts/purchase-receipt.pdf"
      }
    ],
    "schema": {
      "fields": [
        {
          "name": "merchant_name",
          "type": "TEXT",
          "description": "Name of the merchant or store"
        },
        {
          "name": "date",
          "type": "DATE",
          "description": "Date of the transaction"
        },
        {
          "name": "items",
          "type": "ARRAY",
          "description": "Individual line items on the receipt",
          "fields": [
            {
              "name": "name",
              "type": "TEXT",
              "description": "Item name or description"
            },
            {
              "name": "amount",
              "type": "CURRENCY_AMOUNT",
              "description": "Item price"
            }
          ]
        },
        {
          "name": "total_amount",
          "type": "CURRENCY_AMOUNT",
          "description": "Total amount charged"
        },
        {
          "name": "currency",
          "type": "CURRENCY_CODE",
          "description": "Currency code (e.g. USD, EUR)"
        }
      ]
    }
  }'
Response
{
  "success": true,
  "data": {
    "merchant_name": {
      "value": "Whole Foods Market",
      "confidence": 0.98,
      "citations": ["WHOLE FOODS MARKET"]
    },
    "date": {
      "value": "2026-02-18",
      "confidence": 0.97,
      "citations": ["02/18/2026"]
    },
    "items": {
      "value": [
        {
          "name": {
            "value": "Organic Avocados (3pk)",
            "confidence": 0.95,
            "citations": ["Organic Avocados 3pk"]
          },
          "amount": {
            "value": {
              "amount": "5.99",
              "currency": "USD"
            },
            "confidence": 0.97,
            "citations": ["$5.99"]
          }
        },
        {
          "name": {
            "value": "Sourdough Bread",
            "confidence": 0.96,
            "citations": ["Sourdough Bread"]
          },
          "amount": {
            "value": {
              "amount": "4.49",
              "currency": "USD"
            },
            "confidence": 0.98,
            "citations": ["$4.49"]
          }
        }
      ],
      "confidence": 0.96,
      "citations": []
    },
    "total_amount": {
      "value": {
        "amount": "10.48",
        "currency": "USD"
      },
      "confidence": 0.99,
      "citations": ["TOTAL: $10.48"]
    },
    "currency": {
      "value": "USD",
      "confidence": 0.99,
      "citations": ["$"]
    }
  }
}
Request
import { IterationLayer } from "iterationlayer";
const client = new IterationLayer({ apiKey: "YOUR_API_KEY" });

const result = await client.extractDocument({
  files: [
    {
      type: "url",
      name: "receipt.pdf",
      url: "https://example.com/receipts/purchase-receipt.pdf",
    },
  ],
  schema: {
    fields: [
      {
        name: "merchant_name",
        type: "TEXT",
        description: "Name of the merchant or store",
      },
      {
        name: "date",
        type: "DATE",
        description: "Date of the transaction",
      },
      {
        name: "items",
        type: "ARRAY",
        description: "Individual line items on the receipt",
        fields: [
          {
            name: "name",
            type: "TEXT",
            description: "Item name or description",
          },
          {
            name: "amount",
            type: "CURRENCY_AMOUNT",
            description: "Item price",
          },
        ],
      },
      {
        name: "total_amount",
        type: "CURRENCY_AMOUNT",
        description: "Total amount charged",
      },
      {
        name: "currency",
        type: "CURRENCY_CODE",
        description: "Currency code (e.g. USD, EUR)",
      },
    ],
  },
});
Response
{
  "success": true,
  "data": {
    "merchant_name": {
      "value": "Whole Foods Market",
      "confidence": 0.98,
      "citations": ["WHOLE FOODS MARKET"]
    },
    "date": {
      "value": "2026-02-18",
      "confidence": 0.97,
      "citations": ["02/18/2026"]
    },
    "items": {
      "value": [
        {
          "name": {
            "value": "Organic Avocados (3pk)",
            "confidence": 0.95,
            "citations": ["Organic Avocados 3pk"]
          },
          "amount": {
            "value": {
              "amount": "5.99",
              "currency": "USD"
            },
            "confidence": 0.97,
            "citations": ["$5.99"]
          }
        },
        {
          "name": {
            "value": "Sourdough Bread",
            "confidence": 0.96,
            "citations": ["Sourdough Bread"]
          },
          "amount": {
            "value": {
              "amount": "4.49",
              "currency": "USD"
            },
            "confidence": 0.98,
            "citations": ["$4.49"]
          }
        }
      ],
      "confidence": 0.96,
      "citations": []
    },
    "total_amount": {
      "value": {
        "amount": "10.48",
        "currency": "USD"
      },
      "confidence": 0.99,
      "citations": ["TOTAL: $10.48"]
    },
    "currency": {
      "value": "USD",
      "confidence": 0.99,
      "citations": ["$"]
    }
  }
}
Request
from iterationlayer import IterationLayer
client = IterationLayer(api_key="YOUR_API_KEY")

result = client.extract_document(
    files=[
        {
            "type": "url",
            "name": "receipt.pdf",
            "url": "https://example.com/receipts/purchase-receipt.pdf",
        }
    ],
    schema={
        "fields": [
            {
                "name": "merchant_name",
                "type": "TEXT",
                "description": "Name of the merchant or store",
            },
            {
                "name": "date",
                "type": "DATE",
                "description": "Date of the transaction",
            },
            {
                "name": "items",
                "type": "ARRAY",
                "description": "Individual line items on the receipt",
                "fields": [
                    {
                        "name": "name",
                        "type": "TEXT",
                        "description": "Item name or description",
                    },
                    {
                        "name": "amount",
                        "type": "CURRENCY_AMOUNT",
                        "description": "Item price",
                    },
                ],
            },
            {
                "name": "total_amount",
                "type": "CURRENCY_AMOUNT",
                "description": "Total amount charged",
            },
            {
                "name": "currency",
                "type": "CURRENCY_CODE",
                "description": "Currency code (e.g. USD, EUR)",
            },
        ]
    },
)
Response
{
  "success": true,
  "data": {
    "merchant_name": {
      "value": "Whole Foods Market",
      "confidence": 0.98,
      "citations": ["WHOLE FOODS MARKET"]
    },
    "date": {
      "value": "2026-02-18",
      "confidence": 0.97,
      "citations": ["02/18/2026"]
    },
    "items": {
      "value": [
        {
          "name": {
            "value": "Organic Avocados (3pk)",
            "confidence": 0.95,
            "citations": ["Organic Avocados 3pk"]
          },
          "amount": {
            "value": {
              "amount": "5.99",
              "currency": "USD"
            },
            "confidence": 0.97,
            "citations": ["$5.99"]
          }
        },
        {
          "name": {
            "value": "Sourdough Bread",
            "confidence": 0.96,
            "citations": ["Sourdough Bread"]
          },
          "amount": {
            "value": {
              "amount": "4.49",
              "currency": "USD"
            },
            "confidence": 0.98,
            "citations": ["$4.49"]
          }
        }
      ],
      "confidence": 0.96,
      "citations": []
    },
    "total_amount": {
      "value": {
        "amount": "10.48",
        "currency": "USD"
      },
      "confidence": 0.99,
      "citations": ["TOTAL: $10.48"]
    },
    "currency": {
      "value": "USD",
      "confidence": 0.99,
      "citations": ["$"]
    }
  }
}
Request
package main

import il "github.com/iterationlayer/sdk-go"

func main() {
    client := il.NewClient("YOUR_API_KEY")

    result, err := client.ExtractDocument(il.ExtractDocumentRequest{
        Files: []il.FileInput{
            il.FileInput{
                Type: "url",
                Name: "receipt.pdf",
                Url: "https://example.com/receipts/purchase-receipt.pdf",
            },
        },
        Schema: il.ExtractionSchema{
            Fields: []any{
                il.TextFieldConfig{
                    Name: "merchant_name",
                    Type: "TEXT",
                    Description: "Name of the merchant or store",
                },
                il.DateFieldConfig{
                    Name: "date",
                    Type: "DATE",
                    Description: "Date of the transaction",
                },
                il.ArrayFieldConfig{
                    Name: "items",
                    Type: "ARRAY",
                    Description: "Individual line items on the receipt",
                    Fields: []any{
                        il.TextFieldConfig{
                            Name: "name",
                            Type: "TEXT",
                            Description: "Item name or description",
                        },
                        il.CurrencyAmountFieldConfig{
                            Name: "amount",
                            Type: "CURRENCY_AMOUNT",
                            Description: "Item price",
                        },
                    },
                },
                il.CurrencyAmountFieldConfig{
                    Name: "total_amount",
                    Type: "CURRENCY_AMOUNT",
                    Description: "Total amount charged",
                },
                il.CurrencyCodeFieldConfig{
                    Name: "currency",
                    Type: "CURRENCY_CODE",
                    Description: "Currency code (e.g. USD, EUR)",
                },
            },
        },
    })
    if err != nil {
        panic(err)
    }

    _ = result
}
Response
{
  "success": true,
  "data": {
    "merchant_name": {
      "value": "Whole Foods Market",
      "confidence": 0.98,
      "citations": ["WHOLE FOODS MARKET"]
    },
    "date": {
      "value": "2026-02-18",
      "confidence": 0.97,
      "citations": ["02/18/2026"]
    },
    "items": {
      "value": [
        {
          "name": {
            "value": "Organic Avocados (3pk)",
            "confidence": 0.95,
            "citations": ["Organic Avocados 3pk"]
          },
          "amount": {
            "value": {
              "amount": "5.99",
              "currency": "USD"
            },
            "confidence": 0.97,
            "citations": ["$5.99"]
          }
        },
        {
          "name": {
            "value": "Sourdough Bread",
            "confidence": 0.96,
            "citations": ["Sourdough Bread"]
          },
          "amount": {
            "value": {
              "amount": "4.49",
              "currency": "USD"
            },
            "confidence": 0.98,
            "citations": ["$4.49"]
          }
        }
      ],
      "confidence": 0.96,
      "citations": []
    },
    "total_amount": {
      "value": {
        "amount": "10.48",
        "currency": "USD"
      },
      "confidence": 0.99,
      "citations": ["TOTAL: $10.48"]
    },
    "currency": {
      "value": "USD",
      "confidence": 0.99,
      "citations": ["$"]
    }
  }
}
Template
{
  "name": "Extract Receipt Data",
  "nodes": [
    {
      "parameters": {
        "content": "## Extract Receipt Data\n\nFinance teams and expense management apps use this recipe to automate receipt processing. Upload a receipt photo or PDF and receive structured JSON with merchant name, date, individual items, and total \u2014 ready for an expense report or reimbursement workflow.\n\n**Note:** This workflow uses the Iteration Layer community node (`n8n-nodes-iterationlayer`). Install it via Settings > Community Nodes on self-hosted n8n, or add it directly on n8n Cloud with Verified Community Nodes enabled.",
        "height": 280,
        "width": 500,
        "color": 2
      },
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        200,
        40
      ],
      "id": "4bdb62b6-66d8-4616-a7e1-6e8f48477da7",
      "name": "Overview"
    },
    {
      "parameters": {
        "content": "### Step 1: Extract Data\nResource: **Document Extraction**\n\nConfigure the Document Extraction parameters below, then connect your credentials.",
        "height": 160,
        "width": 300,
        "color": 6
      },
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        475,
        100
      ],
      "id": "0c6511af-1417-4e1f-9fbb-73f019a130c3",
      "name": "Step 1 Note"
    },
    {
      "parameters": {},
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        250,
        300
      ],
      "id": "c1d2e3f4-a5b6-7890-cdef-901234567cde",
      "name": "Manual Trigger"
    },
    {
      "parameters": {
        "resource": "documentExtraction",
        "schemaInputMode": "rawJson",
        "schemaJson": "{\"fields\":[{\"name\":\"merchant_name\",\"type\":\"TEXT\",\"description\":\"Name of the merchant or store\"},{\"name\":\"date\",\"type\":\"DATE\",\"description\":\"Date of the transaction\"},{\"name\":\"items\",\"type\":\"ARRAY\",\"description\":\"Individual line items on the receipt\",\"fields\":[{\"name\":\"name\",\"type\":\"TEXT\",\"description\":\"Item name or description\"},{\"name\":\"amount\",\"type\":\"CURRENCY_AMOUNT\",\"description\":\"Item price\"}]},{\"name\":\"total_amount\",\"type\":\"CURRENCY_AMOUNT\",\"description\":\"Total amount charged\"},{\"name\":\"currency\",\"type\":\"CURRENCY_CODE\",\"description\":\"Currency code (e.g. USD, EUR)\"}]}",
        "files": {
          "fileValues": [
            {
              "fileInputMode": "url",
              "fileName": "receipt.pdf",
              "fileUrl": "https://example.com/receipts/purchase-receipt.pdf"
            }
          ]
        }
      },
      "type": "n8n-nodes-iterationlayer.iterationLayer",
      "typeVersion": 1,
      "position": [
        500,
        300
      ],
      "id": "d2e3f4a5-b6c7-8901-defa-012345678def",
      "name": "Extract Data",
      "credentials": {
        "iterationLayerApi": {
          "id": "1",
          "name": "Iteration Layer API"
        }
      }
    }
  ],
  "connections": {
    "Manual Trigger": {
      "main": [
        [
          {
            "node": "Extract Data",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "settings": {
    "executionOrder": "v1"
  }
}
Prompt
Extract receipt data from the file at [file URL]. Use the extract_document tool with these fields:

- merchant_name (TEXT): Name of the merchant or store
- date (DATE): Date of the transaction
- items (ARRAY): Each with name (TEXT) and amount (CURRENCY_AMOUNT)
- total_amount (CURRENCY_AMOUNT): Total amount charged
- currency (CURRENCY_CODE): Currency code

Related Recipes

Extract 1098 Data

Extract structured fields from 1098 documents.

Extract 1099-MISC Data

Extract structured fields from 1099-misc documents.

Extract 1099-NEC Data

Extract structured fields from 1099-nec documents.

Try with your own data

Get a free API key and run this recipe in minutes. No credit card required.

Document Extraction

Document extraction API for structured data extraction. 500 free document extractions included.
Get Your Free API Key