SEO · Product page
Air Waybill to JSON API
Extract MAWB and HAWB fields from a PDF or image into a stable JSON schema—built for freight forwarders, customs brokers, and cargo TMS integrators who need an air waybill OCR API, not a chat paste.
What “air waybill to JSON” means here
POST /v1/extract/awb accepts a multipart upload (file=). You get one JSON object per document: airline AWB number, airports, pieces, gross and chargeable weight, parties, and validation flags. Same contract for master and house airwaybills.
- air waybill api — HTTP endpoint you can put in a queue
- awb ocr api — PDF / scan in, fields out
- parse air waybill pdf — fixed keys, not free-form prose
Endpoint
Public API endpoint — coming soon
POST https://getdocapi.com/v1/extract/awb
Authorization: Bearer <api_key>
Content-Type: multipart/form-data
file=@mawb.pdfAccepted: PDF and common images (e.g. .pdf, .png, .jpg). Marketing site is live; extraction API at this path is not public yet.
Fields you get
| Field | Why it matters |
|---|---|
awb_number | 11-digit airline AWB with Mod-7 check |
hawb_number | House reference when present |
awb_level | mawb / hawb / unknown |
airport_dep / airport_dest | IATA codes preferred |
pieces, gross_kg, chargeable_kg | Ops + rating fields |
validations, needs_review | Downstream gate |
Full field list on the product page and in docs.
Before & after
Public sample MAWB → example JSON (illustrative, not a live call).
{
"document_type": "air_waybill",
"awb_level": "mawb",
"awb_number": "071-12760786",
"airport_dep": "DXB",
"airport_dest": "ADD",
"pieces": "60",
"gross_kg": "2520",
"chargeable_kg": "2520",
"validations": {
"awb_check_digit_ok": true,
"chargeable_gte_gross": true
},
"needs_review": false
}Built-in validators
AWB check digit (Mod-7)
IATA rule on the 11-digit number. Invalid candidates are rejected or replaced when OCR text still contains a valid number. How Mod-7 works →
Chargeable ≥ gross
Usual volumetric constraint. Failures set needs_review instead of silent bad rows.
Not this product
- Courier tracking labels (DHL / UPS / FedEx parcel waybills)
- Ocean bill of lading or ASN (different document family)
- A replacement for clean FWB / EDI when you already have it
Searching “bill of lading air waybill extract api”? This API is for IATA air waybills (airwaybill / AWB / MAWB / HAWB), not ocean B/L.