REST API Integration

How It Connects

POST /v1/awb/parse — it’s that simple

Send a PDF, image, or raw FWB text to our API endpoint. Get back structured JSON with all 29 FWB sections, confidence scores, and validation results in under 2 seconds.

cURL

Python

Node.js

# Parse an AWB document curl -X POST \ https://api.kabytech.co.th/v1/awb/parse \ -H "Authorization: Bearer sk_live_..." \ -H "Content-Type: multipart/form-data" \ -F "file=@awb-176-15515964.pdf" \ -F "options[validate]=true" \ -F "options[webhook]=https://..." # Response (truncated): { "awb_number": "176-1551 5964", "shipper": { "name": "KARGO GLOBAL LOGISTICS", "city": "BANGKOK" }, "consignee": { "name": "EXCEL MARITIME" }, "routing": { "origin": "BKK", "dest": "MAA", "via": "DXB", "flight": "EK0375" }, "cargo": { "pieces": 5, "weight_kg": 57.72, "description": "AIRBAG INFLATOR" }, "dg": { "un_number": "UN3268", "class": "9" }, "charges": { "type": "PREPAID" }, "confidence": 0.978, "sections_parsed": 29 }

API Endpoint

One endpoint, every AWB format

POST your AWB document — PDF, JPEG, PNG, TIFF, or raw FWB/FHL text — to /v1/awb/parse. The API handles format detection, OCR, field extraction, and validation automatically.

Response includes all 29 IATA Cargo-IMP FWB sections as structured JSON, with per-field confidence scores. Webhook callbacks notify your system when async processing completes.

POST /v1/awb/parseMultipart UploadJSON ResponseWebhook

Developer Tools

SDKs, webhooks, and batch processing

API — Developer Features

📖OpenAPI 3.0 specificationPUBLISHED

📦SDKs: Python / Node / PHP / JavaAVAILABLE

🔌Webhook callbacks (configurable)ACTIVE

📊Batch API: up to 100 AWBs/requestSUPPORTED

🔒API key + JWT authenticationSECURE

🕒Rate limits: 100-10,000 req/minBY PLAN

Platform

Everything you need to integrate

OpenAPI 3.0 Spec — Full OpenAPI specification with interactive documentation. Generate client code in any language from the spec.

Official SDKs — Production-ready SDKs for Python, Node.js, PHP, and Java. Install via pip, npm, composer, or Maven. Typed responses with IDE autocomplete.

Webhook Support — Configure webhooks for async processing results, batch completion, and error notifications. Retry logic with exponential backoff built in.

Batch API — Process up to 100 AWBs in a single API request. Ideal for bulk migrations, daily batch imports, or email inbox processing.

OpenAPI 3.0Python SDKNode.js SDKBatch API

<2s

API Response Time

99.9%

Uptime SLA

4

Official SDKs

100

Batch Size Limit

Response Format

Structured JSON output

{ "id": "parse_8f3a2b1c", "status": "complete", "awb_number": "176-1551 5964", "airline_prefix": 176, "carrier": "Emirates", "shipper": { "name": "KARGO GLOBAL LOGISTICS CO.,LTD.", "address": "Bangkok 10260 Thailand", "confidence": 0.99 }, "consignee": { "name": "EXCEL MARITIME & LOGISTICS PVT LTD", "confidence": 0.98 }, "routing": { "origin": "BKK", "destination": "MAA", "via": ["DXB"], "flights": [{"number": "EK0375"}] }, "cargo": { "pieces": 5, "gross_weight_kg": 57.72, "nature_of_goods": "AIRBAG INFLATOR" }, "dangerous_goods": { "un_number": "UN3268", "class": "9", "proper_shipping_name": "AIRBAG INFLATOR" }, "charges": { "weight_charge_type": "PREPAID" }, "sections_parsed": 29, "overall_confidence": 0.978, "processing_time_ms": 1847 }

JSON Output

Clean, typed, production-ready

Every response includes the full parsed AWB data in a consistent JSON schema. Each field carries a confidence score so your system can decide whether to accept or flag for review.

The response schema is versioned and backward-compatible. Breaking changes are announced 90 days in advance with migration guides.

Rate limits scale with your plan: Starter (100 req/min), Professional (1,000 req/min), Enterprise (10,000 req/min). All plans include webhook support and batch processing.

Versioned SchemaConfidence Scores29 SectionsBackward Compatible

Ready to integrate?

Get your API key and parse your first AWB in under 5 minutes. Free tier includes 50 parses per month.

Get API Key API Documentation