Shipments
Get a shipment
Getting Started
In Depth Guides
Useful Info
Shipments
Tracking Requests
Webhooks
Webhook Notifications
Containers
Shipping Lines
Terminals
Shipments
Get a shipment
Retrieves the details of an existing shipment. You need only supply the unique shipment id that was returned upon tracking_request creation.
GET
/
shipments
/
{id}
curl --request GET \
--url https://api.terminal49.com/v2/shipments/{id} \
--header 'Authorization: <api-key>'{
"data": {
"id": "02b1bd6f-407c-45bb-8645-06e7ee34e7e3",
"type": "shipment",
"attributes": {
"created_at": "2024-06-26T15:05:20Z",
"ref_numbers": [],
"tags": [],
"bill_of_lading_number": "MEDUF5399896",
"normalized_number": "MEDUF5399896",
"shipping_line_scac": "MSCU",
"shipping_line_name": "Mediterranean Shipping Company",
"shipping_line_short_name": "MSC",
"customer_name": "Sodor Steamworks",
"port_of_lading_locode": "FRLEH",
"port_of_lading_name": "Le Havre",
"port_of_discharge_locode": "USNYC",
"port_of_discharge_name": "New York / New Jersey",
"pod_vessel_name": "MSC ANISHA R.",
"pod_vessel_imo": "9227297",
"pod_voyage_number": "421A",
"destination_locode": "USIND",
"destination_name": "Indianapolis",
"destination_timezone": "US/Eastern",
"destination_ata_at": null,
"destination_eta_at": null,
"pol_etd_at": null,
"pol_atd_at": "2024-06-11T22:00:00Z",
"pol_timezone": "Europe/Paris",
"pod_eta_at": null,
"pod_original_eta_at": null,
"pod_ata_at": null,
"pod_timezone": "America/New_York",
"line_tracking_last_attempted_at": "2024-06-26T15:05:20Z",
"line_tracking_last_succeeded_at": "2024-06-26T15:05:20Z",
"line_tracking_stopped_at": null,
"line_tracking_stopped_reason": null
},
"links": {
"self": "/v2/shipments/02b1bd6f-407c-45bb-8645-06e7ee34e7e3"
},
"relationships": {
"port_of_lading": {
"data": {
"id": "fe7fc831-8a81-4079-8938-b90015912e8b",
"type": "port"
}
},
"port_of_discharge": {
"data": {
"id": "f7cb530a-9e60-412c-a5bc-205a2f34ba54",
"type": "port"
}
},
"pod_terminal": {
"data": {
"id": "b859f5c3-8515-41da-bf20-39c0a5ada887",
"type": "terminal"
}
},
"destination": {
"data": {
"id": "e1e492f6-c8ba-45a9-ad1a-67a7e74547ce",
"type": "port"
}
},
"destination_terminal": {
"data": null
},
"line_tracking_stopped_by_user": {
"data": null
},
"containers": {
"data": [
{
"id": "55a700e4-7005-45a9-92fd-1ff38641dbd9",
"type": "container"
}
]
}
}
},
"links": {
"self": "https://api.terminal49.com/v2/shipments/02b1bd6f-407c-45bb-8645-06e7ee34e7e3?include=containers"
},
"included": [
{
"id": "55a700e4-7005-45a9-92fd-1ff38641dbd9",
"type": "container",
"attributes": {
"number": "CAIU7432986",
"seal_number": null,
"created_at": "2024-06-26T15:05:21Z",
"ref_numbers": [],
"pod_arrived_at": null,
"pod_discharged_at": "2024-06-22T04:00:00Z",
"final_destination_full_out_at": null,
"holds_at_pod_terminal": [],
"available_for_pickup": true,
"equipment_type": "dry",
"equipment_length": 40,
"equipment_height": "high_cube",
"weight_in_lbs": null,
"pod_full_out_at": null,
"empty_terminated_at": null,
"terminal_checked_at": "2024-06-26T17:51:12Z",
"fees_at_pod_terminal": [],
"pickup_lfd": "2024-07-07T04:00:00Z",
"pickup_appointment_at": null,
"pod_full_out_chassis_number": null,
"location_at_pod_terminal": "Yard - Y0709A",
"pod_last_tracking_request_at": "2024-06-26T17:51:12Z",
"shipment_last_tracking_request_at": "2024-06-26T15:05:20Z",
"availability_known": true,
"pod_timezone": "America/New_York",
"final_destination_timezone": "US/Eastern",
"empty_terminated_timezone": "US/Eastern",
"pod_rail_carrier_scac": "CSXT",
"ind_rail_carrier_scac": "CSXT",
"pod_rail_loaded_at": null,
"pod_rail_departed_at": null,
"ind_eta_at": null,
"ind_ata_at": null,
"ind_rail_unloaded_at": null,
"ind_facility_lfd_on": null
},
"relationships": {
"shipment": {
"data": {
"id": "02b1bd6f-407c-45bb-8645-06e7ee34e7e3",
"type": "shipment"
}
},
"pickup_facility": {
"data": null
},
"pod_terminal": {
"data": {
"id": "b859f5c3-8515-41da-bf20-39c0a5ada887",
"type": "terminal"
}
},
"transport_events": {
"data": [
{
"id": "45b542cb-332b-4684-b915-42e3a0759823",
"type": "transport_event"
},
{
"id": "174ed528-a1a9-4002-aef0-f2c9369199da",
"type": "transport_event"
},
{
"id": "7a2f30a6-a756-4c14-9477-fbfc1c7fe2f8",
"type": "transport_event"
},
{
"id": "e7365004-175a-46e8-96cd-dbed0f3daf21",
"type": "transport_event"
},
{
"id": "7c567bf3-7f01-4a3d-a176-eaa1f7165585",
"type": "transport_event"
}
]
},
"raw_events": {
"data": [
{
"id": "2956f71c-bfb9-4e49-b9e2-1b4d53c74cac",
"type": "raw_event"
},
{
"id": "391e0eda-65b5-4fc3-a53d-25ecd9570259",
"type": "raw_event"
},
{
"id": "74810c04-6c8a-4194-8cff-52936584a965",
"type": "raw_event"
},
{
"id": "4b1500e2-b23b-4896-87bd-c38b1d16f385",
"type": "raw_event"
},
{
"id": "8b9a7d88-720a-4304-8c1e-a3336e39f481",
"type": "raw_event"
},
{
"id": "bf1f59c5-5dd8-4013-87f9-d7056bc87114",
"type": "raw_event"
}
]
}
}
}
]
}Authorizations
Token YOUR_API_TOKEN
The APIs require authentication to be done using header-based API Key and Secret Authentication.
API key and secret are sent va the Authorization request header.
You send your API key and secret in the following way:
Authorization: Token YOUR_API_KEY
Path Parameters
Shipment Id
Query Parameters
Comma delimited list of relations to include
Response
200
application/json
OK
The normalized version of the shipment number used for querying the carrier
UN/LOCODE
UN/LOCODE
UN/LOCODE
IANA tz
IANA tz
IANA tz
When Terminal49 last tried to update the shipment status from the shipping line
When Terminal49 last successfully updated the shipment status from the shipping line
When Terminal49 stopped checking at the shipping line
The reason Terminal49 stopped checking
Available options:
all_containers_terminated, past_arrival_window, no_updates_at_line, cancelled_by_user, booking_cancelled Available options:
shipment Represents the equipment during a specific journey.
Available options:
container Available options:
dry, reefer, open top, flat rack, bulk, tank Available options:
10, 20, 40, 45 Available options:
standard, high_cube The last free day for pickup before demmurage accrues. Corresponding timezone is pod_timezone.
When available the pickup appointment time at the terminal is returned.
Whether Terminal 49 is receiving availability status from the terminal.
If availability_known is true, then whether container is available to be picked up at terminal.
Time the vessel arrived at the POD
Discharge time at the port of discharge
Full Out time at port of discharge. Null for inland moves.
When the terminal was last checked.
The chassis number used when container was picked up at POD (if available)
Location at port of discharge terminal
Pickup time at final destination for inland moves.
Time empty container was returned.
Available options:
demurrage, exam, extended_dwell_time, other, total The fee amount in local currency
The ISO 4217 currency code of the fee is charged in. E.g. USD
Example:
"USD"
IANA tz. Applies to attributes pod_arrived_at, pod_discharged_at, pickup_appointment_at, pod_full_out_at.
IANA tz. Applies to attribute final_destination_full_out_at.
IANA tz. Applies to attribute empty_terminated_at.
The SCAC of the rail carrier for the pickup leg of the container's journey.(BETA)
The SCAC of the rail carrier for the delivery leg of the container's journey.(BETA)
Was this page helpful?
curl --request GET \
--url https://api.terminal49.com/v2/shipments/{id} \
--header 'Authorization: <api-key>'{
"data": {
"id": "02b1bd6f-407c-45bb-8645-06e7ee34e7e3",
"type": "shipment",
"attributes": {
"created_at": "2024-06-26T15:05:20Z",
"ref_numbers": [],
"tags": [],
"bill_of_lading_number": "MEDUF5399896",
"normalized_number": "MEDUF5399896",
"shipping_line_scac": "MSCU",
"shipping_line_name": "Mediterranean Shipping Company",
"shipping_line_short_name": "MSC",
"customer_name": "Sodor Steamworks",
"port_of_lading_locode": "FRLEH",
"port_of_lading_name": "Le Havre",
"port_of_discharge_locode": "USNYC",
"port_of_discharge_name": "New York / New Jersey",
"pod_vessel_name": "MSC ANISHA R.",
"pod_vessel_imo": "9227297",
"pod_voyage_number": "421A",
"destination_locode": "USIND",
"destination_name": "Indianapolis",
"destination_timezone": "US/Eastern",
"destination_ata_at": null,
"destination_eta_at": null,
"pol_etd_at": null,
"pol_atd_at": "2024-06-11T22:00:00Z",
"pol_timezone": "Europe/Paris",
"pod_eta_at": null,
"pod_original_eta_at": null,
"pod_ata_at": null,
"pod_timezone": "America/New_York",
"line_tracking_last_attempted_at": "2024-06-26T15:05:20Z",
"line_tracking_last_succeeded_at": "2024-06-26T15:05:20Z",
"line_tracking_stopped_at": null,
"line_tracking_stopped_reason": null
},
"links": {
"self": "/v2/shipments/02b1bd6f-407c-45bb-8645-06e7ee34e7e3"
},
"relationships": {
"port_of_lading": {
"data": {
"id": "fe7fc831-8a81-4079-8938-b90015912e8b",
"type": "port"
}
},
"port_of_discharge": {
"data": {
"id": "f7cb530a-9e60-412c-a5bc-205a2f34ba54",
"type": "port"
}
},
"pod_terminal": {
"data": {
"id": "b859f5c3-8515-41da-bf20-39c0a5ada887",
"type": "terminal"
}
},
"destination": {
"data": {
"id": "e1e492f6-c8ba-45a9-ad1a-67a7e74547ce",
"type": "port"
}
},
"destination_terminal": {
"data": null
},
"line_tracking_stopped_by_user": {
"data": null
},
"containers": {
"data": [
{
"id": "55a700e4-7005-45a9-92fd-1ff38641dbd9",
"type": "container"
}
]
}
}
},
"links": {
"self": "https://api.terminal49.com/v2/shipments/02b1bd6f-407c-45bb-8645-06e7ee34e7e3?include=containers"
},
"included": [
{
"id": "55a700e4-7005-45a9-92fd-1ff38641dbd9",
"type": "container",
"attributes": {
"number": "CAIU7432986",
"seal_number": null,
"created_at": "2024-06-26T15:05:21Z",
"ref_numbers": [],
"pod_arrived_at": null,
"pod_discharged_at": "2024-06-22T04:00:00Z",
"final_destination_full_out_at": null,
"holds_at_pod_terminal": [],
"available_for_pickup": true,
"equipment_type": "dry",
"equipment_length": 40,
"equipment_height": "high_cube",
"weight_in_lbs": null,
"pod_full_out_at": null,
"empty_terminated_at": null,
"terminal_checked_at": "2024-06-26T17:51:12Z",
"fees_at_pod_terminal": [],
"pickup_lfd": "2024-07-07T04:00:00Z",
"pickup_appointment_at": null,
"pod_full_out_chassis_number": null,
"location_at_pod_terminal": "Yard - Y0709A",
"pod_last_tracking_request_at": "2024-06-26T17:51:12Z",
"shipment_last_tracking_request_at": "2024-06-26T15:05:20Z",
"availability_known": true,
"pod_timezone": "America/New_York",
"final_destination_timezone": "US/Eastern",
"empty_terminated_timezone": "US/Eastern",
"pod_rail_carrier_scac": "CSXT",
"ind_rail_carrier_scac": "CSXT",
"pod_rail_loaded_at": null,
"pod_rail_departed_at": null,
"ind_eta_at": null,
"ind_ata_at": null,
"ind_rail_unloaded_at": null,
"ind_facility_lfd_on": null
},
"relationships": {
"shipment": {
"data": {
"id": "02b1bd6f-407c-45bb-8645-06e7ee34e7e3",
"type": "shipment"
}
},
"pickup_facility": {
"data": null
},
"pod_terminal": {
"data": {
"id": "b859f5c3-8515-41da-bf20-39c0a5ada887",
"type": "terminal"
}
},
"transport_events": {
"data": [
{
"id": "45b542cb-332b-4684-b915-42e3a0759823",
"type": "transport_event"
},
{
"id": "174ed528-a1a9-4002-aef0-f2c9369199da",
"type": "transport_event"
},
{
"id": "7a2f30a6-a756-4c14-9477-fbfc1c7fe2f8",
"type": "transport_event"
},
{
"id": "e7365004-175a-46e8-96cd-dbed0f3daf21",
"type": "transport_event"
},
{
"id": "7c567bf3-7f01-4a3d-a176-eaa1f7165585",
"type": "transport_event"
}
]
},
"raw_events": {
"data": [
{
"id": "2956f71c-bfb9-4e49-b9e2-1b4d53c74cac",
"type": "raw_event"
},
{
"id": "391e0eda-65b5-4fc3-a53d-25ecd9570259",
"type": "raw_event"
},
{
"id": "74810c04-6c8a-4194-8cff-52936584a965",
"type": "raw_event"
},
{
"id": "4b1500e2-b23b-4896-87bd-c38b1d16f385",
"type": "raw_event"
},
{
"id": "8b9a7d88-720a-4304-8c1e-a3336e39f481",
"type": "raw_event"
},
{
"id": "bf1f59c5-5dd8-4013-87f9-d7056bc87114",
"type": "raw_event"
}
]
}
}
}
]
}