Developers

From document to structured JSON. One endpoint.

Send any receipt, invoice, or PDF. Get back named fields — vendor, amount, date, currency, line items — clean JSON, ready for your database. No OCR pipeline. No template setup. No model training.

20 documents a month free, with full API access. No credit card. Webhooks on Starter and Pro.

GET/api/v1/documents/<id>
{
  "document_type": "invoice",
  "document_number": "31293737",
  "invoice_id": "31293737",
  "receipt_id": null,
  "date": "2020-12-15",
  "due_date": null,
  "currency": "USD",
  "merchant": "Nunez Inc",
  "merchant_address": "6551 Janet Gardens, Michaelberg, KS 90952",
  "merchant_email": null,
  "customer": "Alvarez Inc",
  "subtotal": "371.51",
  "tax": "37.15",
  "tax_rate": "10.00",
  "discount": null,
  "shipping": null,
  "total": "408.66",
  "payment_method": null,
  "notes": null,
  "line_items": [
    {
      "description": "Women's black cocktail dress, size 4",
      "quantity": 3,
      "price": "19.99",
      "line_total": "59.97",
      "vat_rate": "10.00"
    },
    {
      "description": "Christmas Dress Grace Karin Sleeveless Christmas dress Red Black size Large",
      "quantity": 1,
      "price": "9.99",
      "line_total": "9.99",
      "vat_rate": "10.00"
    },
    {
      "description": "Windsor womens black and Pink Bodycon Sleeveless Dress, Womens Size Small",
      "quantity": 1,
      "price": "15.83",
      "line_total": "15.83",
      "vat_rate": "10.00"
    },
    {
      "description": "Lumiere Large Multicolored Orange Short Dress NWT",
      "quantity": 4,
      "price": "4.99",
      "line_total": "19.96",
      "vat_rate": "10.00"
    },
    {
      "description": "Xhilaration Womens L Burgandy Boho Embroidered Festival Mini Dress NEW",
      "quantity": 4,
      "price": "14.95",
      "line_total": "59.80",
      "vat_rate": "10.00"
    },
    {
      "description": "Johnny Was Medium Linen Wrap Dress Dessert Rose Embroiderd Bohemian",
      "quantity": 2,
      "price": "89.99",
      "line_total": "179.98",
      "vat_rate": "10.00"
    },
    {
      "description": "Pre-Owned Women's Nah Nah Dress Size 8 Black Sheer Formal Sexy",
      "quantity": 2,
      "price": "12.99",
      "line_total": "25.98",
      "vat_rate": "10.00"
    }
  ]
}

PDF · JPG · PNG · CSV

Every file format, one endpoint

Multi-currency

MAD · EUR · GBP · USD · AED · CHF · JPY · AUD · SEK and more

AI + rule-based

Rule-based extraction with an AI review of every document

Webhooks included

Starter and Pro plans · no extra setup · fires on every completed extraction

Quickstart

Three steps to structured JSON

  1. 01

    Create a free account

    Generate your API key from the dashboard. 20 documents a month free, with full API access. No credit card. Webhooks on Starter and Pro.

    Try it on your document — no sign-up
  2. 02

    Send a multipart POST request

    Any PDF, JPG, PNG, or CSV, up to 10 pages per document. Your API key goes in the Authorization header. That's the entire setup.

    See request format
  3. 03

    Get named fields back

    The response contains every financial field your application needs — already named, already typed, already clean.

    {
      "document_type": "invoice",
      "document_number": "31293737",
      "invoice_id": "31293737",
      "receipt_id": null,
      "date": "2020-12-15",
      "due_date": null,
      "currency": "USD",
      "merchant": "Nunez Inc",
      "merchant_address": "6551 Janet Gardens, Michaelberg, KS 90952",
      "merchant_email": null,
      "customer": "Alvarez Inc",
      "line_items": [...]
    }

    Full schema at /docs — 20+ named fields.

    View full response schema

Code examples

One request. Structured JSON back.

Works with any HTTP client.

# 1. Submit the document
curl -X POST https://docuparseapi.com/api/v1/extract \
  -H "Authorization: Bearer $DOCUPARSE_API_KEY" \
  -F "file=@invoice.pdf"
# → {"success": true, "document_id": "<id>", "status": "queued"}

# 2. Fetch the result (repeat until "status" is "completed" or "failed")
curl https://docuparseapi.com/api/v1/documents/<id> \
  -H "Authorization: Bearer $DOCUPARSE_API_KEY"
{
  "success": true,
  "document_id": "<id>",
  "status": "completed",
  "data": {
    "document_type": "invoice",
    "document_number": "31293737",
    "invoice_id": "31293737",
    "receipt_id": null,
    "date": "2020-12-15",
    "due_date": null,
    "currency": "USD",
    "merchant": "Nunez Inc",
    "merchant_address": "6551 Janet Gardens, Michaelberg, KS 90952",
    "merchant_email": null,
    "customer": "Alvarez Inc",
    "subtotal": "371.51",
    "tax": "37.15",
    "tax_rate": "10.00",
    "discount": null,
    "shipping": null,
    "total": "408.66",
    "payment_method": null,
    "notes": null,
    "line_items": [
      {
        "description": "Women's black cocktail dress, size 4",
        "quantity": 3,
        "price": "19.99",
        "line_total": "59.97",
        "vat_rate": "10.00"
      },
      {
        "description": "Christmas Dress Grace Karin Sleeveless Christmas dress Red Black size Large",
        "quantity": 1,
        "price": "9.99",
        "line_total": "9.99",
        "vat_rate": "10.00"
      },
      {
        "description": "Windsor womens black and Pink Bodycon Sleeveless Dress, Womens Size Small",
        "quantity": 1,
        "price": "15.83",
        "line_total": "15.83",
        "vat_rate": "10.00"
      },
      {
        "description": "Lumiere Large Multicolored Orange Short Dress NWT",
        "quantity": 4,
        "price": "4.99",
        "line_total": "19.96",
        "vat_rate": "10.00"
      },
      {
        "description": "Xhilaration Womens L Burgandy Boho Embroidered Festival Mini Dress NEW",
        "quantity": 4,
        "price": "14.95",
        "line_total": "59.80",
        "vat_rate": "10.00"
      },
      {
        "description": "Johnny Was Medium Linen Wrap Dress Dessert Rose Embroiderd Bohemian",
        "quantity": 2,
        "price": "89.99",
        "line_total": "179.98",
        "vat_rate": "10.00"
      },
      {
        "description": "Pre-Owned Women's Nah Nah Dress Size 8 Black Sheer Formal Sexy",
        "quantity": 2,
        "price": "12.99",
        "line_total": "25.98",
        "vat_rate": "10.00"
      }
    ]
  }
}

Ready to test it with a real document?

20 documents a month free, with full API access. No credit card. Webhooks on Starter and Pro.

Sign up — get a free API key

Start extracting. It's free.

20 documents a month free, with full API access. No credit card. Webhooks on Starter and Pro. No commitment. No setup fee.

Starter is $11.99/month for 1,000 documents when you need more volume.

Webhook payload (Starter and Pro plans) — fires on every completed extraction

{
  "event": "document.completed",
  "document_id": "e104e0a3-a575-...",
  "status": "completed",
  "document_type": "receipt",
  "data": { ... },
  "created_at": "2026-05-12T15:40:25Z"
}