Create AWB Documentation
Endpoint
POST {base_url}/shipment/awb
Authentication - Request Headers
Authorization: Bearer <your_token>
Content-Type: application/json
Request Parameters
| Field Name | Type | Description | Required |
|---|---|---|---|
| invoice_date | string (YYYY-MM-DD) | Date of invoice | Required |
| destination_country | string | Receiver country (Case-sensitive - see valid countries) | Required |
| service | string | Courier service (e.g., DHL) | Required |
| reference_no | string | Reference Number | Optional |
| kyc1[kyc_type] | int | Indicates the sender's KYC document type. Allowed values: 1 = Passport Number 2 = Voter ID 3 = PAN Number 4 = Aadhaar Number 5 = GSTIN (Normal) | Required |
| kyc1[kyc_number] | string | Sender KYC number | Required |
| kyc1[kyc_filename] | string | Sender KYC File Name | Required |
| kyc1[kyc_filedata] | base64encoded | KYC File Base64 Encoaded | Required |
| kyc2[kyc_filename] | string | Sender KYC File Name | Optional |
| kyc2[kyc_filedata] | base64encoded | KYC File Base64 Encoaded | Optional |
| pcs_type | string | PCS Type | Required |
| shipper[name] | string | Sender name | Required |
| shipper[phone_no] | string | Sender phone | Required |
| shipper[company_name] | string | Sender company | Required |
| shipper[address1] | string | Sender address line 1 | Required |
| shipper[address2] | string | Sender address line 2 | Required |
| shipper[city] | string | Sender city | Required |
| shipper[state] | string | Sender state | Required |
| shipper[zip_code] | string | Sender ZIP code | Required |
| consignee[name] | string | Receiver name | Required |
| consignee[phone_no] | string | Receiver phone | Required |
| consignee[email] | string | Receiver email | Required |
| consignee[company_name] | string | Receiver company | Required |
| consignee[address1] | string | Receiver address 1 | Required |
| consignee[address2] | string | Receiver address 2 | Required |
| consignee[city] | string | Receiver city | Required |
| consignee[state] | string | Receiver state Pass "NA", in case state not applicable | Required |
| consignee[zip_code] | string | Receiver ZIP code | Required |
| consignee[country] | string | Receiver country | Required |
| boxes[n][boxno] | integer | Box number | Required |
| boxes[n][actualwt] | float | Weight in kg | Required |
| boxes[n][bookinglength] | float | Length in cm | Required |
| boxes[n][bookingbreadth] | float | Breadth in cm | Required |
| boxes[n][bookingheight] | float | Height in cm | Required |
| items[n][boxno] | integer | Associated box number | Required |
| items[n][description] | string | Item description | Required |
| items[n][hscode] | string | HS code | Required |
| items[n][weight] | float | Item weight | Optional |
| items[n][quantity] | integer | Item quantity | Required |
| items[n][unit_rate] | float | Unit rate | Required |
| items[n][sub_total] | float | Subtotal | Required |
Payload Example
{
"invoice_date": "2026-03-30",
"destination_country": "Australia",
"service": "Australia Direct",
"pcs_type": "DOX",
"reference_no": "REF-1001",
"third_party_label": false,
"kyc1": {
"kyc_type": 4,
"kyc_number": "987654321001",
"kyc_filename": "kyc.png",
"kyc_filedata": "BASE64_DATA"
},
"kyc2": {
"kyc_number": "987654321002",
"kyc_filename": "kyc2.png",
"kyc_filedata": "BASE64_DATA"
},
"shipper": {
"name": "Ravi Kumar",
"phone_no": "+91-9876543210",
"company_name": "Global Exports Pvt. Ltd.",
"address1": "14 Industrial Estate",
"address2": "Phase 2",
"city": "Mumbai",
"state": "Maharashtra",
"zip_code": "400001"
},
"consignee": {
"name": "Emma Thompson",
"phone_no": "+61-412345678",
"email": "emma.thompson@austradelogistics.com",
"company_name": "Austrade Logistics",
"address1": "22 Oceanic Drive",
"address2": "Unit 5",
"city": "Perth",
"state": "WA",
"zip_code": "6000",
"country": "Australia"
},
"boxes": [
{
"boxno": 1,
"actualwt": 3.5,
"bookinglength": 45,
"bookingbreadth": 30,
"bookingheight": 20
},
{
"boxno": 2,
"actualwt": 2.0,
"bookinglength": 40,
"bookingbreadth": 25,
"bookingheight": 15
},
{
"boxno": 3,
"actualwt": 1.8,
"bookinglength": 35,
"bookingbreadth": 20,
"bookingheight": 10
}
],
"items": [
{
"boxno": 1,
"description": "Business Documents - Legal Contracts",
"hscode": "49119990",
"weight": 3.5,
"quantity": 1,
"unit_rate": 100,
"sub_total": 100
},
{
"boxno": 2,
"description": "Company Brochures",
"hscode": "49111010",
"weight": 2.0,
"quantity": 500,
"unit_rate": 0.10,
"sub_total": 50.0
},
{
"boxno": 3,
"description": "Confidential Reports",
"hscode": "49119990",
"weight": 1.8,
"quantity": 10,
"unit_rate": 2.50,
"sub_total": 25.0
}
]
}
Success Response
{
"status": true,
"message": "AWB lable created successfully",
"data": {
"AWB": "DK00001",
"ForwardingNo": "X123456789",
"Label": Base64()
}
}Example Request