API ReferenceShipments
Track shipment
Query status, fees, sender/receiver information, shipment history, and image links.
GET
/v3/bill/trackingGet detailed shipment information by shipment code.
Auth: Bearer access token
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
bill_code | string | Yes | Shipment code to query. |
curl --request GET \
--url "https://apisandbox.ntlogistics.vn/v3/bill/tracking?bill_code=CP17340160" \
--header "Authorization: Bearer <access_token>"Response fields
| Field | Type | Description |
|---|---|---|
success | boolean | true if the request succeeded; any other value is an error. See message for details. |
message | string | Response message. |
data | object | Response data. |
bill_code | string | Shipment code. |
ref_code | string | Customer reference code. |
weight | string | Shipment weight (kg). |
dimension_weight | string | Volumetric weight (kg). |
width | string | Package width (cm). |
length | string | Package length (cm). |
height | string | Package height (cm). |
payment_status | string | Payment status. |
payment_at | string | Payment time. |
bill_status_id | number | Shipment status ID. |
bill_status_desc | string | Shipment status description. |
date_pickup | string | Pickup time. |
pay_method | string | Payment method. |
service | string | Service code. |
cod_amt | string | COD amount. |
cod_fee | string | COD fee. |
date_expected | string | Estimated delivery time. |
description | string | Shipment description. |
cargo_content | string | Cargo content. |
insurance_fee | string | Insurance fee. |
counting_fee | string | Counting fee. |
lifting_fee | string | Lifting fee. |
packing_fee | string | Packing fee. |
delivery_fee | string | Delivery fee. |
other_fee | string | Other fees. |
remote_fee | string | Remote area fee. |
main_fee | string | Main freight fee. |
total_fee | string | Total fee. |
sender_* | string | Sender information (sender_name, sender_phone, sender_address, sender_ward, sender_district, sender_province). |
receiver_* | string | Receiver information (receiver_name, receiver_phone, receiver_address, receiver_ward, receiver_district, receiver_province). |
date_delivery | string | Actual delivery time, if available. |
note | string | Delivery note. |
histories | array | Shipment operation events. Each item may include sequence, log_status, city, district, operation_en, operationID, operationType, delayReason, operation, loc_time. |
p_link_image | string | Proof-of-delivery image link, if available. |
bill_image_link | string[] | Waybill images (picking and receiving), if available. |
document_image_link | string[] | Document images, if available. |
{
"success": true,
"data": [
{
"bill_code": "CP17412845",
"ref_code": "",
"weight": "1.00",
"dimension_weight": "0.00",
"width": "0",
"length": "0",
"height": "0",
"payment_status": "",
"payment_at": "",
"bill_status_id": 4,
"bill_status_desc": "Đã giao hàng",
"date_pickup": "2023-08-17 09:26:44.296",
"pay_method": "NGTTS",
"service": "CPN",
"cod_amt": "0.00",
"cod_fee": "0.0",
"date_expected": "2023-08-18 23:59:59.0",
"description": "HÀNG DỄ VỠ 3",
"cargo_content": "Hàng Hóa",
"insurance_fee": "0.0",
"counting_fee": "0",
"lifting_fee": "0.0",
"packing_fee": "0",
"delivery_fee": "0.0",
"other_fee": "0.0",
"remote_fee": "0.0",
"main_fee": "0.00",
"total_fee": "20000",
"sender_name": "Log 3",
"sender_phone": "09xxxxxxx",
"sender_address": "12B HTM",
"sender_ward": "Phường Dịch Vọng Hậu",
"sender_district": "Quận Cầu Giấy",
"sender_province": "Hà Nội",
"receiver_name": "Hà Nội",
"receiver_phone": "09xxxxxxx",
"receiver_address": "khL",
"receiver_ward": "Phường Phú Thượng",
"receiver_district": "Quận Tây Hồ",
"receiver_province": "Hà Nội",
"date_delivery": "2023-08-17 09:30:17.0",
"note": "Không cho xem hàng. GIAO GIỜ HÀNH CHÍNH, Ở CÔNG TY",
"histories": [
{
"sequence": 0,
"log_status": "10",
"city": "Hà Nội",
"district": "Quận Cầu Giấy",
"operation_en": "Received from Log 3",
"operationID": 0,
"operation": "Nhận vận đơn từ Log 3",
"loc_time": "17/08/2023 09:26"
},
{
"sequence": 1,
"log_status": "20",
"city": "TP. Hồ Chí Minh",
"district": "Quận Tân Phú",
"operation_en": "Bill import to Kho Tây Thạnh",
"operationID": 4399184,
"operationType": "WIW",
"delayReason": "",
"operation": "Nhập vận đơn vào Kho Tây Thạnh",
"loc_time": "17/08/2023 09:27"
},
{
"sequence": 2,
"log_status": "20",
"city": "TP. Hồ Chí Minh",
"district": "Quận Tân Phú",
"operation_en": "Bill export from Kho Tây Thạnh",
"operationID": 4399185,
"operationType": "WEG",
"delayReason": "",
"operation": "Xuất vận đơn từ Kho Tây Thạnh",
"loc_time": "17/08/2023 09:28"
},
{
"sequence": 3,
"log_status": "30",
"city": "Hà Nội",
"district": "Quận Tây Hồ",
"operation_en": "Delivered to Abc",
"operationID": 0,
"operation": "Trả vận đơn cho Abc",
"loc_time": "17/08/2023 09:30"
}
],
"p_link_image": "",
"bill_image_link": [
"https://cdndev.ntlogistics.vn/uploads/lien-trang/2023/08/17/mobile-app/CP17412845/d83a5d8bd22b49b484b85035895.jpg",
"https://cdndev.ntlogistics.vn/uploads/lien-hong/2023/08/17/mobile-app/CP17412845/60d2176396adfee7b20cfac08.jpg"
],
"document_image_link": [
"https://cdndev.ntlogistics.vn/uploads/chung-tu/2023/08/17/mobile-app/CP17412845/739b6b31542949dda8c47c70600.jpg",
"https://cdndev.ntlogistics.vn/uploads/chung-tu/2023/08/17/mobile-app/CP17412845/1034fe7f142e4eed90f15639dc5.jpg"
]
}
],
"message": "Tracking successfully"
}