Returns specific tracked shipments in your project by ID.
Arguments
| Name | Type | Description |
|---|---|---|
| ids | [ObjectId!]! | The shipment Unique Windward assigned ID. |
Returns
| Name | Description |
|---|---|
| TrackedShipment! | The returned tracked shipment data and metadata. |
TrackedShipment Fields
| Name | Type | Description |
|---|---|---|
| createdAt | DateTime! | Shipment tracking start timestamp. |
| id | ObjectId! | The shipment Unique Windward assigned ID. |
| metadata | TrackedShipmentMetadata | Additional metadata updated by the user. |
| shipment | Shipment | The shipment data. |
| updatedAt | DateTime! | Shipment last update timestamp. |
Example Code
Sample Query
query trackedShipmentsByIds( $offset: NonNegativeInt!, $limit: PositiveInt!, $sort: [SortInput!], $orderBy: [OrderByInput!], $filterBy: [FilterByInput!], $searchTerm: String) {
trackedShipmentsByIds(offset: $offset, limit: $limit, sort: $sort, orderBy: $orderBy, filterBy: $filterBy, searchTerm: $searchTerm) {
total
totalFiltered
count
data {
id
metadata{
bookingReference
businessData{
key
value
}
shipment {
id
carrierBookingReference
containerNumber
bol
scac
carrier {
code
shortName
longName
codeAliases
}
container {
id
number
isoCode
}
status {
id
events {
description
voyage
utcOffset
timestamps {
datetime
code
}
eventType
equipmentEventTypeCode
transportEventTypeCode
port {
id
type
}
}
estimatedArrivalAt
actualArrivalAt
estimatedDepartureAt
actualDepartureAt
currentEvent {
description
voyage
utcOffset
eventType
equipmentEventTypeCode
transportEventTypeCode
}
milestones {
type
utcOffset
arrival {
voyage
}
departure {
voyage
}
port {
id
type
properties {
name
areaType
country
locode
secondaryLocodes
}
}
}
predicted {
datetime
code
diffFromCarrierDays
}
voyageStatus
arrivingAt
pod {
id
type
properties {
name
areaType
country
locode
secondaryLocodes
}
}
pol {
id
type
}
postPod {
id
type
}
delay {
reasons {
delayReasonCode
vessels {
compared {
id
}
updated {
id
}
}
departureFromMilestone {
compared {
datetime
datetimeLocalized
utcOffset
}
updated {
datetime
datetimeLocalized
utcOffset
}
}
shipmentPhase
locode
delayReasonDescription
cause
port {
id
}
}
}
}
initialCarrierETA
}
createdAt
updatedAt
}
}
}
}
Variables
{
"ids": [
"638ee868e7eb2f52d4c320c8"
]
}
Response
{
"data": {
"trackedShipmentsByIds": [
{
"id": "638ee868e7eb2f52d4c320c8",
"createdAt": "2022-12-06T06:59:52.838Z",
"updatedAt": "2022-12-12T16:40:15.395Z",
"shipment": {
"id": "63635275b50f1300122973bf",
"carrierBookingReference" : "HLCUTA12211APVV5"
"containerNumber": "FANU3197029",
"bol": null,
"scac": "HLCU",
"carrier": {
"code": "HLCU",
"shortName": "Hapag Lloyd",
"longName": "Hapag-Lloyd",
"codeAliases": [
"HLCU",
"HLXU",
"HPGC",
"HLUS"
]
},
"container": {
"id": "636352752474d85bac377aaa",
"number": "FANU3197029",
"isoCode": "45G1"
},
"status": {
"id": "6399648ec091d600118f84ac",
"events": [
{
"description": "Empty to shipper",
"voyage": null,
"utcOffset": "-0500",
"timestamps": {
"datetime": "2022-11-30T21:49:00.000Z",
"code": "ACT"
},
"eventType": [
"EQUIPMENT"
],
"equipmentEventTypeCode": [
"DROP"
],
"transportEventTypeCode": [],
"port": {
"id": "5358fc78b68ca120a07dbcf3",
"type": "Feature"
}
},
{
"description": "Gate in at first POL",
"voyage": null,
"utcOffset": "-0500",
"timestamps": {
"datetime": "2022-12-01T19:21:00.000Z",
"code": "ACT"
},
"eventType": [
"EQUIPMENT"
],
"equipmentEventTypeCode": [
"GTIN"
],
"transportEventTypeCode": [],
"port": {
"id": "5358fc78b68ca120a07dbcf3",
"type": "Feature"
}
},
{
"description": "Loaded at first POL",
"voyage": "2244",
"utcOffset": "-0500",
"timestamps": {
"datetime": "2022-12-04T22:11:00.000Z",
"code": "ACT"
},
"eventType": [
"EQUIPMENT",
"TRANSPORT"
],
"equipmentEventTypeCode": [
"LOAD"
],
"transportEventTypeCode": [
"DEPA"
],
"port": {
"id": "5358fc78b68ca120a07dbcf3",
"type": "Feature"
}
},
{
"description": "Departure from first POL",
"voyage": "2244",
"utcOffset": "-0500",
"timestamps": {
"datetime": "2022-12-05T08:48:00.000Z",
"code": "ACT"
},
"eventType": [
"TRANSPORT"
],
"equipmentEventTypeCode": [],
"transportEventTypeCode": [
"DEPA"
],
"port": {
"id": "5358fc78b68ca120a07dbcf3",
"type": "Feature"
}
},
{
"description": "Arrival at final POD",
"voyage": "2244",
"utcOffset": "+0530",
"timestamps": {
"datetime": "2023-01-15T00:30:00.000Z",
"code": "PLN"
},
"eventType": [
"TRANSPORT"
],
"equipmentEventTypeCode": [],
"transportEventTypeCode": [
"ARRI"
],
"port": {
"id": "562cc82a8c0e57be50751ec1",
"type": "Feature"
}
}
],
"estimatedArrivalAt": "2023-01-15T00:30:00.000Z",
"actualArrivalAt": null,
"estimatedDepartureAt": null,
"actualDepartureAt": "2022-12-01T19:21:00.000Z",
"currentEvent": {
"description": "Departure from first POL",
"voyage": "2244",
"utcOffset": "-0500",
"eventType": [
"TRANSPORT"
],
"equipmentEventTypeCode": [],
"transportEventTypeCode": [
"DEPA"
]
},
"predicted": {
"datetime": "2023-01-15T12:30:00.000Z",
"code": "EST",
"diffFromCarrierDays": 0
},
"voyageStatus": null,
"arrivingAt": "2023-01-15T12:30:00.000Z",
"pod": {
"id": "562cc82a8c0e57be50751ec1",
"type": "Feature",
"properties": {
"name": "Jawaharlal Nehru - Nhava Sheva",
"areaType": "Port",
"country": "India",
"locode": "INNSA",
"secondaryLocodes": null
}
},
"pol": {
"id": "5358fc78b68ca120a07dbcf3",
"type": "Feature"
},
"postPod": null,
"milestones": [
{
"type": "POL",
"utcOffset": "-0500",
"arrival": {
"voyage": "2244",
"timestamps": {
"carrier": {
"datetime": null,
"code": null,
"diffFromCarrierDays": null
},
"predicted": {
"datetime": "2022-12-02T17:45:54.000Z",
"code": "ACT",
"diffFromCarrierDays": null
}
}
},
"departure": {
"voyage": "2244"
},
"port": {
"id": "5358fc78b68ca120a07dbcf3",
"type": "Feature",
"properties": {
"name": "New York",
"areaType": "Port",
"country": "UnitedStates",
"locode": "USNYC",
"secondaryLocodes": [
"USEWR",
"USBAY",
"USPEB",
"USNWK",
"USPNJ"
]
}
}
},
{
"type": "POD",
"utcOffset": "+0530",
"arrival": {
"voyage": "2244",
"timestamps": {
"carrier": {
"datetime": "2023-01-15T00:30:00.000Z",
"code": "PLN",
"diffFromCarrierDays": null
},
"predicted": {
"datetime": "2023-01-15T12:30:00.000Z",
"code": "EST",
"diffFromCarrierDays": 0
}
}
},
"departure": null,
"port": {
"id": "562cc82a8c0e57be50751ec1",
"type": "Feature",
"properties": {
"name": "Jawaharlal Nehru - Nhava Sheva",
"areaType": "Port",
"country": "India",
"locode": "INNSA",
"secondaryLocodes": null
}
}
}
]
},
"initialCarrierETA": "2022-11-24T00:00:00.000Z"
},
"metadata": null
}
]
}
}