Single Delivery
5 min
Create Load API allows authorized users to create a new load for tracking. It is ideally called after the carrier has accepted the tender for the load.
⚠️ Important Update:
The Pallets structure is being deprecated. Please transition to for product details. Learn more
This API is called after the carrier has accepted the tender for the load. FourKites does not limit customers from creating more than one load with the same load number or PRO number -- creation of more than one load with the same load or PRO number will cause duplication of loads, which will end up affecting the tracking performance. Customers are advised to handle this on their side. To learn more about Idempotency Protection, refer here.
If you receive a server error (5xx error code), please try again a few times. It's best to wait a little longer between each retry attempt. Try at least 3-5 times before giving up, as many server issues resolve themselves quickly.
Supporting Document: Create Shipment
Rate Limit
1 request per second
Format Supported
JSON
Authenticated Resource
API Key
For more information on Authentication, click here.
Production
POST
https://api.fourkites.com/api/v1/tracking
import http.client
import json
conn = http.client.HTTPSConnection("api.fourkites.com")
payload = json.dumps({
"load": {
"carrierPermalink": "support-carrier-production",
"carrierName": "Support Carrier (Production)",
"carrier": "cc79",
"haulType": [
"inbound_load"
],
"loadNumber": "TestCreateSingle",
"displayLoadNumber": "TestCreate2",
"billOfLading": "billOfLading",
"bookingNumber": "bookingNumber",
"priority": "high",
"masterSequenceNumber": "1",
"masterReferenceNumber": "7328623",
"simultaneousTrackingReferenceNumber": "11223344",
"simultaneousTrackingSequenceNumber": 1,
"proNumber": "991",
"products": [
{
"lowerTemperatureThreshold": "20",
"name": "Produce",
"productId": "0123456",
"setTemperature": "28",
"timeToleranceInMinutes": "30",
"upperTemperatureThreshold": "34"
}
],
"referenceNumbers": [
"ref1",
"ref2"
],
"relayLoad": False,
"stops": [
{
"addressLine1": "500 West Madison Street",
"addressLine2": "Floor 33",
"city": "Chicago",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"00210123OF-203503"
],
"pointOfContact": {
"alert": False,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2024-10-11T01:00:00",
"earliestWantTime": "2024-10-11T01:00:00",
"externalAddressId": "100",
"latestAppointmentTime": "2024-10-11T02:00:00",
"latestWantTime": "2024-10-12T02:00:00",
"name": "FourKites HQ",
"loadingType": "drop",
"pallets": [
{
"billOfLading": "BOL123",
"number": "123444444",
"parts": [
{
"customerPartNumber": "123-FCOSS",
"orderNumber": "123",
"quantity": "1",
"shipperPartNumber": "1259924",
"weight": "41.92 LB",
"description": "Material description 1"
},
{
"customerPartNumber": "65-2333SS",
"orderNumber": "123",
"quantity": "21",
"shipperPartNumber": "59924",
"weight": "880.32 LB",
"description": "Material description 2"
},
{
"customerPartNumber": "65-24DGOSS",
"orderNumber": "123",
"quantity": "22",
"shipperPartNumber": "1924",
"weight": "922.24 LB",
"description": "Material description 3"
},
{
"customerPartNumber": "65-24S",
"orderNumber": "123",
"quantity": "15",
"shipperPartNumber": "1255524",
"weight": "628.8 LB",
"description": "Material description 4"
}
]
}
],
"postalCode": "60611",
"referenceNumbers": [
"1234567",
"2412422222",
"PalletNumber:54831396"
],
"sequence": 1,
"shipTo": "1234",
"state": "IL",
"stopReferenceId": "123",
"stopType": "pickup",
"trackingNumber": "123456789",
"unloadTimeInMinutes": 120,
"productLineItems": [
{
"productId": "0123456",
"productName": "Produce",
"productDescription": "Fresh produce shipment",
"productCategory": "Perishable",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 12.5,
"currencyCode": "USD",
"extendedCost": 1250,
"freightCost": 45,
"bestBeforeDate": "2024-10-20T08:00:00Z",
"additionalCharges": 10,
"tariffCost": 5,
"fourKitesCalculatedTariffCost": 5,
"totalLandedCost": 1310,
"countryOfOrigin": "US",
"harmonizedSystemCode": "0709999090",
"commodityTypeCode": "PRODUCE",
"htsusCode": "0709999090",
"orderNumber": "123",
"deliveryNumber": "DN-123",
"handlingUnitId": "PLT-123444444",
"barcode": "123444444",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "123-FCOSS",
"supplierPartNumber": "1259924",
"manufacturerPartNumber": "MFG-0123456",
"itemNumber": "ITM-0123456",
"productUpc": "123444444",
"deliveryReferences": [
"DEL-REF-001"
],
"orderReferences": [
"ORD-REF-001"
],
"brandName": "FreshFarms",
"minimumTemperature": 20,
"maximumTemperature": 34,
"temperatureUnitCode": "fah",
"labelIdentifier": "LBL-0123456",
"productTrackingNumber": "123456789",
"deviceType": "RFID_TAG"
}
]
},
{
"addressLine1": "1001 E 17th Street",
"addressLine2": "",
"city": "Bloomington",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"00210123OF-203503"
],
"pointOfContact": {
"alert": False,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2024-10-11T05:00:00",
"externalAddressId": "200",
"latestAppointmentTime": "2024-10-11T06:00:00",
"name": "Assembly Hall",
"pallets": [
{
"billOfLading": "BOL123",
"number": "123444444",
"parts": [
{
"customerPartNumber": "123-FCOSS",
"orderNumber": "123",
"quantity": "1",
"shipperPartNumber": "1259924",
"weight": "41.92 LB",
"description": "Material description 1"
},
{
"customerPartNumber": "65-2333SS",
"orderNumber": "123",
"quantity": "21",
"shipperPartNumber": "59924",
"weight": "880.32 LB",
"description": "Material description 2"
},
{
"customerPartNumber": "65-24DGOSS",
"orderNumber": "123",
"quantity": "22",
"shipperPartNumber": "1924",
"weight": "922.24 LB",
"description": "Material description 3"
},
{
"customerPartNumber": "65-24S",
"orderNumber": "123",
"quantity": "15",
"shipperPartNumber": "1255524",
"weight": "628.8 LB",
"description": "Material description 4"
}
]
}
],
"postalCode": "47408",
"referenceNumbers": [
"1234567",
"2412422222",
"PalletNumber:54831396"
],
"sequence": 2,
"state": "IN",
"stopReferenceId": "9876",
"stopType": "delivery",
"trackingNumber": "123456789",
"unloadTimeInMinutes": 150,
"wantTime": "2024-10-12T13:00:00Z",
"productLineItems": [
{
"productId": "0123456",
"productName": "Produce",
"productDescription": "Fresh produce shipment",
"productCategory": "Perishable",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 12.5,
"currencyCode": "USD",
"extendedCost": 1250,
"freightCost": 45,
"additionalCharges": 10,
"tariffCost": 5,
"fourKitesCalculatedTariffCost": 5,
"totalLandedCost": 1310,
"countryOfOrigin": "US",
"harmonizedSystemCode": "0709999090",
"commodityTypeCode": "PRODUCE",
"htsusCode": "0709999090",
"orderNumber": "123",
"deliveryNumber": "DN-123",
"handlingUnitId": "PLT-123444444",
"barcode": "123444444",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "123-FCOSS",
"supplierPartNumber": "1259924",
"manufacturerPartNumber": "MFG-0123456",
"itemNumber": "ITM-0123456",
"productUpc": "123444444",
"deliveryReferences": [
"DEL-REF-001"
],
"orderReferences": [
"ORD-REF-001"
],
"brandName": "FreshFarms",
"minimumTemperature": 20,
"maximumTemperature": 34,
"temperatureUnitCode": "fah",
"labelIdentifier": "LBL-0123456",
"productTrackingNumber": "123456789",
"deviceType": "QR_CODE"
}
]
}
],
"tags": [
"Tag1",
"Tag2",
"Tag3"
],
"trackingInfo": {
"deviceId": "12356",
"driverId": "999",
"driverPhone": "+19999999999",
"mawb": "17233144555",
"trailerNumber": "123",
"truckNumber": "456"
},
"trackingNumber": "123456789",
"truckRoutingParams": {
"height": "4.145",
"length": "14.63",
"limitedWeight": "996",
"shippedHazardousGoods": "flammable",
"trailersCount": 0,
"truckType": "truck",
"tunnelCategory": "C",
"weightPerAxle": "498",
"width": "2.438"
},
"seal": "XYZ123",
"sealStatus": "XYZ123"
}
})
headers = {
'Content-Type': 'application/json',
'apikey': 'REPLACE_KEY_VALUE'
}
conn.request("POST", "/api/v1/tracking", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))Staging
POST
https://api-staging.fourkites.com/api/v1/tracking
import http.client
import json
conn = http.client.HTTPSConnection("api-staging.fourkites.com")
payload = json.dumps({
"load": {
"carrierPermalink": "support-carrier-production",
"carrierName": "Support Carrier (Production)",
"carrier": "cc79",
"haulType": [
"inbound_load"
],
"loadNumber": "TestCreateSingle",
"displayLoadNumber": "TestCreate2",
"billOfLading": "billOfLading",
"bookingNumber": "bookingNumber",
"priority": "high",
"masterSequenceNumber": "1",
"masterReferenceNumber": "7328623",
"simultaneousTrackingReferenceNumber": "11223344",
"simultaneousTrackingSequenceNumber": 1,
"proNumber": "991",
"products": [
{
"lowerTemperatureThreshold": "20",
"name": "Produce",
"productId": "0123456",
"setTemperature": "28",
"timeToleranceInMinutes": "30",
"upperTemperatureThreshold": "34"
}
],
"referenceNumbers": [
"ref1",
"ref2"
],
"relayLoad": False,
"stops": [
{
"addressLine1": "500 West Madison Street",
"addressLine2": "Floor 33",
"city": "Chicago",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"00210123OF-203503"
],
"pointOfContact": {
"alert": False,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2024-10-11T01:00:00",
"earliestWantTime": "2024-10-11T01:00:00",
"externalAddressId": "100",
"latestAppointmentTime": "2024-10-11T02:00:00",
"latestWantTime": "2024-10-12T02:00:00",
"name": "FourKites HQ",
"loadingType": "drop",
"pallets": [
{
"billOfLading": "BOL123",
"number": "123444444",
"parts": [
{
"customerPartNumber": "123-FCOSS",
"orderNumber": "123",
"quantity": "1",
"shipperPartNumber": "1259924",
"weight": "41.92 LB",
"description": "Material description 1"
},
{
"customerPartNumber": "65-2333SS",
"orderNumber": "123",
"quantity": "21",
"shipperPartNumber": "59924",
"weight": "880.32 LB",
"description": "Material description 2"
},
{
"customerPartNumber": "65-24DGOSS",
"orderNumber": "123",
"quantity": "22",
"shipperPartNumber": "1924",
"weight": "922.24 LB",
"description": "Material description 3"
},
{
"customerPartNumber": "65-24S",
"orderNumber": "123",
"quantity": "15",
"shipperPartNumber": "1255524",
"weight": "628.8 LB",
"description": "Material description 4"
}
]
}
],
"postalCode": "60611",
"referenceNumbers": [
"1234567",
"2412422222",
"PalletNumber:54831396"
],
"sequence": 1,
"shipTo": "1234",
"state": "IL",
"stopReferenceId": "123",
"stopType": "pickup",
"trackingNumber": "123456789",
"unloadTimeInMinutes": 120,
"productLineItems": [
{
"productId": "0123456",
"productName": "Produce",
"productDescription": "Fresh produce shipment",
"productCategory": "Perishable",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 12.5,
"currencyCode": "USD",
"extendedCost": 1250,
"freightCost": 45,
"bestBeforeDate": "2024-10-20T08:00:00Z",
"additionalCharges": 10,
"tariffCost": 5,
"fourKitesCalculatedTariffCost": 5,
"totalLandedCost": 1310,
"countryOfOrigin": "US",
"harmonizedSystemCode": "0709999090",
"commodityTypeCode": "PRODUCE",
"htsusCode": "0709999090",
"orderNumber": "123",
"deliveryNumber": "DN-123",
"handlingUnitId": "PLT-123444444",
"barcode": "123444444",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "123-FCOSS",
"supplierPartNumber": "1259924",
"manufacturerPartNumber": "MFG-0123456",
"itemNumber": "ITM-0123456",
"productUpc": "123444444",
"deliveryReferences": [
"DEL-REF-001"
],
"orderReferences": [
"ORD-REF-001"
],
"brandName": "FreshFarms",
"minimumTemperature": 20,
"maximumTemperature": 34,
"temperatureUnitCode": "fah",
"labelIdentifier": "LBL-0123456",
"productTrackingNumber": "123456789",
"deviceType": "RFID_TAG"
}
]
},
{
"addressLine1": "1001 E 17th Street",
"addressLine2": "",
"city": "Bloomington",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"00210123OF-203503"
],
"pointOfContact": {
"alert": False,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2024-10-11T05:00:00",
"externalAddressId": "200",
"latestAppointmentTime": "2024-10-11T06:00:00",
"name": "Assembly Hall",
"pallets": [
{
"billOfLading": "BOL123",
"number": "123444444",
"parts": [
{
"customerPartNumber": "123-FCOSS",
"orderNumber": "123",
"quantity": "1",
"shipperPartNumber": "1259924",
"weight": "41.92 LB",
"description": "Material description 1"
},
{
"customerPartNumber": "65-2333SS",
"orderNumber": "123",
"quantity": "21",
"shipperPartNumber": "59924",
"weight": "880.32 LB",
"description": "Material description 2"
},
{
"customerPartNumber": "65-24DGOSS",
"orderNumber": "123",
"quantity": "22",
"shipperPartNumber": "1924",
"weight": "922.24 LB",
"description": "Material description 3"
},
{
"customerPartNumber": "65-24S",
"orderNumber": "123",
"quantity": "15",
"shipperPartNumber": "1255524",
"weight": "628.8 LB",
"description": "Material description 4"
}
]
}
],
"postalCode": "47408",
"referenceNumbers": [
"1234567",
"2412422222",
"PalletNumber:54831396"
],
"sequence": 2,
"state": "IN",
"stopReferenceId": "9876",
"stopType": "delivery",
"trackingNumber": "123456789",
"unloadTimeInMinutes": 150,
"wantTime": "2024-10-12T13:00:00Z",
"productLineItems": [
{
"productId": "0123456",
"productName": "Produce",
"productDescription": "Fresh produce shipment",
"productCategory": "Perishable",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 12.5,
"currencyCode": "USD",
"extendedCost": 1250,
"freightCost": 45,
"additionalCharges": 10,
"tariffCost": 5,
"fourKitesCalculatedTariffCost": 5,
"totalLandedCost": 1310,
"countryOfOrigin": "US",
"harmonizedSystemCode": "0709999090",
"commodityTypeCode": "PRODUCE",
"htsusCode": "0709999090",
"orderNumber": "123",
"deliveryNumber": "DN-123",
"handlingUnitId": "PLT-123444444",
"barcode": "123444444",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "123-FCOSS",
"supplierPartNumber": "1259924",
"manufacturerPartNumber": "MFG-0123456",
"itemNumber": "ITM-0123456",
"productUpc": "123444444",
"deliveryReferences": [
"DEL-REF-001"
],
"orderReferences": [
"ORD-REF-001"
],
"brandName": "FreshFarms",
"minimumTemperature": 20,
"maximumTemperature": 34,
"temperatureUnitCode": "fah",
"labelIdentifier": "LBL-0123456",
"productTrackingNumber": "123456789",
"deviceType": "QR_CODE"
}
]
}
],
"tags": [
"Tag1",
"Tag2",
"Tag3"
],
"trackingInfo": {
"deviceId": "12356",
"driverId": "999",
"driverPhone": "+19999999999",
"mawb": "17233144555",
"trailerNumber": "123",
"truckNumber": "456"
},
"trackingNumber": "123456789",
"truckRoutingParams": {
"height": "4.145",
"length": "14.63",
"limitedWeight": "996",
"shippedHazardousGoods": "flammable",
"trailersCount": 0,
"truckType": "truck",
"tunnelCategory": "C",
"weightPerAxle": "498",
"width": "2.438"
},
"seal": "XYZ123",
"sealStatus": "XYZ123"
}
})
headers = {
'Content-Type': 'application/json',
'apikey': 'REPLACE_KEY_VALUE'
}
conn.request("POST", "/api/v1/tracking", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))Azure - Production
POST
https://api.ng.fourkites.com/api/v1/tracking
curl --location --request POST 'https://api.ng.fourkites.com/api/v1/tracking' \
--header 'Content-Type: application/json' \
--header 'apikey: REPLACE_KEY_VALUE' \
--data-raw '{
"load": {
"carrierPermalink": "support-carrier-production",
"carrierName": "Support Carrier (Production)",
"carrier": "cc79",
"haulType": [
"inbound_load"
],
"loadNumber": "TestCreateSingle",
"displayLoadNumber": "TestCreate2",
"billOfLading": "billOfLading",
"bookingNumber": "bookingNumber",
"priority": "high",
"masterSequenceNumber": "1",
"masterReferenceNumber": "7328623",
"simultaneousTrackingReferenceNumber": "11223344",
"simultaneousTrackingSequenceNumber": 1,
"proNumber": "991",
"products": [
{
"lowerTemperatureThreshold": "20",
"name": "Produce",
"productId": "0123456",
"setTemperature": "28",
"timeToleranceInMinutes": "30",
"upperTemperatureThreshold": "34"
}
],
"referenceNumbers": [
"ref1",
"ref2"
],
"relayLoad": false,
"stops": [
{
"addressLine1": "500 West Madison Street",
"addressLine2": "Floor 33",
"city": "Chicago",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"00210123OF-203503"
],
"pointOfContact": {
"alert": false,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2024-10-11T01:00:00",
"earliestWantTime": "2024-10-11T01:00:00",
"externalAddressId": "100",
"latestAppointmentTime": "2024-10-11T02:00:00",
"latestWantTime": "2024-10-12T02:00:00",
"name": "FourKites HQ",
"loadingType": "drop",
"pallets": [
{
"billOfLading": "BOL123",
"number": "123444444",
"parts": [
{
"customerPartNumber": "123-FCOSS",
"orderNumber": "123",
"quantity": "1",
"shipperPartNumber": "1259924",
"weight": "41.92 LB",
"description": "Material description 1"
},
{
"customerPartNumber": "65-2333SS",
"orderNumber": "123",
"quantity": "21",
"shipperPartNumber": "59924",
"weight": "880.32 LB",
"description": "Material description 2"
},
{
"customerPartNumber": "65-24DGOSS",
"orderNumber": "123",
"quantity": "22",
"shipperPartNumber": "1924",
"weight": "922.24 LB",
"description": "Material description 3"
},
{
"customerPartNumber": "65-24S",
"orderNumber": "123",
"quantity": "15",
"shipperPartNumber": "1255524",
"weight": "628.8 LB",
"description": "Material description 4"
}
]
}
],
"postalCode": "60611",
"referenceNumbers": [
"1234567",
"2412422222",
"PalletNumber:54831396"
],
"sequence": 1,
"shipTo": "1234",
"state": "IL",
"stopReferenceId": "123",
"stopType": "pickup",
"trackingNumber": "123456789",
"unloadTimeInMinutes": 120,
"productLineItems": [
{
"productId": "0123456",
"productName": "Produce",
"productDescription": "Fresh produce shipment",
"productCategory": "Perishable",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 12.5,
"currencyCode": "USD",
"extendedCost": 1250.00,
"freightCost": 45.00,
"bestBeforeDate": "2024-10-20T08:00:00Z",
"additionalCharges": 10.00,
"tariffCost": 5.00,
"fourKitesCalculatedTariffCost": 5.00,
"totalLandedCost": 1310.00,
"countryOfOrigin": "US",
"harmonizedSystemCode": "0709999090",
"commodityTypeCode": "PRODUCE",
"htsusCode": "0709999090",
"orderNumber": "123",
"deliveryNumber": "DN-123",
"handlingUnitId": "PLT-123444444",
"barcode": "123444444",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "123-FCOSS",
"supplierPartNumber": "1259924",
"manufacturerPartNumber": "MFG-0123456",
"itemNumber": "ITM-0123456",
"productUpc": "123444444",
"deliveryReferences": ["DEL-REF-001"],
"orderReferences": ["ORD-REF-001"],
"brandName": "FreshFarms",
"minimumTemperature": 20,
"maximumTemperature": 34,
"temperatureUnitCode": "fah",
"labelIdentifier": "LBL-0123456",
"productTrackingNumber": "123456789",
"deviceType": "RFID_TAG"
}
]
},
{
"addressLine1": "1001 E 17th Street",
"addressLine2": "",
"city": "Bloomington",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"00210123OF-203503"
],
"pointOfContact": {
"alert": false,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2024-10-11T05:00:00",
"externalAddressId": "200",
"latestAppointmentTime": "2024-10-11T06:00:00",
"name": "Assembly Hall",
"pallets": [
{
"billOfLading": "BOL123",
"number": "123444444",
"parts": [
{
"customerPartNumber": "123-FCOSS",
"orderNumber": "123",
"quantity": "1",
"shipperPartNumber": "1259924",
"weight": "41.92 LB",
"description": "Material description 1"
},
{
"customerPartNumber": "65-2333SS",
"orderNumber": "123",
"quantity": "21",
"shipperPartNumber": "59924",
"weight": "880.32 LB",
"description": "Material description 2"
},
{
"customerPartNumber": "65-24DGOSS",
"orderNumber": "123",
"quantity": "22",
"shipperPartNumber": "1924",
"weight": "922.24 LB",
"description": "Material description 3"
},
{
"customerPartNumber": "65-24S",
"orderNumber": "123",
"quantity": "15",
"shipperPartNumber": "1255524",
"weight": "628.8 LB",
"description": "Material description 4"
}
]
}
],
"postalCode": "47408",
"referenceNumbers": [
"1234567",
"2412422222",
"PalletNumber:54831396"
],
"sequence": 2,
"state": "IN",
"stopReferenceId": "9876",
"stopType": "delivery",
"trackingNumber": "123456789",
"unloadTimeInMinutes": 150,
"wantTime": "2024-10-12T13:00:00Z",
"productLineItems": [
{
"productId": "0123456",
"productName": "Produce",
"productDescription": "Fresh produce shipment",
"productCategory": "Perishable",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 12.5,
"currencyCode": "USD",
"extendedCost": 1250.00,
"freightCost": 45.00,
"additionalCharges": 10.00,
"tariffCost": 5.00,
"fourKitesCalculatedTariffCost": 5.00,
"totalLandedCost": 1310.00,
"countryOfOrigin": "US",
"harmonizedSystemCode": "0709999090",
"commodityTypeCode": "PRODUCE",
"htsusCode": "0709999090",
"orderNumber": "123",
"deliveryNumber": "DN-123",
"handlingUnitId": "PLT-123444444",
"barcode": "123444444",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "123-FCOSS",
"supplierPartNumber": "1259924",
"manufacturerPartNumber": "MFG-0123456",
"itemNumber": "ITM-0123456",
"productUpc": "123444444",
"deliveryReferences": ["DEL-REF-001"],
"orderReferences": ["ORD-REF-001"],
"brandName": "FreshFarms",
"minimumTemperature": 20,
"maximumTemperature": 34,
"temperatureUnitCode": "fah",
"labelIdentifier": "LBL-0123456",
"productTrackingNumber": "123456789",
"deviceType": "QR_CODE"
}
]
}
],
"tags": [
"Tag1",
"Tag2",
"Tag3"
],
"trackingInfo": {
"deviceId": "12356",
"driverId": "999",
"driverPhone": "+19999999999",
"mawb": "17233144555",
"trailerNumber": "123",
"truckNumber": "456"
},
"trackingNumber": "123456789",
"truckRoutingParams": {
"height": "4.145",
"length": "14.63",
"limitedWeight": "996",
"shippedHazardousGoods": "flammable",
"trailersCount": 0,
"truckType": "truck",
"tunnelCategory": "C",
"weightPerAxle": "498",
"width": "2.438"
},
"seal": "XYZ123",
"sealStatus": "XYZ123"
}
}'Azure - Staging
POST
https://api-staging.ng.fourkites.com/api/v1/tracking
curl --location --request POST 'https://api-staging.ng.fourkites.com/api/v1/tracking' \
--header 'Content-Type: application/json' \
--header 'apikey: REPLACE_KEY_VALUE' \
--data-raw '{
"load": {
"carrierPermalink": "support-carrier-production",
"carrierName": "Support Carrier (Production)",
"carrier": "cc79",
"haulType": [
"inbound_load"
],
"loadNumber": "TestCreateSingle",
"displayLoadNumber": "TestCreate2",
"billOfLading": "billOfLading",
"bookingNumber": "bookingNumber",
"priority": "high",
"masterSequenceNumber": "1",
"masterReferenceNumber": "7328623",
"simultaneousTrackingReferenceNumber": "11223344",
"simultaneousTrackingSequenceNumber": 1,
"proNumber": "991",
"products": [
{
"lowerTemperatureThreshold": "20",
"name": "Produce",
"productId": "0123456",
"setTemperature": "28",
"timeToleranceInMinutes": "30",
"upperTemperatureThreshold": "34"
}
],
"referenceNumbers": [
"ref1",
"ref2"
],
"relayLoad": false,
"stops": [
{
"addressLine1": "500 West Madison Street",
"addressLine2": "Floor 33",
"city": "Chicago",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"00210123OF-203503"
],
"pointOfContact": {
"alert": false,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2024-10-11T01:00:00",
"earliestWantTime": "2024-10-11T01:00:00",
"externalAddressId": "100",
"latestAppointmentTime": "2024-10-11T02:00:00",
"latestWantTime": "2024-10-12T02:00:00",
"name": "FourKites HQ",
"loadingType": "drop",
"pallets": [
{
"billOfLading": "BOL123",
"number": "123444444",
"parts": [
{
"customerPartNumber": "123-FCOSS",
"orderNumber": "123",
"quantity": "1",
"shipperPartNumber": "1259924",
"weight": "41.92 LB",
"description": "Material description 1"
},
{
"customerPartNumber": "65-2333SS",
"orderNumber": "123",
"quantity": "21",
"shipperPartNumber": "59924",
"weight": "880.32 LB",
"description": "Material description 2"
},
{
"customerPartNumber": "65-24DGOSS",
"orderNumber": "123",
"quantity": "22",
"shipperPartNumber": "1924",
"weight": "922.24 LB",
"description": "Material description 3"
},
{
"customerPartNumber": "65-24S",
"orderNumber": "123",
"quantity": "15",
"shipperPartNumber": "1255524",
"weight": "628.8 LB",
"description": "Material description 4"
}
]
}
],
"postalCode": "60611",
"referenceNumbers": [
"1234567",
"2412422222",
"PalletNumber:54831396"
],
"sequence": 1,
"shipTo": "1234",
"state": "IL",
"stopReferenceId": "123",
"stopType": "pickup",
"trackingNumber": "123456789",
"unloadTimeInMinutes": 120,
"productLineItems": [
{
"productId": "0123456",
"productName": "Produce",
"productDescription": "Fresh produce shipment",
"productCategory": "Perishable",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 12.5,
"currencyCode": "USD",
"extendedCost": 1250.00,
"freightCost": 45.00,
"bestBeforeDate": "2024-10-20T08:00:00Z",
"additionalCharges": 10.00,
"tariffCost": 5.00,
"fourKitesCalculatedTariffCost": 5.00,
"totalLandedCost": 1310.00,
"countryOfOrigin": "US",
"harmonizedSystemCode": "0709999090",
"commodityTypeCode": "PRODUCE",
"htsusCode": "0709999090",
"orderNumber": "123",
"deliveryNumber": "DN-123",
"handlingUnitId": "PLT-123444444",
"barcode": "123444444",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "123-FCOSS",
"supplierPartNumber": "1259924",
"manufacturerPartNumber": "MFG-0123456",
"itemNumber": "ITM-0123456",
"productUpc": "123444444",
"deliveryReferences": ["DEL-REF-001"],
"orderReferences": ["ORD-REF-001"],
"brandName": "FreshFarms",
"minimumTemperature": 20,
"maximumTemperature": 34,
"temperatureUnitCode": "fah",
"labelIdentifier": "LBL-0123456",
"productTrackingNumber": "123456789",
"deviceType": "RFID_TAG"
}
]
},
{
"addressLine1": "1001 E 17th Street",
"addressLine2": "",
"city": "Bloomington",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"00210123OF-203503"
],
"pointOfContact": {
"alert": false,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2024-10-11T05:00:00",
"externalAddressId": "200",
"latestAppointmentTime": "2024-10-11T06:00:00",
"name": "Assembly Hall",
"pallets": [
{
"billOfLading": "BOL123",
"number": "123444444",
"parts": [
{
"customerPartNumber": "123-FCOSS",
"orderNumber": "123",
"quantity": "1",
"shipperPartNumber": "1259924",
"weight": "41.92 LB",
"description": "Material description 1"
},
{
"customerPartNumber": "65-2333SS",
"orderNumber": "123",
"quantity": "21",
"shipperPartNumber": "59924",
"weight": "880.32 LB",
"description": "Material description 2"
},
{
"customerPartNumber": "65-24DGOSS",
"orderNumber": "123",
"quantity": "22",
"shipperPartNumber": "1924",
"weight": "922.24 LB",
"description": "Material description 3"
},
{
"customerPartNumber": "65-24S",
"orderNumber": "123",
"quantity": "15",
"shipperPartNumber": "1255524",
"weight": "628.8 LB",
"description": "Material description 4"
}
]
}
],
"postalCode": "47408",
"referenceNumbers": [
"1234567",
"2412422222",
"PalletNumber:54831396"
],
"sequence": 2,
"state": "IN",
"stopReferenceId": "9876",
"stopType": "delivery",
"trackingNumber": "123456789",
"unloadTimeInMinutes": 150,
"wantTime": "2024-10-12T13:00:00Z",
"productLineItems": [
{
"productId": "0123456",
"productName": "Produce",
"productDescription": "Fresh produce shipment",
"productCategory": "Perishable",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 12.5,
"currencyCode": "USD",
"extendedCost": 1250.00,
"freightCost": 45.00,
"additionalCharges": 10.00,
"tariffCost": 5.00,
"fourKitesCalculatedTariffCost": 5.00,
"totalLandedCost": 1310.00,
"countryOfOrigin": "US",
"harmonizedSystemCode": "0709999090",
"commodityTypeCode": "PRODUCE",
"htsusCode": "0709999090",
"orderNumber": "123",
"deliveryNumber": "DN-123",
"handlingUnitId": "PLT-123444444",
"barcode": "123444444",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "123-FCOSS",
"supplierPartNumber": "1259924",
"manufacturerPartNumber": "MFG-0123456",
"itemNumber": "ITM-0123456",
"productUpc": "123444444",
"deliveryReferences": ["DEL-REF-001"],
"orderReferences": ["ORD-REF-001"],
"brandName": "FreshFarms",
"minimumTemperature": 20,
"maximumTemperature": 34,
"temperatureUnitCode": "fah",
"labelIdentifier": "LBL-0123456",
"productTrackingNumber": "123456789",
"deviceType": "QR_CODE"
}
]
}
],
"tags": [
"Tag1",
"Tag2",
"Tag3"
],
"trackingInfo": {
"deviceId": "12356",
"driverId": "999",
"driverPhone": "+19999999999",
"mawb": "17233144555",
"trailerNumber": "123",
"truckNumber": "456"
},
"trackingNumber": "123456789",
"truckRoutingParams": {
"height": "4.145",
"length": "14.63",
"limitedWeight": "996",
"shippedHazardousGoods": "flammable",
"trailersCount": 0,
"truckType": "truck",
"tunnelCategory": "C",
"weightPerAxle": "498",
"width": "2.438"
},
"seal": "XYZ123",
"sealStatus": "XYZ123"
}
}'