Rail / Intermodal
4 min
To update your Rail/Intermodal load without any hassle, follow the instructions given within this document.
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.
Rate Limit
1 request per second
Format Supported
JSON
Authenticated Resource
API Key
For more information on Authentication, click here.
The FourKites internal loadId that is returned during load creation should be added to the endpoint to update the load. Click on the load that you would like to update to get the FourKites Internal LoadId as shown in the image below.
Production
PATCH
https://api.fourkites.com/api/v1/tracking/419367908
var settings = {
"url": "https://api.fourkites.com/api/v1/tracking/419367908",
"method": "PATCH",
"timeout": 0,
"headers": {
"Content-Type": "application/json",
"apikey": "REPLACE_KEY_VALUE"
},
"data": JSON.stringify({
"trackingInfo": {
"driverPhone": "",
"truckNumber": "",
"railEquipmentInitials": "RAIL",
"railEquipmentNumber": "654405",
"wagonNumber": "qwerty123"
},
"load": {
"loadNumber": "TestRail05",
"skipAppointmentTimeValidation": true,
"priority": "normal",
"carrier": "cc79",
"carrierPermalink": "support-carrier-production",
"carrierName": "Support Carrier (Production)",
"shipper": null,
"products": [],
"stops": [
{
"stopType": "pickup",
"completeAddress": "Chennai, TN - 600003, IN",
"city": "Chennai",
"state": "TN",
"country": "IN",
"postalCode": null,
"latitude": 13.0816437,
"longitude": 80.2752316,
"geofencePoints": [],
"appointmentTime": "2024-08-20T07:35:00.000Z",
"wantTime": null,
"earliestWantTime": null,
"latestWantTime": null,
"transportationMode": null,
"useLocalLatLng": true,
"pallets": [
{
"number": "PAL-001",
"parts": [
{
"quantity": "25",
"shipperPartNumber": "22EE",
"weight": "7.998"
}
]
}
],
"productLineItems": [
{
"productId": "0123456",
"productName": "Rail Freight Item",
"productDescription": "Rail/intermodal freight shipment item",
"productCategory": "General Freight",
"quantity": 25,
"measurementUnitCode": "PCE",
"netWeight": 44.8,
"weightUnit": "KGM",
"unitCost": 25.0,
"currencyCode": "USD",
"extendedCost": 625.00,
"freightCost": 20.00,
"additionalCharges": 5.00,
"tariffCost": 2.50,
"fourKitesCalculatedTariffCost": 2.50,
"totalLandedCost": 655.00,
"countryOfOrigin": "IN",
"harmonizedSystemCode": "8607911000",
"commodityTypeCode": "RAIL_FREIGHT",
"htsusCode": "8607911000",
"orderNumber": "TestRail05-1",
"deliveryNumber": "DN-PAL-001",
"handlingUnitId": "PAL-001",
"barcode": "PAL-001",
"containerType": "pallet",
"gtin": "00012345678905",
"customerPartNumber": "22EE",
"supplierPartNumber": "22EE",
"manufacturerPartNumber": "MFG-22EE",
"itemNumber": "ITM-22EE",
"productUpc": "012345678905",
"deliveryReferences": ["DEL-REF-001"],
"orderReferences": ["TestRail05-1"],
"brandName": "Generic Rail Freight Co",
"minimumTemperature": 0,
"maximumTemperature": 0,
"temperatureUnitCode": "cel",
"labelIdentifier": "LBL-22EE",
"productTrackingNumber": "RAIL-STOP-001",
"deviceType": "RFID_TAG"
}
]
},
{
"stopType": "delivery",
"completeAddress": "Bengaluru, KA - 560002, IN",
"city": "Bengaluru",
"state": "KA",
"country": "IN",
"postalCode": "78738",
"latitude": 12.96643,
"longitude": 77.58718,
"geofencePoints": [],
"appointmentTime": "2024-08-29T07:35:00.000Z",
"wantTime": null,
"earliestWantTime": null,
"latestWantTime": null,
"transportationMode": null,
"addressType": "",
"useLocalLatLng": true,
"pallets": [
{
"number": "PAL-002",
"parts": [
{
"quantity": "25",
"shipperPartNumber": "22EE",
"weight": "7.998"
}
]
}
],
"productLineItems": [
{
"productId": "0654321",
"productName": "Rail Freight Item",
"productDescription": "Rail/intermodal freight shipment item",
"productCategory": "General Freight",
"quantity": 25,
"measurementUnitCode": "PCE",
"netWeight": 44.8,
"weightUnit": "KGM",
"unitCost": 25.0,
"currencyCode": "USD",
"extendedCost": 625.00,
"freightCost": 20.00,
"additionalCharges": 5.00,
"tariffCost": 2.50,
"fourKitesCalculatedTariffCost": 2.50,
"totalLandedCost": 655.00,
"countryOfOrigin": "IN",
"harmonizedSystemCode": "8607911000",
"commodityTypeCode": "RAIL_FREIGHT",
"htsusCode": "8607911000",
"orderNumber": "TestRail05-2",
"deliveryNumber": "DN-PAL-002",
"handlingUnitId": "PAL-002",
"barcode": "PAL-002",
"containerType": "pallet",
"gtin": "00012345678905",
"customerPartNumber": "22EE",
"supplierPartNumber": "22EE",
"manufacturerPartNumber": "MFG-22EE",
"itemNumber": "ITM-22EE",
"productUpc": "012345678905",
"deliveryReferences": ["DEL-REF-001"],
"orderReferences": ["TestRail05-2"],
"brandName": "Generic Rail Freight Co",
"minimumTemperature": 0,
"maximumTemperature": 0,
"temperatureUnitCode": "cel",
"labelIdentifier": "LBL-22EE",
"productTrackingNumber": "RAIL-STOP-002",
"deviceType": "QR_CODE"
}
]
}
]
}
}),
};
$.ajax(settings).done(function (response) {
console.log(response);
});Staging
PATCH
https://api-staging.fourkites.com/api/v1/tracking/419367908
curl --location --request PATCH 'https://api-staging.fourkites.com/api/v1/tracking/419367908' \
--header 'Content-Type: application/json' \
--header 'apikey: REPLACE_KEY_VALUE' \
--data-raw '{
"trackingInfo": {
"driverPhone": "",
"truckNumber": "",
"railEquipmentInitials": "RAIL",
"railEquipmentNumber": "654405",
"wagonNumber": "qwerty123"
},
"load": {
"loadNumber": "TestRail05",
"skipAppointmentTimeValidation": true,
"priority": "normal",
"carrier": "cc79",
"carrierPermalink": "support-carrier-production",
"carrierName": "Support Carrier (Production)",
"shipper": null,
"products": [],
"stops": [
{
"stopType": "pickup",
"completeAddress": "Chennai, TN - 600003, IN",
"city": "Chennai",
"state": "TN",
"country": "IN",
"postalCode": null,
"latitude": 13.0816437,
"longitude": 80.2752316,
"geofencePoints": [],
"appointmentTime": "2024-08-20T07:35:00.000Z",
"wantTime": null,
"earliestWantTime": null,
"latestWantTime": null,
"transportationMode": null,
"useLocalLatLng": true,
"pallets": [
{
"number": "PAL-001",
"parts": [
{
"quantity": "25",
"shipperPartNumber": "22EE",
"weight": "7.998"
}
]
}
],
"productLineItems": [
{
"productId": "0123456",
"productName": "Rail Freight Item",
"productDescription": "Rail/intermodal freight shipment item",
"productCategory": "General Freight",
"quantity": 25,
"measurementUnitCode": "PCE",
"netWeight": 44.8,
"weightUnit": "KGM",
"unitCost": 25.0,
"currencyCode": "USD",
"extendedCost": 625.00,
"freightCost": 20.00,
"additionalCharges": 5.00,
"tariffCost": 2.50,
"fourKitesCalculatedTariffCost": 2.50,
"totalLandedCost": 655.00,
"countryOfOrigin": "IN",
"harmonizedSystemCode": "8607911000",
"commodityTypeCode": "RAIL_FREIGHT",
"htsusCode": "8607911000",
"orderNumber": "TestRail05-1",
"deliveryNumber": "DN-PAL-001",
"handlingUnitId": "PAL-001",
"barcode": "PAL-001",
"containerType": "pallet",
"gtin": "00012345678905",
"customerPartNumber": "22EE",
"supplierPartNumber": "22EE",
"manufacturerPartNumber": "MFG-22EE",
"itemNumber": "ITM-22EE",
"productUpc": "012345678905",
"deliveryReferences": ["DEL-REF-001"],
"orderReferences": ["TestRail05-1"],
"brandName": "Generic Rail Freight Co",
"minimumTemperature": 0,
"maximumTemperature": 0,
"temperatureUnitCode": "cel",
"labelIdentifier": "LBL-22EE",
"productTrackingNumber": "RAIL-STOP-001",
"deviceType": "RFID_TAG"
}
]
},
{
"stopType": "delivery",
"completeAddress": "Bengaluru, KA - 560002, IN",
"city": "Bengaluru",
"state": "KA",
"country": "IN",
"postalCode": "78738",
"latitude": 12.96643,
"longitude": 77.58718,
"geofencePoints": [],
"appointmentTime": "2024-08-29T07:35:00.000Z",
"wantTime": null,
"earliestWantTime": null,
"latestWantTime": null,
"transportationMode": null,
"addressType": "",
"useLocalLatLng": true,
"pallets": [
{
"number": "PAL-002",
"parts": [
{
"quantity": "25",
"shipperPartNumber": "22EE",
"weight": "7.998"
}
]
}
],
"productLineItems": [
{
"productId": "0654321",
"productName": "Rail Freight Item",
"productDescription": "Rail/intermodal freight shipment item",
"productCategory": "General Freight",
"quantity": 25,
"measurementUnitCode": "PCE",
"netWeight": 44.8,
"weightUnit": "KGM",
"unitCost": 25.0,
"currencyCode": "USD",
"extendedCost": 625.00,
"freightCost": 20.00,
"additionalCharges": 5.00,
"tariffCost": 2.50,
"fourKitesCalculatedTariffCost": 2.50,
"totalLandedCost": 655.00,
"countryOfOrigin": "IN",
"harmonizedSystemCode": "8607911000",
"commodityTypeCode": "RAIL_FREIGHT",
"htsusCode": "8607911000",
"orderNumber": "TestRail05-2",
"deliveryNumber": "DN-PAL-002",
"handlingUnitId": "PAL-002",
"barcode": "PAL-002",
"containerType": "pallet",
"gtin": "00012345678905",
"customerPartNumber": "22EE",
"supplierPartNumber": "22EE",
"manufacturerPartNumber": "MFG-22EE",
"itemNumber": "ITM-22EE",
"productUpc": "012345678905",
"deliveryReferences": ["DEL-REF-001"],
"orderReferences": ["TestRail05-2"],
"brandName": "Generic Rail Freight Co",
"minimumTemperature": 0,
"maximumTemperature": 0,
"temperatureUnitCode": "cel",
"labelIdentifier": "LBL-22EE",
"productTrackingNumber": "RAIL-STOP-002",
"deviceType": "QR_CODE"
}
]
}
]
}
}'