ADP Global Invoice Extraction · Free API

A limited-time free skill launched by the Laiye ADP team. It accurately identifies and extracts information from invoices and receipts in over 100 global languages, compatible with various international formats. No registration or login is required. Leveraging ADP's advanced large language model and visual understanding technology, it is well-suited for personal trials and daily small-batch document processing.

ADP Global Invoice Extraction Free Skill

Powered by the Laiye ADP Team (Agentic Document Processing), this skill enables intelligent, high-precision parsing and data extraction for invoices, bills and vouchers across the globe, whether standard or unstructured. It works seamlessly with electronic PDFs, scanned files and images, and returns standardized structured JSON data to facilitate business workflow integration and downstream automation.

📄 Quick Start Guide

Step 1: Select Base URL

We offer dedicated public cloud access endpoints for domestic and international users, with separate regional configurations. Connecting to the nearest node ensures fast and stable network calls. No account registration or API Key is required — you may send requests directly to the endpoints listed below.

Environment	API Endpoint
Global	https://adp-global.laiye.com/public/v1/invoice-fast/extract
China	https://adp.laiye.com/public/v1/invoice-fast/extract

Step 2: Send Request

Choose one file transfer method and send a POST request:

Method 1: File URL

bash

curl -X POST "https://adp-global.laiye.com/public/v1/invoice-fast/extract" \
  -H "Content-Type: application/json" \
  -d '{
    "file_url": "shturl.cc/vZd6rD9NxsmfNZPF5KjsnB78s"
  }'

Method 2: Base64 Encoded File Content

bash

curl -X POST "https://adp-global.laiye.com/public/v1/invoice-fast/extract" \
  -H "Content-Type: application/json" \
  -d '{
    "file_base64": "<base64-encoded-file-content>"
  }'

Request Example in Python:

python

import base64, requests

with open("invoice.pdf", "rb") as f:
    b64 = base64.b64encode(f.read()).decode()

response = requests.post(
    "https://adp-global.laiye.com/public/v1/invoice-fast/extract",
    json={"file_base64": b64},
    timeout=180,
)
print(response.json())

Step 3: Result Example

Field	Type	Description
success	boolean	Request status
doc_type	string	Identified document type: invoice or receipt
extraction_result	array	List of extracted fields and values
aigc	object	Metadata about the AIGC processing, including labels, producer info, and processing types
upgrade_message	string	Message prompting users to register for enhanced features
signup_url	string	URL for user registration to unlock full features

json

{
    "success": true,
    "doc_type": "invoice",
    "extraction_result": [
        {
            "field_key": "invoice_number",
            "field_name": "Invoice Number",
            "field_values": [
                {
                    "field_value": "09071666",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "09071666"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "invoice_date",
            "field_name": "Invoice Date",
            "field_values": [
                {
                    "field_value": "2019-11-28",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "2019-11-28"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "supplier_name",
            "field_name": "Supplier Name",
            "field_values": [
                {
                    "field_value": "Beijing******Company",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "Beijing******Company"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "supplier_vat_number",
            "field_name": "Supplier VAT Number",
            "field_values": [
                {
                    "field_value": "9111******4393T",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "9111******4393T"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "customer_name",
            "field_name": "Customer Name",
            "field_values": [
                {
                    "field_value": "Hunan******Company",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "Hunan******Company"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "currency",
            "field_name": "Currency",
            "field_values": [
                {
                    "field_value": "CNY",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "CNY"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "total_amount",
            "field_name": "Total Amount (Tax Included)",
            "field_values": [
                {
                    "field_value": "¥1600.00",
                    "field_confidence": 0.0,
                    "references": [
                        {
                            "search_text": "¥1600.00"
                        }
                    ]
                }
            ]
        },
        {
            "field_key": "line_items",
            "field_name": "Line Items",
            "table_values": [
                [
                    {
                        "field_key": "line_items_item_code",
                        "field_name": "Item Code",
                        "field_values": [
                            {
                                "field_value": "",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": ""
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "field_key": "line_items_description",
                        "field_name": "Description",
                        "field_values": [
                            {
                                "field_value": "Accommodation Service*Accommodation Service",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": "*Accommodation Service*Accommodation Service"
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "field_key": "line_items_quantity",
                        "field_name": "Quantity",
                        "field_values": [
                            {
                                "field_value": "2",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": "2"
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "field_key": "line_items_unit_price",
                        "field_name": "Unit Price",
                        "field_values": [
                            {
                                "field_value": "754.716981132",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": "754.716981132"
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "field_key": "line_items_total_amount",
                        "field_name": "Total Amount",
                        "field_values": [
                            {
                                "field_value": "1509.43",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": "1509.43"
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "field_key": "line_items_rate",
                        "field_name": "tax rate",
                        "field_values": [
                            {
                                "field_value": "6%",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": "6%"
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "field_key": "line_items_tax",
                        "field_name": "tax",
                        "field_values": [
                            {
                                "field_value": "90.57",
                                "field_confidence": 0.0,
                                "references": [
                                    {
                                        "search_text": "90.57"
                                    }
                                ]
                            }
                        ]
                    }
                ]
            ]
        }
    ],
    "aigc": {
        "Label": "AIGCLabelType.AI_GENERATED",
        "ContentProducer": "001191110108587659081E10001",
        "ProduceID": "e3563f165b4011f19f02d85ed35661fd",
        "ReservedCode1": "34c55657beb0071fecf8abce14b0cdee",
        "ContentPropagator": "001191110108587659081E10001",
        "PropagateID": "e3563f165b4011f19f02d85ed35661fd",
        "ReservedCode2": "34c55657beb0071fecf8abce14b0cdee",
        "ProcessingTypes": [
            "ocr",
            "llm_extract"
        ]
    },
    "upgrade_message": "Sign up to get 100 credits per month and unlock all features, including multi-tier tax calculation, self-evolving recognition capabilities, expanded fields and enhanced performance.",
    "signup_url": "https://adp.laiye.com/"
}

📄 Extraction Field Reference

Text Fields

field_key	field_name (example)	Description
invoice_number	Invoice Number	Unique identifier of the invoice.
invoice_date	Invoice Date	Date when the invoice was issued.
supplier_name	Supplier Name	Name of the issuing supplier.
supplier_vat_number	Supplier VAT Number	VAT registration number of the supplier.
customer_name	Customer Name	Name of the billed customer.
currency	Currency	Currency code of the invoice (e.g., USD, EUR).
total_amount_inc_tax	Total Amount (Inc. Tax)	Total invoice amount including tax.

Table Fields

field_key	field_name (example)	Description
item_code	Item Code	Code/SKU of the line item.
description	Description	Description of the line item.
quantity	Quantity	Quantity of the line item.
unit_price	Unit Price	Unit price of the line item.
total_amount	Total Amount	Total amount of the line item.
tax_rate	Tax Rate	Applicable tax rate for the item (full coverage).
tax_amount	Tax Amount	Tax amount for the line item (full coverage).

Common Field Structure

Field	Type	Description
field_key	string	Field identifier
field_name	string	Field name
field_values	array	List of extracted values (supports multiple values)
field_values[].field_confidence	float	Confidence score (0.0 - 1.0)
field_values[].references	array	List of reference points in the document (e.g., bounding boxes, page numbers)
line_items_item_code	string	Code/SKU of the line item
line_items_description	string	Description of the line item
line_items_quantity	string	Quantity of the line item
line_items_unit_price	string	Unit price of the line item
line_items_total_amount	string	Total amount of the line item
line_items_tax_rate	string	Tax rate for the line item
line_items_tax	string	Tax amount for the line item

How to distinguish field types: If table_values is present → table field, read from table_values; otherwise → regular field, read from field_values.

⚠️ Usage Limits

Item	Requirement / Limit
File Size	Less than 2 MB
Page Count	Single page only. Multi-page PDF files will be rejected
Supported Formats	jpeg, .jpg, .png, .bmp, .tiff, .pdf, .doc, .docx, .xlsx, .ofd
URL Accessibility	Publicly accessible HTTP/HTTPS URL. Private network or internal IP addresses are not supported
Per IP per minute	30 requests (within any consecutive 60 seconds)
Per IP per day	30 requests
Global daily pool	5,000 requests

When the limit is exceeded, the API returns HTTP 429 with registration guidance included in the response.

json

{
  "code": "rate_limited_day",
  "message": "Daily free usage limit has been used up. Please come back tomorrow.",
  "upgrade_message": "Sign up for 100 monthly free credits, more fields, higher performance, multi-tax support & self-optimization",
  "signup_url": "https://adp-global.laiye.com/?utm_source=promotions-clawhub"
}

❌ Error Codes

HTTP Status Code	code	Description
400	invalid_input	No file provided, or both file_base64 and file_url are passed simultaneously
400	invalid_base64	The content of file_base64 is not valid Base64 encoding
400	invalid_url	Invalid file_url format (not HTTP/HTTPS)
400	ssrf_blocked	file_url points to an internal network or private IP address
400	download_failed	Failed to download file from file_url
400	file_too_large	File size exceeds 2 MB
400	multi_page	Multi-page PDF detected. Only single-page files are supported
400	unsupported_format	Unsupported file format
429	rate_limited_minute	Exceeded per-IP minute limit (30 requests within 60 seconds)
429	rate_limited_day	Exceeded per-IP daily limit (30 requests)
429	rate_limited_global	Exceeded global daily limit (5,000 requests)
500	extraction_failed	Server processing failed. Please try again later

🚀 Advanced Usage

This API uses the fixed invoice-fast (high-speed) model with preset field configurations, designed exclusively for a quick experience.

Upgrade to the full ADP account to unlock these premium capabilities:

• Invoice file size exceeds 2MB
• Higher API call frequency & unlimited request quotas
• Custom extraction fields (add or remove fields as needed)
• Asynchronous batch processing
• Human-in-the-loop (HITL) review workflow
• Webhook callback support
• Support for more document types (purchase orders, ID cards, domestic invoices, etc.)
• MCP tool integration for AI clients (Claude Desktop, Cursor, etc.)

New users will receive 100 free credits upon registration to experience all full-function features.We provide independent Public Cloud access addresses fr domestic and international users, which need to be configured separately by region. Accessing from a nearby location can better ensure high-speed and stable invocation across the network.

• Users in Chinese Mainland Log in
• Users outside Chinese Mainland Log in

🛠️ Support & Contact

• CLI User Guide: ADP CLI User Guide
• API Documentation: Open API User Guide
• ADP Product Manual: Public Cloud Manual
• Issue Tracker: GitHub Issues
• Email: [e-mail]
• Website: Laiye ADP

Copyright 2026 [Laiye Technology (Beijing) Co., Ltd.] All rights reserved.