Customs Declaration OCR
4.8/5
(30+ reviews)
Customs declaration OCR API that reads every item, HS code to duty
Turn import and export declarations, entry summaries and broker PDFs into structured JSON. MRN, parties, HS codes, customs values and duties, each with a confidence score.
No credit card required
SOC 2 Type II & GDPR

Trusted by finance and product teams at




Why customs paperwork slows every shipment
Brokers send declarations as PDFs in every country's format. Trade and finance teams retype MRNs, HS codes and duties to reconcile landed costs, reclaim VAT and prepare for audits.
Entry filed
Broker sends the declaration as a PDF.
Manual keying
MRN, HS codes and duties typed in.
Friction
Long codes invite transposed digits.
Duty check
Duties compared with the landed cost.
Friction
Overpaid duties are never claimed back.
Audit filing
Declarations stored for customs audits.
Friction
Missing records stall VAT reclaims.
Shipment closed
Finally reconciled, one entry at a time.
Every customs declaration field you need, as structured JSON
Hover a group to see where it lands in the response. Every value comes back typed, normalised and located on the page, in the schema you defined.
See fields list
Declaration
declaration_number, declaration_type, declaration_date, procedure_code
Parties
exporter_name, importer_name, importer_eori, declarant_name
Goods items
items[].hs_code, description, country_of_origin, customs_value, duty_amount
Transport
transport_mode, incoterms, customs_office
Duties & taxes
total_customs_value, total_duties, total_vat, currency
References
transport_document_number, invoice_number
{
"declaration_number": { "value": "26NL4F7K2D9R1X8P3L" }, "declaration_type": { "value": "IM A" }, "procedure_code": { "value": "4000" },
"importer_name": { "value": "Brightwell Interiors GmbH" }, "importer_eori": { "value": "DE4471092583000" }, "declarant_name": { "value": "Kestrel Customs Brokers" },
"items": [ { "hs_code": { "value": "6302210000" }, "customs_value": { "value": 38400.00 }, "duty_amount": { "value": 4608.00 } }, … ],
"transport_mode": { "value": "sea" }, "incoterms": { "value": "FOB Ningbo" }, "customs_office": { "value": "Rotterdam Haven" },
"total_customs_value": { "value": 47600.00 }, "total_duties": { "value": 4948.40 }, "total_vat": { "value": 11035.16 },
"transport_document_number": { "value": "NOLC2457819" }, "invoice_number": { "value": "LHT-CI-26-0418" },
}
Ready to post, not just to read.
Fields come from a data schema you define in minutes. Dates come back in ISO 8601, values and duties as numbers, each field with a confidence score.
Built for real declarations, not blank forms
Dense EU declarations, US entry summaries, broker cover sheets, goods tables that run over several pages. The model reads every item box and flags what it is unsure of.

Any country, any declaration form
EU import declarations, US entry summaries and UK forms all look different. They come back in one schema you define, with no template per country.

Every goods item, with its HS code
HS code, description, origin, customs value and duty come back for every goods item, even on declarations with dozens of items.

Duties reconciled with your costs
Customs values and duties come back as numbers, so you can reconcile them with the commercial invoice and your broker's bill in code.

Broker packs split by document
Brokers often return the declaration, invoice and B/L in one PDF. Mindee splits the file and classifies each document, so each one reaches the right model.
PDF / JPEG / PNG / WEBP / TIFF / HEIC, Import & export declarations, Multi-item goods tables, +50 languages / any currency, Broker PDFs & scans
Customs declaration OCR accuracy, field by field
Every field comes with a confidence score, so clean declarations are reconciled automatically and unclear items go to a reviewer. Test it on your own declarations in the free trial.
94.6%
Field-level accuracy on header fields
MRN, parties, dates
99.7%
Accuracy on goods items
HS code, value, duty
1.6s
Median time per declaration
Single page, synchronous call
A confidence score on every field
Send only real exceptions to a human

Document AI features, better than OCR
Prepare, classify and extract. Mindee delivers high-accuracy extraction for every document format, so you can automate workflows with speed and high reliability.
Data extractor
Classifier
Splitter
Edge detector
Pull the exact fields you need from any document
Pick a ready-made model or describe your own data schema. Every value comes back typed, normalised, located on the page and scored.
- Prebuilt models or your own custom schema
- Tables and line items, across pages
Know what each document is before you read it
The classifier labels every upload with your own classes, so an ID card goes to onboarding and an invoice goes to accounts payable.
- Your own document classes
- Route each type to the right model
One scanned batch in, separate documents out
Send a long PDF from the office scanner. Mindee finds where each document starts and ends, and returns them one by one.
- Page ranges for every detected document
- Up to 200 pages and 100 MB per file
Several documents on one photo? Each gets its own crop
Users photograph three receipts on a desk, or both sides of an ID. Mindee detects each border, returns its coordinates and reads them separately.
- Coordinates for every detected document
- Built for mobile capture flows
Prototype in minutes, go live with the API
Step 1 : Prototype
Run a proof of concept in Make, Zapier or n8n
No code, no IT ticket. Point a mailbox at Mindee and watch the data arrive in a spreadsheet.
Declaration received
Broker email or customs portal
Mindee reads the entry
MRN, HS codes, duties
Landed cost updated
Your ERP, TMS or Sheets
Low-confidence fields sent for review
Slack or email alert to your team
Step 2 : Production
Integrate the API into your platform
Official SDKs, typed responses and webhooks for async processing. Most teams ship the integration in a day.
mindee docs
$ pip install mindee
Your app
Mindee API
Your ERP/CRM
.webp)
Integrate Mindee into your workflow in minutes with SDKs & no-code tools
Go live in minutes using our verified Zapier & Make.com app with zero coding, or integrate seamlessly via our well-documented REST API built for developers. SDKs available for Python, .NET, Node.JS, Java, Ruby, PHP.
Integrations

Enterprise-grade security
Our API has a SOC 2 Type II certified infrastructure and is GDPR Compliant to ensure your file information remains protected at all times.
EU or US hosting available
GDPR, CCPA Compliant
Learn more
What teams build with customs declaration OCR
The same API powers very different products. Here is where it usually starts.

Logistics
Customs clearance
Capture shipping and customs data across every document of a shipment.

Finance & Accounting
Accounts payable
Extract, match and post supplier invoices without manual data entry.
Rated 4.8/5 by developers and operations teams
4.8
4.9
Mindee is a software that helps us to convert all of our physical business data like bills, invoices, warranty cards, calendar, recipts received to us into a digital documents that can be stored in our drive and can be uploaded in different type of Excel sheets so that all the updates can be maintained and a proper analytics of transactions can be kept by the financial team
Mindee is a software that helps us to convert all of our physical business data like bills, invoices, warranty cards, calendar, recipts received to us into a digital documents that can be stored in our drive and can be uploaded in different type of Excel sheets so that all the updates can be maintained and a proper analytics of transactions can be kept by the financial team
Mindee is a web based tool that help us in scanning and reading different type of documents like identity cards, invoices, proposal plans etc and extract all the information with its AI and then it provides all the information and data associated with these documents a structured way.
Excellent. In addition to their great product, the sales team has always been proactive on how they could help us leverage the maximum results from their product. It was like having an additional product manager on our side
Documents related that Mindee reads
FAQ about Mindee's Customs Declaration OCR API
Can't find what you're looking for? Our team answers within one business day.
What is a customs declaration?
A customs declaration is the official statement filed with customs authorities to declare goods being imported or exported. It is submitted by the importer, the exporter or a customs broker on their behalf, and it includes the parties involved, the description and HS code of each item, the quantities, the customs value, the country of origin, the customs procedure and the duties and taxes due. Depending on the country, it is filed electronically or on official forms, such as the Single Administrative Document in the EU or CBP Form 7501 in the US. Mindee extracts the data from customs declarations and returns it as structured JSON, ready for your ERP, compliance or accounting systems.
What’s the difference between an import and an export declaration?
An import declaration is filed when goods enter a country: it determines the duties and taxes to pay and allows the goods to be released. An export declaration is filed by the exporter, or their representative, before the goods leave the country. It records the shipment for customs control and trade statistics, and serves as proof of export, which is often needed to apply zero-rated VAT. When a shipment’s tracking shows “export customs declaration completed”, it means the goods have been cleared for export. Mindee processes both types of declarations and identifies which one it is.
What are CBP Forms 7501 and 3461 and the ISF?
These are key US import documents filed with Customs and Border Protection (CBP). The Importer Security Filing (ISF, or “10+2”) must be submitted for ocean shipments before the goods are loaded on the vessel. CBP Form 3461 is used to request the release of goods at the port. CBP Form 7501, the Entry Summary, details the classification, value, duties and fees for each item, and is the main record of what the importer declared and paid. Mindee extracts the data from these forms, including line-level classification and duty details, so importers and brokers can use it without manual data entry.
Why extract data from customs declarations after clearance?
Customs declarations contain the duties, taxes and classifications you actually paid, and this data is valuable long after the goods are released. Importers use it to calculate the landed cost of products, reconcile duties and import VAT with their broker’s invoices, recover import VAT, claim duty refunds or drawback, and prepare for customs audits. Since declarations often come from several brokers in different formats, this data is usually scattered across PDFs. Mindee turns each declaration into structured data, so finance and compliance teams can analyze all their imports in one place.
About Mindee
Is my data secured and protected during the conversion process?
Yes, your data is highly secured and protected during the entire conversion process. As an enterprise-grade OCR solution, Mindee takes data privacy very seriously. Here are the key security measures in place:
- Certified compliance: Mindee's infrastructure is SOC 2 Type II certified and fully GDPR compliant, ensuring strict industry standards for data protection.
- Encryption: All documents and extracted data are fully encrypted both in transit (during the API call) and at rest.
- Data localization: You have control over where your data is processed, with the option to host and process your data on either EU or US servers.
- Strict privacy: Mindee respects data confidentiality. Your processed documents are not shared with third parties, and your private data is not used to train global AI models.
In short, your sensitive documents are processed in a secure, isolated environment and remain completely under your control.
Is Mindee's OCR API free to use?
We provide a 14 days free trial so you can fully test any of our OCR models — no credit card required. After this, we offer different pricing tiers depending of the volume of pages processed and the features you might need. See the pricing page for more information.
What file formats are supported for JSON conversion?
The supported document formats are:
- PDF (
application/pdf) – While technically a document format rather than an image, it is natively supported for all extraction models. - JPEG / JPG (
image/jpeg) - PNG (
image/png) – Must be non-animated. - WebP (
image/webp) - TIFF / TIF (
image/tiff) – Both single-page and multi-page TIFFs are supported and processed similarly to PDFs. - HEIC (
image/heic) – Apple's High-Efficiency Image Container format.
📌 Important technical limitations to keep in mind:
To ensure the OCR pipeline runs smoothly and successfully returns your JSON, make sure your files adhere to the following constraints:
- Maximum file size: 100 MB per file.
- Maximum page count: Up to 200 pages per document.
- File state: The files cannot be encrypted, and PDFs must not be password-protected.
Ready to stop keying customs declarations?
Build your customs declaration model from a sample in minutes and send your first entry to the API, with a team of document processing engineers behind it.
14-day free trial
No credit card required