Retrieve Shipment Information
This endpoint allows you to retrieve shipment details using one or more transportCode values. If customerCode is provided, only shipments registered under that customer will be retrieved.
Request
POST https://openapi.willog.io/ext/v1/box/transports/info
Request Body
| Name | Type | Required | Description |
|---|---|---|---|
| customerCode | String | false | Customer code |
| transportCodes | Array | true | List of transport codes (max: 100) |
Example Request
POST /ext/v1/box/transports/info
Authorization: Bearer token
{
"customerCode": "customer1",
"transportCodes": [
"5089229ca9f1",
"f0531fb95d21"
]
}
Response
Response Body
| Name | Type | Not-null | Description |
|---|---|---|---|
| items | Array | true | List of retrieved shipments |
| transportCode | String | true | Shipment code |
| serial | String | false | Device serial (if assigned) |
| departureTime | Unix timestamp(ms) | false | Shipment departure time |
| arrivalTime | Unix timestamp(ms) | false | Shipment arrival time |
| fetchedManualArrivalTime | Unix timestamp(ms) | false | Manually set arrival time |
Example Response
HTTP/1.1 200 OK
{
"items": [
{
"transportCode": "5089229ca9f1",
"serial": "AB000343",
"departureTime": 1738655274000,
"arrivalTime": 1738655274000,
"fetchedManualArrivalTime": 1738655274000
}
]
}
Error Responses
- Unauthorized Access to Customer Data
HTTP/1.1 400 Bad Request
{
"code": "A0016"
}