SoonOne MCP server, all 40 APIs as agent tools. See how it works

AI-powered invoice processing and financial data extraction

Invoice Parser API

A powerful API for parsing invoices using AI models. This API extracts structured information from invoice documents in PDF and image formats (JPEG, JPG, PNG).

Built on edge computing with AI models, our API provides reliable and efficient invoice parsing capabilities with single-call processing for both OCR and structured data extraction.

Free tier included, no credit card required. One key works across all 40 APIs.

At a glance
Data Fields
40+
File Formats
4
Accuracy Rate
96.7%

Key features

  • Upload invoice files directly (PDF, JPEG, JPG, PNG)
  • Parse invoices from URLs or text input
  • PDF text extraction using advanced OCR technology
  • Direct image processing using AI models
  • Single API call processing for maximum efficiency
  • Multi-currency and multi-language support

Built for

  • Accounts payable automation
  • Expense management systems
  • Financial document processing
  • Accounting software integration
  • Invoice verification workflows
  • Tax compliance and reporting
  • Vendor management systems
  • Audit trail automation

Try it

Build the request for your data

Edit the parameters below and see the exact curl command and JSON response you will get. No key required to preview.

POST/v1/invoice/upload
Open in Playground
Request · HTTP
POST /parser/v1/invoice/upload HTTP/1.1
Host: api.apicodex.io
Host: api.apicodex.io
X-Api-Key: YOUR_API_KEY
Content-Type: multipart/form-data
Response · JSON
200 OK
{
"success": true,
"parsed_at": "2025-05-13T08:15:32.000Z",
"data": {
  "vendor": {
    "name": "ACME SUPPLIES LTD",
    "address": "456 Business Ave, Suite 100, Industry City, NY 10001",
    "phone": "(555) 987-6543",
    "email": "billing@acmesupplies.example",
    "website": "www.acmesupplies.example",
    "tax_id": "US123456789",
    "registration_number": "BRN-987654321"
  },
  "customer": {
    "name": "GLOBAL ENTERPRISES INC",
    "address": "789 Corporate Park, Downtown, CA 90210",
    "shipping_address": "789 Corporate Park, Warehouse 3, Downtown, CA 90210",
    "attention": "John Smith",
    "phone": "(555) 123-4567",
    "email": "accounts@globalenterprises.example",
    "customer_id": "CUST-1234",
    "tax_id": "CA987654321"
  },
  "invoice_details": {
    "invoice_number": "INV-2025-0042",
    "purchase_order": "PO-2025-1234",
    "issue_date": "2025-05-01",
    "due_date": "2025-05-31",
    "payment_terms": "Net 30",
    "currency": "USD",
    "language": "en-US"
  },
  "line_items": [
    {
      "description": "Premium Office Desk Chair",
      "product_code": "FRN-CH-001",
      "quantity": 5,
      "unit_of_measure": "pcs",
      "unit_price": 199.99,
      "discount": 10,
      "tax_rate": 8.25,
      "tax_amount": 74.99,
      "total_amount": 899.96
    }
  ],
  "totals": {
    "subtotal": 2199.85,
    "discount_total": 100.00,
    "tax_total": 173.98,
    "shipping_cost": 75.00,
    "total_amount": 2348.83,
    "amount_paid": 500.00,
    "amount_due": 1848.83
  },
  "tax_breakdown": [
    {
      "tax_type": "Sales Tax",
      "tax_rate": 8.25,
      "taxable_amount": 2099.85,
      "tax_amount": 173.98
    }
  ],
  "payment_information": {
    "payment_method": "Bank Transfer",
    "bank_name": "First National Bank",
    "account_number": "ACCT-12345678",
    "routing_number": "RTG-987654321",
    "swift_code": "FNBKUS12",
    "iban": null
  }
}
}

Documentation

Invoice Parser API Documentation

The Invoice Parser API provides comprehensive parsing and extraction of invoice data from various document formats. This documentation outlines how to effectively integrate and utilize the API for processing invoice documents, extracting financial data, and automating accounting workflows.

Base URL

url
https://api.apicodex.io/parser

Authentication

Authenticate every request with your API key: send it in an X-Api-Key header, or pass it as an ?apikey= query parameter.

headers
{
"X-Api-Key": "YOUR_API_KEY"
}

Request and response

Illustrative values. Confirm current endpoint behavior, quotas, and data freshness in the API documentation before production use.

request · http
POST /v1/invoice/upload HTTP/1.1
Host: api.apicodex.io
X-Api-Key: YOUR_API_KEY
Content-Type: multipart/form-data

[file upload]
response · json
{
"success": true,
"parsed_at": "2025-05-13T08:15:32.000Z",
"data": {
  "vendor": {
    "name": "ACME SUPPLIES LTD",
    "address": "456 Business Ave, Suite 100, Industry City, NY 10001",
    "phone": "(555) 987-6543",
    "email": "billing@acmesupplies.example",
    "website": "www.acmesupplies.example",
    "tax_id": "US123456789",
    "registration_number": "BRN-987654321"
  },
  "customer": {
    "name": "GLOBAL ENTERPRISES INC",
    "address": "789 Corporate Park, Downtown, CA 90210",
    "shipping_address": "789 Corporate Park, Warehouse 3, Downtown, CA 90210",
    "attention": "John Smith",
    "phone": "(555) 123-4567",
    "email": "accounts@globalenterprises.example",
    "customer_id": "CUST-1234",
    "tax_id": "CA987654321"
  },
  "invoice_details": {
    "invoice_number": "INV-2025-0042",
    "purchase_order": "PO-2025-1234",
    "issue_date": "2025-05-01",
    "due_date": "2025-05-31",
    "payment_terms": "Net 30",
    "currency": "USD",
    "language": "en-US"
  },
  "line_items": [
    {
      "description": "Premium Office Desk Chair",
      "product_code": "FRN-CH-001",
      "quantity": 5,
      "unit_of_measure": "pcs",
      "unit_price": 199.99,
      "discount": 10,
      "tax_rate": 8.25,
      "tax_amount": 74.99,
      "total_amount": 899.96
    }
  ],
  "totals": {
    "subtotal": 2199.85,
    "discount_total": 100.00,
    "tax_total": 173.98,
    "shipping_cost": 75.00,
    "total_amount": 2348.83,
    "amount_paid": 500.00,
    "amount_due": 1848.83
  },
  "tax_breakdown": [
    {
      "tax_type": "Sales Tax",
      "tax_rate": 8.25,
      "taxable_amount": 2099.85,
      "tax_amount": 173.98
    }
  ],
  "payment_information": {
    "payment_method": "Bank Transfer",
    "bank_name": "First National Bank",
    "account_number": "ACCT-12345678",
    "routing_number": "RTG-987654321",
    "swift_code": "FNBKUS12",
    "iban": null
  }
}
}

Code examples

cURL
curl -X POST "/v1/invoice/upload" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -F "file=@invoice.pdf"

Pricing

Invoice Parser API Pricing

One key, one subscription, all 40 APIs. Start free and upgrade when you grow. No minimums, no lock-in.

This API costs 25 credits per request. Credits are shared across every API on your plan.

Estimate your monthly cost

Drag the slider to match your expected request volume. We will recommend the cheapest plan that covers it.

10,000

Recommended plan

Pro

$99.99 /month

Credits used250,000
Credits included250,000
Cost per 1K requests$9.999
Choose Pro

Free

Free
1,000 credits · ~40 requests/mo · 2 rps
  • All 40 APIs included
  • No credit card required
  • Full documentation and examples
Start for free

Starter

Popular
$29.99/month
50,000 credits · ~2,000 requests/mo · 10 rps
  • All 40 APIs included
  • Email support
  • Usage dashboard and analytics
Start with Starter

Pro

$99.99/month
250,000 credits · ~10,000 requests/mo · 25 rps
  • All 40 APIs included
  • Priority support
  • Up to 5 API keys
Start with Pro

Need a different plan?

Tell us about your API, volume, or support requirements.

Contact us

Coming soon · MCP

Use the Invoice Parser API from your AI agent

The API Codex MCP server will expose this API, and the other 39, to Claude, Cursor and any MCP client as tools. Same key, same credits, one config entry.

About the MCP server

FAQ

Frequently asked questions

The Invoice Parser API supports PDF, JPEG, JPG, and PNG file formats for invoice processing. You can upload these file types directly via multipart form data or provide a publicly accessible URL to the invoice document. The API automatically detects the input format and applies the appropriate processing pipeline, using OCR for image-based invoices and text extraction for native PDF documents. This flexibility means you can integrate the API into diverse workflows whether your invoices arrive as scanned images, digital PDFs, or photographed documents from mobile devices.

The API extracts over 40 distinct data fields organized into structured categories. Vendor details include company name, address, phone, email, website, tax ID, and registration number. Customer information captures name, billing and shipping addresses, attention lines, and customer IDs. Invoice metadata covers invoice number, purchase order, issue date, due date, payment terms, and currency. Each line item is parsed with description, product code, quantity, unit price, discount, tax rate, and total amount. The API also returns comprehensive totals including subtotal, discounts, tax breakdowns by type, shipping costs, and amounts paid versus outstanding.

Our API achieves an accuracy rate of approximately 96.7% across diverse invoice formats and layouts. The system leverages advanced AI vision models that have been trained on millions of invoice documents spanning different industries, countries, and design templates. Accuracy depends on document quality factors such as resolution, contrast, and clarity of text. For scanned documents, we recommend a minimum resolution of 300 DPI with good lighting and minimal skew. The AI handles complex layouts including multi-column invoices, tables with merged cells, and invoices with logos or watermarks that might interfere with traditional OCR approaches.

Yes, the maximum file size for uploads is 1MB per request, which accommodates the vast majority of invoice documents. Standard PDF invoices typically range from 50KB to 500KB, and compressed JPEG images of invoices usually fall well under this limit. For image files, we recommend optimizing resolution to 300 DPI at the actual document size, which provides excellent OCR accuracy while keeping file sizes manageable. If you regularly process larger files such as multi-page invoice bundles, consider splitting them into individual pages before submission or contact our support team to discuss enterprise solutions with higher file size limits.

The API automatically detects and processes currency formats from around the world, including USD, EUR, GBP, JPY, and dozens of other currencies. It recognizes various number formatting conventions such as comma-separated thousands with decimal points or period-separated thousands with decimal commas used in European countries. Tax structures are parsed intelligently, identifying VAT, GST, sales tax, and other regional tax types with their respective rates and amounts. The tax breakdown section of the response provides granular detail including taxable amounts, tax rates, and calculated tax for each applicable tax type, enabling accurate financial reconciliation across international invoices.

Yes, the Invoice Parser API supports invoices written in a wide range of languages thanks to its AI-powered vision model architecture. The system can accurately extract data from invoices in English, Spanish, French, German, Portuguese, Italian, Dutch, and many other languages without requiring you to specify the language in advance. The AI model automatically identifies the document language and applies appropriate parsing rules for date formats, number conventions, and field labels specific to that locale. This makes the API ideal for international businesses processing invoices from vendors and suppliers across different countries and language regions.

The Invoice Parser API is specifically designed to handle multi-page invoices, which are common for large orders with many line items or detailed terms and conditions. When you upload a multi-page PDF, the API processes all pages sequentially, using context from earlier pages to inform parsing of later pages. The AI model understands that line items often span multiple pages, with headers repeated on each page, and intelligently combines data across pages into a single coherent output. For example, if page 1 contains vendor information and the first 20 line items, and page 2 continues with 15 more line items plus the total, the API will extract all 35 line items and associate them with the same invoice. The invoice number, dates, and vendor details are extracted from wherever they appear (typically page 1), while totals are found on the final page. Table continuation across pages is handled automatically — the parser recognizes when a table header is repeated and continues aggregating rows. For very long invoices (10+ pages), processing time increases linearly with page count, but the API maintains accuracy throughout. The response indicates which page each piece of information was extracted from, which is valuable for auditing and verification purposes. Multi-page invoices are particularly common in industries like wholesale, construction, and professional services where itemized billing is detailed.