Get Shipment Details
This API returns a detailed response for a given load. This API can be used to fetch exhaustive tracking and reference information.
Rate Limit
1 request per second
Format Supported
JSON
Authenticated Resource
API Key
For more information on Authentication, click here.
This endpoint includes shipments shared with your account by other companies on the FourKites network. Shared loads are returned alongside your own shipments and are identifiable via the shipper field in the response. This behavior is consistent across both GET /shipments and GET /shipment-details/{id}.
You can also filter by Load Number. The following block holds request params with Load Number:
curl --request GET \
--url https://api.fourkites.com/shipments/449061769 \
--header 'apikey: REPLACE_KEY_VALUE'
For Product Line Items field descriptions, see the Product Line Items Reference.
Request Attributes
Name | Param Type | Format | Default | Description |
|---|---|---|---|---|
fourKitesShipmentID | Path | String | NA | fourKitesShipmentID is a FourKites generated identifier for a shipment that is returned as part of the shipment list and detailed response. |
loadNumber | Path | String | NA | Load or Shipment Number. This is the same as what is shown in the FourKites Web Application. |
Response Attributes
Shipment Detail
Name | Format | Default | Description |
|---|---|---|---|
Fields in Shipment | | NA | |
tags | String Array | NA | Custom tags associated with a load to search or filter. |
trackingIdentifiers | NA | The Identifiers used for tracking the Shipment. |
Tracking Identifiers
Name | Format | Default | Description |
|---|---|---|---|
truckNumber | String | NA | The truck number associated with the load. |
trailerNumber | String | NA | The trailer number associated with the load. |
driver | NA | The driver details used for tracking. | |
railEquipment | NA | The Rail Equipment details used for tracking. | |
vessel | NA | The Vessel details used of tracking. | |
containerNumber | String | NA | The Container number used for tracking. |
Driver
Name | Format | Default | Description |
|---|---|---|---|
id | String | NA | FourKites® identifier to a driver used for tracking. |
phone | String | NA | Phone number of the Driver used for Tracking. |
Rail Equipment
Name | Format | Default | Description |
|---|---|---|---|
initials | String | NA | Short form of Rail identifier used for tracking. |
number | String | NA | Rail identifier used for tracking. |
Vessel
Name | Format | Default | Description |
|---|---|---|---|
imo | String | NA | The International Maritime Organization (IMO) number used for tracking. |
mmsi | String | NA | Maritime Mobile Service Identity used for tracking. |
name | String | NA | Vessel Name used for tracking. |
Stop Detail
Name | Format | Default | Description |
|---|---|---|---|
Fields in Stop | | NA | |
address | String | NA | The address of the stop. |
shipTo | String | NA | The customer (shipper) given identifier of the facility to shipTo. |
arrivalTime | Timestamp in ISO8601/RFC3339 format with timezone. | NA | The Arrival Time at the stop. |
departureTime | Timestamp in ISO8601/RFC3339 format with timezone | NA | The Departure Time at the stop. |
dwellDurationInMinutes | Integer | NA | The dwell time at the stop. |
fourKitesEta | Timestamp in ISO8601/RFC3339 format with timezone | NA | ETA to the last delivery stop. We will map the last delivery stop ETA to this field. Note: If the load is Delivered we may not have the ETA on the last Delivery stop and the field will be nil |
geoFence | NA | The Geo-Fence used for tracking pickup/delivery to the stop. | |
shipmentIdentifiers | NA | The load Identifiers associated with the particular stop only. |
Geo-Fence
Name | Format | Default | Description |
|---|---|---|---|
points | Array of Points | NA | The locations that form the polygon Geo-Fence. |
radiusInMeters | Integer | NA | The radius of the circle for circular geo-fences. |
Point
Name | Format | Default | Description |
|---|---|---|---|
latitude | Float | NA | The latitude of the locations that make up the geofence boundary. |
longitude | Float | NA | The longitude of the locations that make up the geofence boundary. |
Product Line Items
Field Name | Data Type | Constraints | Description |
|---|---|---|---|
productId | VARCHAR | Mandatory if productLineItems object is present | Unique identifier for the product |
productName | VARCHAR(255) | Not Null | Display name of the product |
productDescription | TEXT | Optional | Detailed description of the product |
productCategory | VARCHAR(100) | Optional | Category classification of the product |
quantity | INTEGER | Not Null, >= 0 | Number of units in the shipment |
measurementUnitCode | VARCHAR(10) | Not Null | Unit of measurement for quantity (e.g., PCE, KG, LB) |
netWeight | DECIMAL(10,3) | Optional | Weight of the product excluding packaging |
weightUnit | VARCHAR(10) | Optional | Unit of measurement for weight (e.g., KGM, LBM) |
unitCost | DECIMAL(14,2) | Optional | Cost per unit of the product |
currencyCode | CHAR(3) | ISO 4217 | Currency code for cost fields |
extendedCost | DECIMAL(14,2) | Optional | Total cost for all units (unitCost × quantity) |
freightCost | DECIMAL(14,2) | Optional | Freight cost allocated to this line item |
bestBeforeDate | TIMESTAMP | Optional | Expiration or best before date for the product |
additionalCharges | DECIMAL(14,2) | Optional | Any additional charges specific to this line item |
tariffCost | DECIMAL(14,2) | Optional | Tariff cost for this specific line item |
fourKitesCalculatedTariffCost | DECIMAL(14,2) | Optional | System-calculated tariff cost |
totalLandedCost | DECIMAL(14,2) | Optional | Total landed cost for this line item |
countryOfOrigin | CHAR(2) | ISO 3166-1 | Country of origin for this product |
harmonizedSystemCode | VARCHAR(12) | Optional | International trade classification code |
commodityTypeCode | VARCHAR(50) | Optional | Commodity classification code |
htsusCode | VARCHAR(12) | Optional | Harmonized Tariff Schedule code for US imports |
orderNumber | VARCHAR(50) | Optional | Purchase order number |
deliveryNumber | VARCHAR(50) | Optional | Delivery reference number |
handlingUnitId | VARCHAR(50) | Optional | Identifier for the handling unit (pallet, box, etc.) |
barcode | VARCHAR(50) | GS1-compliant | Product barcode |
containerType | VARCHAR(20) | Optional | Type of container (pallet, box, carton, etc.) |
gtin | VARCHAR(14) | Optional | Global Trade Item Number |
customerPartNumber | VARCHAR(100) | Optional | Customer's part number for the product |
supplierPartNumber | VARCHAR(100) | Optional | Supplier's part number for the product |
manufacturerPartNumber | VARCHAR(100) | Optional | Manufacturer's part number |
itemNumber | VARCHAR(50) | Optional | Internal item number |
productUpc | VARCHAR(15) | Optional | Universal Product Code |
deliveryReferences | JSONB | Optional | Array of delivery reference numbers |
orderReferences | JSONB | Optional | Array of order reference numbers |
brandName | VARCHAR(100) | Optional | Brand name of the product |
minimumTemperature | INTEGER | Optional | Minimum storage/transport temperature |
maximumTemperature | INTEGER | Optional | Maximum storage/transport temperature |
temperatureUnitCode | VARCHAR(10) | Optional | Temperature unit (cel, fah) |
labelIdentifier | VARCHAR(100) | Optional | Label identifier for tracking |
productTrackingNumber | VARCHAR(100) | Optional | Unique tracking number for the product |
deviceType | VARCHAR(50) | Optional | Type of tracking device (RFID_TAG, QR_CODE, etc.) |