Async Standard API
5 min
Async standard API allows customers to post standard load create/update requests to create loads for any modes in an asynchronous way. This API will process the payload asynchronously and create/update the load.
The load will get created if the company doesn’t have any matching loads for the given load number. Otherwise, the existing load will be updated.
Rate Limit
60/min.
Format Supported
JSON
Authenticated Resource
API Key
Production
POST
https://api.fourkites.com/api/v1/tracking/async
curl --location 'https://api.fourkites.com/api/v1/tracking/async' \
--header 'Content-Type: application/json' \
--header 'apikey: REPLACE_KEY_VALUE' \
--data-raw '{
"additionalData": {
"modeDetails": {
"shipperModes": "TL",
"carrierModes": ""
}
},
"load": {
"carrierPermalink": "insights-carrier-6870",
"carrierName": "Insights Carrier",
"carrier": "IC68",
"haulType": [
"inbound_load"
],
"loadNumber": "KDPKDLTEST09",
"displayLoadNumber": "KDPKDLTEST09",
"billOfLading": "billOfLading",
"bookingNumber": "bookingNumber",
"priority": "high",
"masterSequenceNumber": "1",
"masterReferenceNumber": "7328623",
"simultaneousTrackingReferenceNumber": "simul123",
"simultaneousTrackingSequenceNumber": 1,
"proNumber": "991",
"cost": {
"productCost": 410.00,
"extendedCost": 1200.00,
"freightCost": 45.50,
"additionalCost": 23.20,
"tariffCost": 85.00,
"landedCost": 1353.70,
"countryOfOrigin": "CN",
"currency": "USD",
"fourkitesCalculatedTariffCost": null
},
"products": [
{
"lowerTemperatureThreshold": "-10",
"name": "Premium Auto Parts Kit",
"productId": "rohit-123/78^*",
"setTemperature": "25",
"timeToleranceInMinutes": "30",
"upperTemperatureThreshold": "60",
"temperatureUnitCode": "cel"
},
{
"lowerTemperatureThreshold": "-10",
"name": "Electronic Control Module",
"productId": "PROD-56789",
"setTemperature": "25",
"timeToleranceInMinutes": "30",
"upperTemperatureThreshold": "60",
"temperatureUnitCode": "cel"
}
],
"referenceNumbers": [
"PO-2025-4567",
"DN-789012",
"PO-2025-5678",
"DN-345678"
],
"relayLoad": false,
"stops": [
{
"stopId": "1529659839",
"addressLine1": "500 West Madison Street",
"addressLine2": "Floor 33",
"city": "Chicago",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"PO-2025-4567"
],
"customerPoFields": [
{
"deliveryNumber": "DN-789012",
"deliveryReference": "DEL-REF-001",
"orderReference": "ORD-REF-001"
}
],
"pointOfContact": {
"alert": false,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2025-11-11T01:00:00",
"earliestWantTime": "2025-11-11T01:00:00",
"externalAddressId": "100",
"latestAppointmentTime": "2025-11-11T02:00:00",
"latestWantTime": "2025-11-11T02:00:00",
"name": "FourKites HQ",
"loadingType": "drop",
"productLineItems": [
{
"productId": "rohit-123/78^*",
"productName": "Premium Auto Parts Kit",
"productDescription": "Complete automotive parts assembly kit including filters, belts, and gaskets",
"productCategory": "Automotive Parts",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 85.50,
"currencyCode": "USD",
"extendedCost": 8550.00,
"freightCost": 125.00,
"bestBeforeDate": "2025-07-15T08:10:00Z",
"additionalCharges": 500.00,
"tariffCost": 200.00,
"fourKitesCalculatedTariffCost": 1951.75,
"totalLandedCost": 8925.00,
"countryOfOrigin": "US",
"harmonizedSystemCode": "8708293000",
"commodityTypeCode": "AUTO_PARTS",
"htsusCode": "8708293000",
"orderNumber": "PO-2025-4567",
"deliveryNumber": "DN-789012",
"handlingUnitId": "PLT-001234",
"barcode": "123456789012",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "CUST-AP-001",
"supplierPartNumber": "SUPP-KIT-789",
"manufacturerPartNumber": "MFG-APK-456",
"itemNumber": "ITM-001234",
"productUpc": "123456789012",
"deliveryReferences": ["DEL-REF-001", "DEL-REF-002"],
"orderReferences": ["ORD-REF-001"],
"brandName": "AutoPro",
"minimumTemperature": -10,
"maximumTemperature": 60,
"temperatureUnitCode": "cel",
"labelIdentifier": "LBL-AP-001234",
"productTrackingNumber": "TRK-789456123",
"deviceType": "RFID_TAG"
}
],
"postalCode": "60611",
"referenceNumbers": [
"DEL-REF-001",
"DEL-REF-002",
"TRK-789456123"
],
"sequence": 1,
"shipTo": "1234",
"state": "IL",
"stopReferenceId": "1529659839",
"stopType": "pickup",
"trackingNumber": "TRK-789456123",
"unloadTimeInMinutes": 120
},
{
"stopId": "1529659852",
"addressLine1": "1001 E 17th Street",
"addressLine2": "",
"city": "Bloomington",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"PO-2025-4567",
"PO-2025-5678"
],
"pointOfContact": {
"alert": false,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2025-11-11T05:00:00",
"externalAddressId": "200",
"latestAppointmentTime": "2025-11-11T06:00:00",
"name": "Assembly Hall",
"productLineItems": [
{
"productId": "PROD-1234512",
"productName": "Premium Auto Parts Kit",
"productDescription": "Complete automotive parts assembly kit including filters, belts, and gaskets",
"productCategory": "Automotive Parts",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 85.50,
"currencyCode": "USD",
"extendedCost": 8550.00,
"freightCost": 125.00,
"additionalCharges": 50.00,
"tariffCost": 200.00,
"fourKitesCalculatedTariffCost": 195.75,
"totalLandedCost": 8925.00,
"countryOfOrigin": "US",
"harmonizedSystemCode": "8708293000",
"commodityTypeCode": "AUTO_PARTS",
"htsusCode": "8708293000",
"orderNumber": "PO-2025-4567",
"deliveryNumber": "DN-789012",
"handlingUnitId": "PLT-001234",
"barcode": "123456789012",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "CUST-AP-001",
"supplierPartNumber": "SUPP-KIT-789",
"manufacturerPartNumber": "MFG-APK-456",
"itemNumber": "ITM-001234",
"productUpc": "123456789012",
"deliveryReferences": ["DEL-REF-001", "DEL-REF-002"],
"orderReferences": ["ORD-REF-001"],
"brandName": "AutoPro",
"minimumTemperature": -10,
"maximumTemperature": 60,
"temperatureUnitCode": "cel",
"labelIdentifier": "LBL-AP-001234",
"productTrackingNumber": "TRK-789456123",
"deviceType": "RFID_TAG"
},
{
"productId": "PROD-56789",
"productName": "Electronic Control Module",
"productDescription": "Advanced electronic control unit for automotive applications",
"productCategory": "Electronics",
"quantity": 25,
"measurementUnitCode": "PCE",
"netWeight": 12.5,
"weightUnit": "KGM",
"unitCost": 450.00,
"currencyCode": "USD",
"extendedCost": 11250.00,
"freightCost": 75.00,
"totalLandedCost": 11325.00,
"countryOfOrigin": "CN",
"harmonizedSystemCode": "8537109900",
"orderNumber": "PO-2025-5678",
"deliveryNumber": "DN-345678",
"handlingUnitId": "BOX-002345",
"barcode": "234567890123",
"containerType": "box",
"gtin": "09876543210987",
"customerPartNumber": "CUST-ECM-002",
"supplierPartNumber": "SUPP-ECM-890",
"brandName": "TechControl",
"labelIdentifier": "LBL-ECM-002345",
"productTrackingNumber": "TRK-890123456",
"deviceType": "QR_CODE"
}
],
"postalCode": "47408",
"referenceNumbers": [
"DEL-REF-001",
"DEL-REF-002",
"TRK-789456123",
"TRK-890123456"
],
"sequence": 2,
"state": "IN",
"stopReferenceId": "1529659852",
"stopType": "delivery",
"trackingNumber": "TRK-890123456",
"unloadTimeInMinutes": 150,
"wantTime": "2021-11-11T13:00:00Z"
}
],
"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"
}
}'Staging
POST
https://api-staging.fourkites.com/api/v1/tracking/async
curl --location 'https://api-staging.fourkites.com/api/v1/tracking/async' \
--header 'Content-Type: application/json' \
--header 'apikey: REPLACE_KEY_VALUE' \
--data-raw '{
"additionalData": {
"modeDetails": {
"shipperModes": "TL",
"carrierModes": ""
}
},
"load": {
"carrierPermalink": "insights-carrier-6870",
"carrierName": "Insights Carrier",
"carrier": "IC68",
"haulType": [
"inbound_load"
],
"loadNumber": "KDPKDLTEST09",
"displayLoadNumber": "KDPKDLTEST09",
"billOfLading": "billOfLading",
"bookingNumber": "bookingNumber",
"priority": "high",
"masterSequenceNumber": "1",
"masterReferenceNumber": "7328623",
"simultaneousTrackingReferenceNumber": "simul123",
"simultaneousTrackingSequenceNumber": 1,
"proNumber": "991",
"cost": {
"productCost": 410.00,
"extendedCost": 1200.00,
"freightCost": 45.50,
"additionalCost": 23.20,
"tariffCost": 85.00,
"landedCost": 1353.70,
"countryOfOrigin": "CN",
"currency": "USD",
"fourkitesCalculatedTariffCost": null
},
"products": [
{
"lowerTemperatureThreshold": "-10",
"name": "Premium Auto Parts Kit",
"productId": "rohit-123/78^*",
"setTemperature": "25",
"timeToleranceInMinutes": "30",
"upperTemperatureThreshold": "60",
"temperatureUnitCode": "cel"
},
{
"lowerTemperatureThreshold": "-10",
"name": "Electronic Control Module",
"productId": "PROD-56789",
"setTemperature": "25",
"timeToleranceInMinutes": "30",
"upperTemperatureThreshold": "60",
"temperatureUnitCode": "cel"
}
],
"referenceNumbers": [
"PO-2025-4567",
"DN-789012",
"PO-2025-5678",
"DN-345678"
],
"relayLoad": false,
"stops": [
{
"stopId": "1529659839",
"addressLine1": "500 West Madison Street",
"addressLine2": "Floor 33",
"city": "Chicago",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"PO-2025-4567"
],
"customerPoFields": [
{
"deliveryNumber": "DN-789012",
"deliveryReference": "DEL-REF-001",
"orderReference": "ORD-REF-001"
}
],
"pointOfContact": {
"alert": false,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2025-11-11T01:00:00",
"earliestWantTime": "2025-11-11T01:00:00",
"externalAddressId": "100",
"latestAppointmentTime": "2025-11-11T02:00:00",
"latestWantTime": "2025-11-11T02:00:00",
"name": "FourKites HQ",
"loadingType": "drop",
"productLineItems": [
{
"productId": "rohit-123/78^*",
"productName": "Premium Auto Parts Kit",
"productDescription": "Complete automotive parts assembly kit including filters, belts, and gaskets",
"productCategory": "Automotive Parts",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 85.50,
"currencyCode": "USD",
"extendedCost": 8550.00,
"freightCost": 125.00,
"bestBeforeDate": "2025-07-15T08:10:00Z",
"additionalCharges": 500.00,
"tariffCost": 200.00,
"fourKitesCalculatedTariffCost": 1951.75,
"totalLandedCost": 8925.00,
"countryOfOrigin": "US",
"harmonizedSystemCode": "8708293000",
"commodityTypeCode": "AUTO_PARTS",
"htsusCode": "8708293000",
"orderNumber": "PO-2025-4567",
"deliveryNumber": "DN-789012",
"handlingUnitId": "PLT-001234",
"barcode": "123456789012",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "CUST-AP-001",
"supplierPartNumber": "SUPP-KIT-789",
"manufacturerPartNumber": "MFG-APK-456",
"itemNumber": "ITM-001234",
"productUpc": "123456789012",
"deliveryReferences": ["DEL-REF-001", "DEL-REF-002"],
"orderReferences": ["ORD-REF-001"],
"brandName": "AutoPro",
"minimumTemperature": -10,
"maximumTemperature": 60,
"temperatureUnitCode": "cel",
"labelIdentifier": "LBL-AP-001234",
"productTrackingNumber": "TRK-789456123",
"deviceType": "RFID_TAG"
}
],
"postalCode": "60611",
"referenceNumbers": [
"DEL-REF-001",
"DEL-REF-002",
"TRK-789456123"
],
"sequence": 1,
"shipTo": "1234",
"state": "IL",
"stopReferenceId": "1529659839",
"stopType": "pickup",
"trackingNumber": "TRK-789456123",
"unloadTimeInMinutes": 120
},
{
"stopId": "1529659852",
"addressLine1": "1001 E 17th Street",
"addressLine2": "",
"city": "Bloomington",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"PO-2025-4567",
"PO-2025-5678"
],
"pointOfContact": {
"alert": false,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2025-11-11T05:00:00",
"externalAddressId": "200",
"latestAppointmentTime": "2025-11-11T06:00:00",
"name": "Assembly Hall",
"productLineItems": [
{
"productId": "PROD-1234512",
"productName": "Premium Auto Parts Kit",
"productDescription": "Complete automotive parts assembly kit including filters, belts, and gaskets",
"productCategory": "Automotive Parts",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 85.50,
"currencyCode": "USD",
"extendedCost": 8550.00,
"freightCost": 125.00,
"additionalCharges": 50.00,
"tariffCost": 200.00,
"fourKitesCalculatedTariffCost": 195.75,
"totalLandedCost": 8925.00,
"countryOfOrigin": "US",
"harmonizedSystemCode": "8708293000",
"commodityTypeCode": "AUTO_PARTS",
"htsusCode": "8708293000",
"orderNumber": "PO-2025-4567",
"deliveryNumber": "DN-789012",
"handlingUnitId": "PLT-001234",
"barcode": "123456789012",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "CUST-AP-001",
"supplierPartNumber": "SUPP-KIT-789",
"manufacturerPartNumber": "MFG-APK-456",
"itemNumber": "ITM-001234",
"productUpc": "123456789012",
"deliveryReferences": ["DEL-REF-001", "DEL-REF-002"],
"orderReferences": ["ORD-REF-001"],
"brandName": "AutoPro",
"minimumTemperature": -10,
"maximumTemperature": 60,
"temperatureUnitCode": "cel",
"labelIdentifier": "LBL-AP-001234",
"productTrackingNumber": "TRK-789456123",
"deviceType": "RFID_TAG"
},
{
"productId": "PROD-56789",
"productName": "Electronic Control Module",
"productDescription": "Advanced electronic control unit for automotive applications",
"productCategory": "Electronics",
"quantity": 25,
"measurementUnitCode": "PCE",
"netWeight": 12.5,
"weightUnit": "KGM",
"unitCost": 450.00,
"currencyCode": "USD",
"extendedCost": 11250.00,
"freightCost": 75.00,
"totalLandedCost": 11325.00,
"countryOfOrigin": "CN",
"harmonizedSystemCode": "8537109900",
"orderNumber": "PO-2025-5678",
"deliveryNumber": "DN-345678",
"handlingUnitId": "BOX-002345",
"barcode": "234567890123",
"containerType": "box",
"gtin": "09876543210987",
"customerPartNumber": "CUST-ECM-002",
"supplierPartNumber": "SUPP-ECM-890",
"brandName": "TechControl",
"labelIdentifier": "LBL-ECM-002345",
"productTrackingNumber": "TRK-890123456",
"deviceType": "QR_CODE"
}
],
"postalCode": "47408",
"referenceNumbers": [
"DEL-REF-001",
"DEL-REF-002",
"TRK-789456123",
"TRK-890123456"
],
"sequence": 2,
"state": "IN",
"stopReferenceId": "1529659852",
"stopType": "delivery",
"trackingNumber": "TRK-890123456",
"unloadTimeInMinutes": 150,
"wantTime": "2021-11-11T13:00:00Z"
}
],
"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 - Production
POST
https://api.ng.fourkites.com/api/v1/tracking/async
curl --location 'https://api.ng.fourkites.com/api/v1/tracking/async' \
--header 'Content-Type: application/json' \
--header 'apikey: REPLACE_KEY_VALUE' \
--data-raw '{
"additionalData": {
"modeDetails": {
"shipperModes": "TL",
"carrierModes": ""
}
},
"load": {
"carrierPermalink": "insights-carrier-6870",
"carrierName": "Insights Carrier",
"carrier": "IC68",
"haulType": [
"inbound_load"
],
"loadNumber": "KDPKDLTEST09",
"displayLoadNumber": "KDPKDLTEST09",
"billOfLading": "billOfLading",
"bookingNumber": "bookingNumber",
"priority": "high",
"masterSequenceNumber": "1",
"masterReferenceNumber": "7328623",
"simultaneousTrackingReferenceNumber": "simul123",
"simultaneousTrackingSequenceNumber": 1,
"proNumber": "991",
"cost": {
"productCost": 410.00,
"extendedCost": 1200.00,
"freightCost": 45.50,
"additionalCost": 23.20,
"tariffCost": 85.00,
"landedCost": 1353.70,
"countryOfOrigin": "CN",
"currency": "USD",
"fourkitesCalculatedTariffCost": null
},
"products": [
{
"lowerTemperatureThreshold": "-10",
"name": "Premium Auto Parts Kit",
"productId": "rohit-123/78^*",
"setTemperature": "25",
"timeToleranceInMinutes": "30",
"upperTemperatureThreshold": "60",
"temperatureUnitCode": "cel"
},
{
"lowerTemperatureThreshold": "-10",
"name": "Electronic Control Module",
"productId": "PROD-56789",
"setTemperature": "25",
"timeToleranceInMinutes": "30",
"upperTemperatureThreshold": "60",
"temperatureUnitCode": "cel"
}
],
"referenceNumbers": [
"PO-2025-4567",
"DN-789012",
"PO-2025-5678",
"DN-345678"
],
"relayLoad": false,
"stops": [
{
"stopId": "1529659839",
"addressLine1": "500 West Madison Street",
"addressLine2": "Floor 33",
"city": "Chicago",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"PO-2025-4567"
],
"customerPoFields": [
{
"deliveryNumber": "DN-789012",
"deliveryReference": "DEL-REF-001",
"orderReference": "ORD-REF-001"
}
],
"pointOfContact": {
"alert": false,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2025-11-11T01:00:00",
"earliestWantTime": "2025-11-11T01:00:00",
"externalAddressId": "100",
"latestAppointmentTime": "2025-11-11T02:00:00",
"latestWantTime": "2025-11-11T02:00:00",
"name": "FourKites HQ",
"loadingType": "drop",
"productLineItems": [
{
"productId": "rohit-123/78^*",
"productName": "Premium Auto Parts Kit",
"productDescription": "Complete automotive parts assembly kit including filters, belts, and gaskets",
"productCategory": "Automotive Parts",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 85.50,
"currencyCode": "USD",
"extendedCost": 8550.00,
"freightCost": 125.00,
"bestBeforeDate": "2025-07-15T08:10:00Z",
"additionalCharges": 500.00,
"tariffCost": 200.00,
"fourKitesCalculatedTariffCost": 1951.75,
"totalLandedCost": 8925.00,
"countryOfOrigin": "US",
"harmonizedSystemCode": "8708293000",
"commodityTypeCode": "AUTO_PARTS",
"htsusCode": "8708293000",
"orderNumber": "PO-2025-4567",
"deliveryNumber": "DN-789012",
"handlingUnitId": "PLT-001234",
"barcode": "123456789012",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "CUST-AP-001",
"supplierPartNumber": "SUPP-KIT-789",
"manufacturerPartNumber": "MFG-APK-456",
"itemNumber": "ITM-001234",
"productUpc": "123456789012",
"deliveryReferences": ["DEL-REF-001", "DEL-REF-002"],
"orderReferences": ["ORD-REF-001"],
"brandName": "AutoPro",
"minimumTemperature": -10,
"maximumTemperature": 60,
"temperatureUnitCode": "cel",
"labelIdentifier": "LBL-AP-001234",
"productTrackingNumber": "TRK-789456123",
"deviceType": "RFID_TAG"
}
],
"postalCode": "60611",
"referenceNumbers": [
"DEL-REF-001",
"DEL-REF-002",
"TRK-789456123"
],
"sequence": 1,
"shipTo": "1234",
"state": "IL",
"stopReferenceId": "1529659839",
"stopType": "pickup",
"trackingNumber": "TRK-789456123",
"unloadTimeInMinutes": 120
},
{
"stopId": "1529659852",
"addressLine1": "1001 E 17th Street",
"addressLine2": "",
"city": "Bloomington",
"country": "US",
"customer": {
"id": "789789",
"name": "sample name 12",
"poNumbers": [
"PO-2025-4567",
"PO-2025-5678"
],
"pointOfContact": {
"alert": false,
"email": "[email protected]",
"name": "John Doe",
"phone": "+19999999999"
}
},
"earliestAppointmentTime": "2025-11-11T05:00:00",
"externalAddressId": "200",
"latestAppointmentTime": "2025-11-11T06:00:00",
"name": "Assembly Hall",
"productLineItems": [
{
"productId": "PROD-1234512",
"productName": "Premium Auto Parts Kit",
"productDescription": "Complete automotive parts assembly kit including filters, belts, and gaskets",
"productCategory": "Automotive Parts",
"quantity": 100,
"measurementUnitCode": "PCE",
"netWeight": 250.5,
"weightUnit": "KGM",
"unitCost": 85.50,
"currencyCode": "USD",
"extendedCost": 8550.00,
"freightCost": 125.00,
"additionalCharges": 50.00,
"tariffCost": 200.00,
"fourKitesCalculatedTariffCost": 195.75,
"totalLandedCost": 8925.00,
"countryOfOrigin": "US",
"harmonizedSystemCode": "8708293000",
"commodityTypeCode": "AUTO_PARTS",
"htsusCode": "8708293000",
"orderNumber": "PO-2025-4567",
"deliveryNumber": "DN-789012",
"handlingUnitId": "PLT-001234",
"barcode": "123456789012",
"containerType": "pallet",
"gtin": "01234567890123",
"customerPartNumber": "CUST-AP-001",
"supplierPartNumber": "SUPP-KIT-789",
"manufacturerPartNumber": "MFG-APK-456",
"itemNumber": "ITM-001234",
"productUpc": "123456789012",
"deliveryReferences": ["DEL-REF-001", "DEL-REF-002"],
"orderReferences": ["ORD-REF-001"],
"brandName": "AutoPro",
"minimumTemperature": -10,
"maximumTemperature": 60,
"temperatureUnitCode": "cel",
"labelIdentifier": "LBL-AP-001234",
"productTrackingNumber": "TRK-789456123",
"deviceType": "RFID_TAG"
},
{
"productId": "PROD-56789",
"productName": "Electronic Control Module",
"productDescription": "Advanced electronic control unit for automotive applications",
"productCategory": "Electronics",
"quantity": 25,
"measurementUnitCode": "PCE",
"netWeight": 12.5,
"weightUnit": "KGM",
"unitCost": 450.00,
"currencyCode": "USD",
"extendedCost": 11250.00,
"freightCost": 75.00,
"totalLandedCost": 11325.00,
"countryOfOrigin": "CN",
"harmonizedSystemCode": "8537109900",
"orderNumber": "PO-2025-5678",
"deliveryNumber": "DN-345678",
"handlingUnitId": "BOX-002345",
"barcode": "234567890123",
"containerType": "box",
"gtin": "09876543210987",
"customerPartNumber": "CUST-ECM-002",
"supplierPartNumber": "SUPP-ECM-890",
"brandName": "TechControl",
"labelIdentifier": "LBL-ECM-002345",
"productTrackingNumber": "TRK-890123456",
"deviceType": "QR_CODE"
}
],
"postalCode": "47408",
"referenceNumbers": [
"DEL-REF-001",
"DEL-REF-002",
"TRK-789456123",
"TRK-890123456"
],
"sequence": 2,
"state": "IN",
"stopReferenceId": "1529659852",
"stopType": "delivery",
"trackingNumber": "TRK-890123456",
"unloadTimeInMinutes": 150,
"wantTime": "2021-11-11T13:00:00Z"
}
],
"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/async
let parameters = "{\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"masterSequenceNumber\": \"1\",\n \"masterReferenceNumber\": \"7328623\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410.00,\n \"extendedCost\": 1200.00,\n \"freightCost\": 45.50,\n \"additionalCost\": 23.20,\n \"tariffCost\": 85.00,\n \"landedCost\": 1353.70,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": null\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"[email protected]\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2025-11-11T01:00:00\",\n \"earliestWantTime\": \"2025-11-11T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2025-11-11T02:00:00\",\n \"latestWantTime\": \"2025-11-11T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"[email protected]\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2025-11-11T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2025-11-11T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"additionalCharges\": 50.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450.00,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250.00,\n \"freightCost\": 75.00,\n \"totalLandedCost\": 11325.00,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\", \n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2021-11-11T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n}"
let postData = parameters.data(using: .utf8)
var request = URLRequest(url: URL(string: "https://api-staging.ng.fourkites.com/api/v1/tracking/async")!,timeoutInterval: Double.infinity)
request.addValue("application/json", forHTTPHeaderField: "Content-Type")
request.addValue("REPLACE_KEY_VALUE", forHTTPHeaderField: "apikey")
request.httpMethod = "POST"
request.httpBody = postData
let task = URLSession.shared.dataTask(with: request) { data, response, error in
guard let data = data else {
print(String(describing: error))
return
}
print(String(data: data, encoding: .utf8)!)
}
task.resume()
Success or Error Codes
Code Type | Code | Status Message | Steps to Resolve |
|---|---|---|---|
Success | 200 | Accepted | - |
Error | 400 | { "status": "BAD_REQUEST", "timestamp": "2021-12-02T08:59:31.168+00:00", "message": "Validation Errors", "subErrors": [ { "field": "loadNumber", "rejectValue": "", "message": "provide load number" } ] } | The validation errors will come in the response of 400 error with the invalid field names. Check fields mentioned in the response and send valid values. |
Error | 401 | { "message": "Invalid authentication credentials" } | Check your token |