🇺🇸 English
- First Call
- Authentication
- Basic Information
- Ocean Data API
- Ocean Data
- China Terminal Data
- Container Visual Tracking
- China Vessel Call Plan
- Air Data API
- Multimodal Transport API
- Al Vessel Prediction API
- Schedule API
- Overseas Data API
- Global Terminal Data
- US Customs Clearance Data
- Global Express Tracking Data API
- China Inland Data API
- China Customs Data API
US Customs Clearance Data Query API
GET
https://api.trackingeyes.com/api/usCustoms/v2/query
1.
2.
3.
4.
5.
| HOLD Code | Description | Key Characteristics | HOLD Release Code |
|---|---|---|---|
| 1A | Document review | Only the customs declaration documents are reviewed; released if no anomaly is found | 1B |
| 1H | General physical inspection | The container is opened and unpacked directly to check for contraband, counterfeit goods and labels | 1I |
| 2H | USDA special inspection | Animal/plant/food/wood packaging quarantine; a fumigation certificate is required | 2I |
| 3H | FDA special inspection | Compliance review of food, drugs and medical devices | 3I |
| 4A | Document review (high probability of transfer to physical inspection) | Documents are checked first, with a high probability of transfer to 1H physical inspection | 4C |
| 5H | In-depth document review + possible physical inspection (dual inspection) | In-depth document review first, then physical inspection if problems are found; led by Fast Doc Review | 5I, 4C |
| 6H | Document review | Loading and transit are prohibited because the cargo description, shipper or consignee information is invalid | 6I |
| 7H | X-ray scanning inspection | Non-intrusive scanning to quickly identify anomalies | 7I |
| 8H | Document review | Detained because the cargo description is invalid | 8I |
| 9H | Document review | Detained because the consignee information is invalid | 9I |
| 1X | Transfer to inspection station | Customs approves the transfer to an inspection station for examination | 84 |
| Released Code | Description |
|---|---|
| 1C/1B | Released |
Request
Query Params
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.trackingeyes.com/api/usCustoms/v2/query?companyCode=&token=&mot=&blNo=&carrierCd=&scac=&orgCode=&localKey='Responses
🟢200Success
application/json
Bodyapplication/json
Example
{
"type": "success",
"code": 200,
"codeDesc": "success",
"message": "Operation succeeded",
"result": {
"blNo": "695-57340021",
"mblNo": "69557340021",
"localKey": "",
"carrierCd": "BR",
"carrier": "EVA AIRWAYS",
"scac": "",
"mot": "A",
"entryNumber": "D9T90321112",
"inBondNumber": "",
"statusCd": "1F",
"status": "CBP LOCAL TRANSFER AUTHORIZED",
"statusCn": "CBP批准本地转运",
"statusType": "RMHOLD",
"statusDate": "2026-09-24 10:08:00",
"vslName": "",
"voy": "0056",
"polId": "",
"polCd": "",
"pol": "",
"podId": "3901",
"podCd": "",
"pod": "Chicago, Illinois, including O' Hare International Airport",
"plrId": "",
"plrCd": "",
"plr": "",
"pldId": "",
"pldCd": "",
"pld": "",
"atd": "",
"ata": "2026-09-24 00:00:00",
"plrDate": "",
"amsTime": "",
"amsMatchedTime": "",
"isfMatchedTime": "",
"piece": "182",
"rlsPiece": "182",
"billType": "",
"firmsCode": "HBT1",
"holdDispositionCd": "",
"holdName": "",
"holdNameCn": "",
"holdDate": "",
"releasedDate": "2026-09-24 21:57:00",
"mblStatus": [
{
"sno": "1",
"dispositionCd": "1F",
"dispositionCn": "CBP批准本地转运",
"dispositionType": "RMHOLD",
"dispositionDesc": "CBP LOCAL TRANSFER AUTHORIZED",
"quantity": "182",
"dispositionDate": "2026-09-24 10:08:00"
}
],
"houseList": [
{
"filerCd": "",
"houseNo": "AAMNL2690012",
"scac": "",
"entryNumber": "D9T90321112",
"inBondNumber": "",
"piece": "182",
"rlsPiece": "182",
"ata": "2026-09-24 00:00:00",
"pieceUnit": "",
"lastEventCd": "1C",
"lastEventDate": "2026-09-24 21:57:00",
"carrierMatchedTime": "",
"amsTime": "",
"amsMatchedTime": "",
"isfMatchedTime": "",
"holdDispositionCd": "",
"holdName": "",
"holdNameCn": "",
"holdDate": "",
"releasedDate": "2026-09-24 21:57:00",
"hblStatus": [
{
"sno": "1",
"dispositionCd": "1C",
"dispositionCn": "放行：常规查验放行",
"dispositionType": "RLS",
"dispositionDesc": "ENTER AND RELEASED GENERAL EXAM",
"quantity": "182",
"dispositionDate": "2026-09-24 21:57:00"
}
]
}
],
"batchInfoList": [
{
"partSequenceNo": "A",
"blNo": "69557340021",
"blType": "M",
"batchStatus": "RMHOLD",
"carrierCd": "EVA",
"flightNo": "0056",
"piece": "28",
"entryNumber": "",
"inBondNumber": "",
"ata": "2026-09-24 00:00:00",
"polId": "",
"polCd": "",
"pol": "",
"podId": "3901",
"podCd": "3901",
"pod": "Chicago, Illinois, including O' Hare International Airport",
"plrId": "",
"plrCd": "",
"plr": "",
"pldId": "",
"pldCd": "",
"pld": ""
},
{
"partSequenceNo": "A",
"blNo": "AAMNL2690012",
"blType": "H",
"batchStatus": "RLS",
"carrierCd": "EVA",
"flightNo": "0056",
"piece": "28",
"entryNumber": "D9T90321112",
"inBondNumber": "",
"ata": "2026-09-24 00:00:00",
"polId": "",
"polCd": "",
"pol": "",
"podId": "3901",
"podCd": "3901",
"pod": "Chicago, Illinois, including O' Hare International Airport",
"plrId": "",
"plrCd": "",
"plr": "",
"pldId": "",
"pldCd": "",
"pld": ""
},
{
"partSequenceNo": "B",
"blNo": "69557340021",
"blType": "M",
"batchStatus": "RMHOLD",
"carrierCd": "EVA",
"flightNo": "0642",
"piece": "16",
"entryNumber": "",
"inBondNumber": "",
"ata": "2026-09-25 00:00:00",
"polId": "",
"polCd": "",
"pol": "",
"podId": "3901",
"podCd": "3901",
"pod": "Chicago, Illinois, including O' Hare International Airport",
"plrId": "",
"plrCd": "",
"plr": "",
"pldId": "",
"pldCd": "",
"pld": ""
},
{
"partSequenceNo": "B",
"blNo": "AAMNL2690012",
"blType": "H",
"batchStatus": "RLS",
"carrierCd": "EVA",
"flightNo": "0642",
"piece": "16",
"entryNumber": "D9T90321112",
"inBondNumber": "",
"ata": "2026-09-25 00:00:00",
"polId": "",
"polCd": "",
"pol": "",
"podId": "3901",
"podCd": "3901",
"pod": "Chicago, Illinois, including O' Hare International Airport",
"plrId": "",
"plrCd": "",
"plr": "",
"pldId": "",
"pldCd": "",
"pld": ""
},
{
"partSequenceNo": "C",
"blNo": "69557340021",
"blType": "M",
"batchStatus": "RMHOLD",
"carrierCd": "EVA",
"flightNo": "0650",
"piece": "49",
"entryNumber": "",
"inBondNumber": "",
"ata": "2026-09-27 00:00:00",
"polId": "",
"polCd": "",
"pol": "",
"podId": "3901",
"podCd": "3901",
"pod": "Chicago, Illinois, including O' Hare International Airport",
"plrId": "",
"plrCd": "",
"plr": "",
"pldId": "",
"pldCd": "",
"pld": ""
},
{
"partSequenceNo": "C",
"blNo": "AAMNL2690012",
"blType": "H",
"batchStatus": "RLS",
"carrierCd": "EVA",
"flightNo": "0650",
"piece": "49",
"entryNumber": "D9T90321112",
"inBondNumber": "",
"ata": "2026-09-27 00:00:00",
"polId": "",
"polCd": "",
"pol": "",
"podId": "3901",
"podCd": "3901",
"pod": "Chicago, Illinois, including O' Hare International Airport",
"plrId": "",
"plrCd": "",
"plr": "",
"pldId": "",
"pldCd": "",
"pld": ""
},
{
"partSequenceNo": "D",
"blNo": "69557340021",
"blType": "M",
"batchStatus": "RMHOLD",
"carrierCd": "EVA",
"flightNo": "0642",
"piece": "89",
"entryNumber": "",
"inBondNumber": "",
"ata": "2026-09-28 00:00:00",
"polId": "",
"polCd": "",
"pol": "",
"podId": "3901",
"podCd": "3901",
"pod": "Chicago, Illinois, including O' Hare International Airport",
"plrId": "",
"plrCd": "",
"plr": "",
"pldId": "",
"pldCd": "",
"pld": ""
},
{
"partSequenceNo": "D",
"blNo": "AAMNL2690012",
"blType": "H",
"batchStatus": "RLS",
"carrierCd": "EVA",
"flightNo": "0642",
"piece": "89",
"entryNumber": "D9T90321112",
"inBondNumber": "",
"ata": "2026-09-28 00:00:00",
"polId": "",
"polCd": "",
"pol": "",
"podId": "3901",
"podCd": "3901",
"pod": "Chicago, Illinois, including O' Hare International Airport",
"plrId": "",
"plrCd": "",
"plr": "",
"pldId": "",
"pldCd": "",
"pld": ""
}
]
}
}Modified at 2026-10-18 08:39:53