Bill of Lading OCR API
4.8/5
(30+ reviews)
Bill of lading OCR API that reads every B/L, from any carrier
Turn ocean and truck bills of lading, PDF, scan or phone photo, into structured JSON. Shipper, consignee, ports, dates and every cargo line with weight and measurement, each with a confidence score.
No credit card required
SOC 2 Type II & GDPR

Trusted by finance and product teams at




Why bills of lading slow down every shipment
Each carrier and forwarder issues its own B/L layout, often scanned and stamped. Ops teams retype parties, ports and cargo lines into the TMS, then check them against the packing list and invoice.
B/L received
Carrier sends the B/L by email or portal.
Manual keying
Parties, ports and cargo typed into the TMS.
Friction
Long reference numbers and stamps invite typos.
Cross-check
Packages and weights matched with the packing list.
Friction
Mismatches surface at customs, not before.
Customs filing
Same data keyed again for the customs entry.
Friction
One wrong weight can hold the cargo at port.
Cargo released
Finally cleared, one B/L at a time.
Every bill of lading 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.
See fields list
B/L details
bill_of_lading_number, issue_date, departure_date
Shipper
shipper.name, shipper.address, shipper.phone, shipper.email
Consignee
consignee.name, consignee.address, notify_party.name
Carrier
carrier.name, carrier.scac, carrier.professional_number
Route
port_of_loading, port_of_discharge, place_of_delivery
Cargo
carrier_items[].description, quantity, gross_weight, measurement
{
"bill_of_lading_number": { "value": "NOLC2457819" }, "issue_date": { "value": "2026-10-09" }, "departure_date": { "value": "2026-10-11" },
"shipper": { "name": { "value": "Lumen Home Textiles Co." }, "address": { "value": "88 Jiangdong Rd, Ningbo, China" } },
"consignee": { "name": { "value": "Brightwell Interiors GmbH" } }, "notify_party": { "name": { "value": "Kestrel Customs Brokers" } },
"carrier": { "name": { "value": "Northline Ocean Carriers" }, "scac": { "value": "NOLC" } },
"port_of_loading": { "value": "Ningbo, China" }, "port_of_discharge": { "value": "Rotterdam, Netherlands" }, "place_of_delivery": { "value": "Duisburg, Germany" },
"carrier_items": [ { "description": { "value": "Cotton bed linen" }, "quantity": { "value": 420 }, "gross_weight": { "value": 6840 }, "weight_unit": { "value": "kg" } }, … ],
}
Ready to post, not just to read.
Dates come back in ISO 8601, weights and measurements as numbers with their unit, and every field carries a confidence score and its position.
Built for real B/Ls, not clean templates
Carbon copies, faxed originals, stamps over the consignee box, cargo tables that run onto a rider page. The model reads parties and cargo lines wherever they sit.

Any carrier, any layout
Ocean carriers, NVOCCs and trucking companies each use their own B/L form. The same schema comes back for all of them, with no template to build.

Every cargo line, with its unit
Description, packages, gross weight and measurement for each line, kept with their kg, lb or CBM unit, even when the table runs onto a rider page.

Ready for document matching
Packages and weights come back as numbers, so checking the B/L against the packing list and commercial invoice takes a few lines of code.

Shipping packs split and sorted
B/L, packing list and invoice often arrive in one PDF. Mindee splits the file and classifies each document, so the B/L reaches the right model.
PDF / JPEG / PNG / WEBP / TIFF / HEIC, Ocean & truck B/Ls, Multi-page with riders, Scans, faxes & phone photos, Stamps & handwriting
Bill of lading OCR accuracy you can measure, field by field
Every field comes with a confidence score, so clean B/Ls flow straight to your TMS and unclear ones go to a reviewer. Test it on your own bills of lading in the free trial.
96.1%
Field-level accuracy on parties and ports
Shipper, consignee, ports
94.2%
Accuracy on cargo lines
Packages, weight, measurement
0.9s
Median time per bill of lading
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.
B/L received
Email from a carrier or forwarder
Mindee extracts the B/L
Parties, ports, cargo lines
Shipment updated
Your TMS, ERP or Google 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
Security center
What teams build with bill of lading OCR
The same API powers very different products. Here is where it usually starts.

Logistics
Customs clearance
Turn invoices, packing lists and transport documents into declaration-ready data, line by line.

Finance & Accounting
Accounts payable
Extract, match and post supplier invoices at any volume, without supplier templates.

Insurance
Claim management
Read every claim attachment, settle simple claims and route the rest to the right adjuster.
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
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
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.
Documents related that Mindee reads
FAQ about Mindee's Bill of Lading OCR API
Can't find what you're looking for? Our team answers within one business day.
What is a bill of lading?
A bill of lading (B/L) is the main transport document in shipping. Issued by the carrier, it has three roles: it is a receipt confirming the goods were loaded, evidence of the contract of carriage, and, when negotiable, a document of title that gives the right to collect the goods at destination. It contains the shipper, the consignee and the notify party, the vessel and voyage, the ports of loading and discharge, the container and seal numbers, the description of the goods, the number of packages, the gross weight and the freight terms. Mindee extracts all these fields from a PDF or a scan and returns them as structured JSON, ready for your TMS, ERP or customs system.
Who issues the bill of lading, and who are the shipper, consignee and notify party?
The bill of lading is issued by the carrier or its agent, usually once the goods have been loaded. Freight forwarders and NVOCCs also issue their own house bills of lading to their customers. The shipper is the party sending the goods, usually the exporter. The consignee is the party entitled to receive them, either named directly or, on a negotiable B/L, “to order” of a bank or of the shipper. The notify party is the company to be informed when the goods arrive, often the importer or its customs broker. Mindee extracts each party as a separate field, with its name and address, so your teams don’t confuse them.
Can Mindee process every type of bill of lading?
Yes. Every carrier and freight forwarder uses its own layout, and there are several types of bills of lading: master and house bills of lading, straight (non-negotiable) and “to order” (negotiable) bills, sea waybills, telex releases and switch bills. Mindee doesn’t rely on templates, so it extracts the same fields from all these documents, including multi-page bills with container lists in an annex. You get one consistent output structure, whatever the carrier or the type of document.
How do banks check a bill of lading under a letter of credit?
When a shipment is paid by letter of credit, the bank checks that the bill of lading complies with the credit terms before paying the exporter, following international practices such as UCP 600 and ISBP 745. Typical checks include the consignee (“to order of” the issuing bank, for example), the “shipped on board” notation and its date compared with the latest shipment date, the ports of loading and discharge, the description of the goods, and the number of originals issued. Mindee extracts these fields automatically, so trade finance teams can run the comparison with the letter of credit and focus their review on the discrepancies.
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 bills of lading?
Send your first bill of lading to the API in minutes, with a full team of engineers dedicated to document processing behind it.
14-day free trial
No credit card required