Sync Delivery API
2 min
From receiving goods to picking up and packing orders for shipments, the warehouses perform a variety of such tasks. Traditionally, these functions could be managed by separate software systems, leading to data silos and inefficiencies. With Delivery API, customers can now send warehouse signals to our Order Visibility solution to aggregate data at a single place & eliminate data silos.
currently, FourKites can consume delivery updates only if the order is created. orderID must be created for sending the delivery updates -- refer here for orderID creation.
Note: All date fields in this API use UTC exclusively.
Production
PUT
https://api.fourkites.com/delivery
curl --location --request PUT 'https://api.fourkites.com/delivery' \
--header 'Content-Type: application/json' \
--header 'apikey: <YOUR_API_KEY>' \
--data-raw '[
{
"deliveryID": "DEL-2025-001234",
"deliveryStatus": "Scheduled",
"deliveryType": "Inbound",
"eventTime": "2025-07-24T10:30:00Z",
"requestedWarehouseAppointmentTime": "2025-07-25T14:00:00Z",
"warehouseAppointmentTime": "2025-07-25T14:30:00Z",
"eventSource": "wms",
"trailerNumber": "TRL-45678",
"shipmentNumber": "SHIP-TX-789012",
"simpleUpdate": "true",
"referenceNumbers":[{
"type": "key",
"value":"value"
}],
"shipmentReferenceNumbers": [
"183927125",
"183927126",
"183927127"
],
"plannedPickupDate": "2025-07-25T08:00:00Z",
"plannedDeliveryDate": "2025-07-25T16:00:00Z",
"deliveryOrigin": {
"gln": "0860001234567",
"id": "DC-DAL-001",
"name": "Walmart Distribution Center Dallas",
"contact": {
"departmentName": "Shipping Department",
"personName": "John Smith",
"responsibility": "Shipping Manager",
"communicationChannel": [
{
"communicationChannelCode": "EMAIL",
"communicationValue": "[email protected]"
},
{
"communicationChannelCode": "PHONE",
"communicationValue": "+1-214-555-0123"
}
]
},
"address": {
"addressLine1": "1500 Distribution Way",
"addressLine2": "Building A, Dock 12",
"city": "Dallas",
"state": "TX",
"country": "USA",
"zip": "75247",
"name": "Walmart DC Dallas"
},
"organisationName": "Walmart Distribution Services"
},
"deliveryDestination": {
"gln": "0860009876543",
"id": "STR-AUS-045",
"name": "Walmart Supercenter #045",
"contact": {
"departmentName": "Receiving Department",
"personName": "Maria Garcia",
"responsibility": "Receiving Manager",
"communicationChannel": [
{
"communicationChannelCode": "EMAIL",
"communicationValue": "[email protected]"
},
{
"communicationChannelCode": "PHONE",
"communicationValue": "+1-512-555-0456"
}
]
},
"address": {
"addressLine1": "9900 S Interstate 35",
"addressLine2": "Receiving Dock B",
"city": "Austin",
"state": "TX",
"country": "USA",
"zip": "78748",
"name": "Walmart Supercenter Austin"
},
"organisationName": "Walmart Inc."
},
"avpList": {
"temperatureControlled": "true"
},
"caseLevelDetails": [
{
"packageID": "CASE-2025-07-24-001",
"description": "Organic Whole Milk - 1 Gallon",
"linePackageQty": 4,
"qtyUom": "GAL",
"packageType": "Crate",
"packageDimensions": "16x12x10",
"linePackageWt": "34.0",
"packageNetWt": "32.0",
"packageGrossWt": "34.5",
"wtUom": "LBS",
"packageTiHi": "8x6",
"lineLotNumber": "LOT-MLK-20250720",
"lineBatchNumber": "BATCH-7245",
"lineManufactureDate": "2025-07-20",
"lineExpiry": "2025-08-03",
"lineCountryOfOrigin": "USA"
},
{
"packageID": "CASE-2025-07-24-002",
"description": "Greek Yogurt Variety Pack - 32oz",
"linePackageQty": 12,
"qtyUom": "EA",
"packageType": "Box",
"packageDimensions": "20x15x8",
"linePackageWt": "26.0",
"packageNetWt": "24.0",
"packageGrossWt": "26.5",
"wtUom": "LBS",
"packageTiHi": "10x8",
"lineLotNumber": "LOT-YOG-20250721",
"lineBatchNumber": "BATCH-8956",
"lineManufactureDate": "2025-07-21",
"lineExpiry": "2025-08-20",
"lineCountryOfOrigin": "USA"
}
],
"externalUrl": [
{
"name": "TMS Tracking",
"url": "https://tracking.walmart-logistics.com/shipment/SHIP-TX-789012"
},
{
"name": "POD Document",
"url": "https://docs.walmart-logistics.com/pod/DEL-2025-001234"
}
],
"orderDetails": [
{
"orderID": "PO-2025-078945",
"lineDetails": [
{
"lineItemNumber": "001",
"productId": "PROD-MLK-001",
"sku": "SKU-681131123456",
"upc": "681131123456",
"quantity": "200",
"unitOfMeasure": "GAL",
"lotNumber": "LOT-MLK-20250720",
"manufactureDate": "2025-07-20",
"expirationDate": "2025-08-03",
"grade": "A",
"supplierHtsCode": "8471.30.01",
"caseLevelDetails": [
{
"packageID": "CASE-PACK-SHARED-LARGE",
"description": "Dell Laptop XPS 13 - Premium Business Laptops",
"linePackageQty": 10,
"noOfPackages": 5,
"qtyUom": "EA",
"packageType": "Reinforced Electronics Crate",
"packageDimensions": "24x18x12",
"linePackageWt": "2.64",
"packageNetWt": "26.4",
"packageGrossWt": "30.0",
"wtUom": "LBS",
"packageTiHi": "2x3",
"lineLotNumber": "LOT-2025-001",
"lineBatchNumber": "BATCH-2025-001",
"lineManufactureDate": "2025-08-15",
"lineExpiry": "2027-08-15",
"lineCountryOfOrigin": "USA"
}
]
},
{
"lineItemNumber": "002",
"productId": "PROD-YOG-001",
"sku": "SKU-681131789012",
"upc": "681131789012",
"quantity": "144",
"unitOfMeasure": "EA",
"lotNumber": "LOT-YOG-20250721",
"manufactureDate": "2025-07-21",
"expirationDate": "2025-08-20",
"grade": "A",
"supplierHtsCode": "8471.30.02",
"caseLevelDetails": [
{
"packageID": "CASE-PACK-SHARED-LARGE",
"description": "Dell Laptop XPS 13 - Premium Business Laptops",
"linePackageQty": 10,
"noOfPackages": 5,
"qtyUom": "EA",
"packageType": "Reinforced Electronics Crate",
"packageDimensions": "24x18x12",
"linePackageWt": "2.64",
"packageNetWt": "26.4",
"packageGrossWt": "30.0",
"wtUom": "LBS",
"packageTiHi": "2x3",
"lineLotNumber": "LOT-2025-001",
"lineBatchNumber": "BATCH-2025-001",
"lineManufactureDate": "2025-08-15",
"lineExpiry": "2027-08-15",
"lineCountryOfOrigin": "USA"
}
]
}
]
},
{
"orderID": "PO-2025-078946",
"lineDetails": [
{
"lineItemNumber": "001",
"productId": "PROD-CHZ-001",
"sku": "SKU-681131345678",
"upc": "681131345678",
"quantity": "100",
"unitOfMeasure": "LB",
"lotNumber": "LOT-CHZ-20250719",
"manufactureDate": "2025-07-19",
"expirationDate": "2025-09-19",
"grade": "Premium",
"supplierHtsCode": "8471.30.03",
"caseLevelDetails": [
{
"packageID": "CASE-PACK-SHARED-SMALL",
"description": "Dell Laptop XPS 13 - Premium Business Laptops",
"linePackageQty": 10,
"noOfPackages": 5,
"qtyUom": "EA",
"packageType": "Reinforced Electronics Crate",
"packageDimensions": "24x18x12",
"linePackageWt": "2.64",
"packageNetWt": "26.4",
"packageGrossWt": "30.0",
"wtUom": "LBS",
"packageTiHi": "2x3",
"lineLotNumber": "LOT-2025-001",
"lineBatchNumber": "BATCH-2025-001",
"lineManufactureDate": "2025-08-15",
"lineExpiry": "2027-08-15",
"lineCountryOfOrigin": "USA"
}
]
},
{
"lineItemNumber": "002",
"productId": "PROD-BTR-001",
"sku": "SKU-681131567890",
"upc": "681131567890",
"quantity": "80",
"unitOfMeasure": "LB",
"lotNumber": "LOT-BTR-20250722",
"manufactureDate": "2025-07-22",
"expirationDate": "2025-10-22",
"grade": "AA",
"supplierHtsCode": "8471.30.04",
"caseLevelDetails": [
{
"packageID": "CASE-PACK-SHARED-SMALL",
"description": "Dell Laptop XPS 13 - Premium Business Laptops",
"linePackageQty": 10,
"noOfPackages": 5,
"qtyUom": "EA",
"packageType": "Reinforced Electronics Crate",
"packageDimensions": "24x18x12",
"linePackageWt": "2.64",
"packageNetWt": "26.4",
"packageGrossWt": "30.0",
"wtUom": "LBS",
"packageTiHi": "2x3",
"lineLotNumber": "LOT-2025-001",
"lineBatchNumber": "BATCH-2025-001",
"lineManufactureDate": "2025-08-15",
"lineExpiry": "2027-08-15",
"lineCountryOfOrigin": "USA"
}
]
}
]
}
]
}
]'Staging
PUT
https://api-staging.fourkites.com/delivery
curl --location --request PUT 'https://api-staging.fourkites.com/delivery' \
--header 'Content-Type: application/json' \
--header 'apikey: <YOUR_API_KEY>' \
--data-raw '[
{
"deliveryID": "DEL-2025-001234",
"deliveryStatus": "Scheduled",
"deliveryType": "Inbound",
"eventTime": "2025-07-24T10:30:00Z",
"requestedWarehouseAppointmentTime": "2025-07-25T14:00:00Z",
"warehouseAppointmentTime": "2025-07-25T14:30:00Z",
"eventSource": "wms",
"trailerNumber": "TRL-45678",
"shipmentNumber": "SHIP-TX-789012",
"simpleUpdate": "true",
"referenceNumbers":[{
"type": "key",
"value":"value"
}],
"shipmentReferenceNumbers": [
"183927125",
"183927126",
"183927127"
],
"plannedPickupDate": "2025-07-25T08:00:00Z",
"plannedDeliveryDate": "2025-07-25T16:00:00Z",
"deliveryOrigin": {
"gln": "0860001234567",
"id": "DC-DAL-001",
"name": "Walmart Distribution Center Dallas",
"contact": {
"departmentName": "Shipping Department",
"personName": "John Smith",
"responsibility": "Shipping Manager",
"communicationChannel": [
{
"communicationChannelCode": "EMAIL",
"communicationValue": "[email protected]"
},
{
"communicationChannelCode": "PHONE",
"communicationValue": "+1-214-555-0123"
}
]
},
"address": {
"addressLine1": "1500 Distribution Way",
"addressLine2": "Building A, Dock 12",
"city": "Dallas",
"state": "TX",
"country": "USA",
"zip": "75247",
"name": "Walmart DC Dallas"
},
"organisationName": "Walmart Distribution Services"
},
"deliveryDestination": {
"gln": "0860009876543",
"id": "STR-AUS-045",
"name": "Walmart Supercenter #045",
"contact": {
"departmentName": "Receiving Department",
"personName": "Maria Garcia",
"responsibility": "Receiving Manager",
"communicationChannel": [
{
"communicationChannelCode": "EMAIL",
"communicationValue": "[email protected]"
},
{
"communicationChannelCode": "PHONE",
"communicationValue": "+1-512-555-0456"
}
]
},
"address": {
"addressLine1": "9900 S Interstate 35",
"addressLine2": "Receiving Dock B",
"city": "Austin",
"state": "TX",
"country": "USA",
"zip": "78748",
"name": "Walmart Supercenter Austin"
},
"organisationName": "Walmart Inc."
},
"avpList": {
"temperatureControlled": "true"
},
"caseLevelDetails": [
{
"packageID": "CASE-2025-07-24-001",
"description": "Organic Whole Milk - 1 Gallon",
"linePackageQty": 4,
"qtyUom": "GAL",
"packageType": "Crate",
"packageDimensions": "16x12x10",
"linePackageWt": "34.0",
"packageNetWt": "32.0",
"packageGrossWt": "34.5",
"wtUom": "LBS",
"packageTiHi": "8x6",
"lineLotNumber": "LOT-MLK-20250720",
"lineBatchNumber": "BATCH-7245",
"lineManufactureDate": "2025-07-20",
"lineExpiry": "2025-08-03",
"lineCountryOfOrigin": "USA"
},
{
"packageID": "CASE-2025-07-24-002",
"description": "Greek Yogurt Variety Pack - 32oz",
"linePackageQty": 12,
"qtyUom": "EA",
"packageType": "Box",
"packageDimensions": "20x15x8",
"linePackageWt": "26.0",
"packageNetWt": "24.0",
"packageGrossWt": "26.5",
"wtUom": "LBS",
"packageTiHi": "10x8",
"lineLotNumber": "LOT-YOG-20250721",
"lineBatchNumber": "BATCH-8956",
"lineManufactureDate": "2025-07-21",
"lineExpiry": "2025-08-20",
"lineCountryOfOrigin": "USA"
}
],
"externalUrl": [
{
"name": "TMS Tracking",
"url": "https://tracking.walmart-logistics.com/shipment/SHIP-TX-789012"
},
{
"name": "POD Document",
"url": "https://docs.walmart-logistics.com/pod/DEL-2025-001234"
}
],
"orderDetails": [
{
"orderID": "PO-2025-078945",
"lineDetails": [
{
"lineItemNumber": "001",
"productId": "PROD-MLK-001",
"sku": "SKU-681131123456",
"upc": "681131123456",
"quantity": "200",
"unitOfMeasure": "GAL",
"lotNumber": "LOT-MLK-20250720",
"manufactureDate": "2025-07-20",
"expirationDate": "2025-08-03",
"grade": "A",
"supplierHtsCode": "8471.30.01",
"caseLevelDetails": [
{
"packageID": "CASE-PACK-SHARED-LARGE",
"description": "Dell Laptop XPS 13 - Premium Business Laptops",
"linePackageQty": 10,
"noOfPackages": 5,
"qtyUom": "EA",
"packageType": "Reinforced Electronics Crate",
"packageDimensions": "24x18x12",
"linePackageWt": "2.64",
"packageNetWt": "26.4",
"packageGrossWt": "30.0",
"wtUom": "LBS",
"packageTiHi": "2x3",
"lineLotNumber": "LOT-2025-001",
"lineBatchNumber": "BATCH-2025-001",
"lineManufactureDate": "2025-08-15",
"lineExpiry": "2027-08-15",
"lineCountryOfOrigin": "USA"
}
]
},
{
"lineItemNumber": "002",
"productId": "PROD-YOG-001",
"sku": "SKU-681131789012",
"upc": "681131789012",
"quantity": "144",
"unitOfMeasure": "EA",
"lotNumber": "LOT-YOG-20250721",
"manufactureDate": "2025-07-21",
"expirationDate": "2025-08-20",
"grade": "A",
"supplierHtsCode": "8471.30.02",
"caseLevelDetails": [
{
"packageID": "CASE-PACK-SHARED-LARGE",
"description": "Dell Laptop XPS 13 - Premium Business Laptops",
"linePackageQty": 10,
"noOfPackages": 5,
"qtyUom": "EA",
"packageType": "Reinforced Electronics Crate",
"packageDimensions": "24x18x12",
"linePackageWt": "2.64",
"packageNetWt": "26.4",
"packageGrossWt": "30.0",
"wtUom": "LBS",
"packageTiHi": "2x3",
"lineLotNumber": "LOT-2025-001",
"lineBatchNumber": "BATCH-2025-001",
"lineManufactureDate": "2025-08-15",
"lineExpiry": "2027-08-15",
"lineCountryOfOrigin": "USA"
}
]
}
]
},
{
"orderID": "PO-2025-078946",
"lineDetails": [
{
"lineItemNumber": "001",
"productId": "PROD-CHZ-001",
"sku": "SKU-681131345678",
"upc": "681131345678",
"quantity": "100",
"unitOfMeasure": "LB",
"lotNumber": "LOT-CHZ-20250719",
"manufactureDate": "2025-07-19",
"expirationDate": "2025-09-19",
"grade": "Premium",
"supplierHtsCode": "8471.30.03",
"caseLevelDetails": [
{
"packageID": "CASE-PACK-SHARED-SMALL",
"description": "Dell Laptop XPS 13 - Premium Business Laptops",
"linePackageQty": 10,
"noOfPackages": 5,
"qtyUom": "EA",
"packageType": "Reinforced Electronics Crate",
"packageDimensions": "24x18x12",
"linePackageWt": "2.64",
"packageNetWt": "26.4",
"packageGrossWt": "30.0",
"wtUom": "LBS",
"packageTiHi": "2x3",
"lineLotNumber": "LOT-2025-001",
"lineBatchNumber": "BATCH-2025-001",
"lineManufactureDate": "2025-08-15",
"lineExpiry": "2027-08-15",
"lineCountryOfOrigin": "USA"
}
]
},
{
"lineItemNumber": "002",
"productId": "PROD-BTR-001",
"sku": "SKU-681131567890",
"upc": "681131567890",
"quantity": "80",
"unitOfMeasure": "LB",
"lotNumber": "LOT-BTR-20250722",
"manufactureDate": "2025-07-22",
"expirationDate": "2025-10-22",
"grade": "AA",
"supplierHtsCode": "8471.30.04",
"caseLevelDetails": [
{
"packageID": "CASE-PACK-SHARED-SMALL",
"description": "Dell Laptop XPS 13 - Premium Business Laptops",
"linePackageQty": 10,
"noOfPackages": 5,
"qtyUom": "EA",
"packageType": "Reinforced Electronics Crate",
"packageDimensions": "24x18x12",
"linePackageWt": "2.64",
"packageNetWt": "26.4",
"packageGrossWt": "30.0",
"wtUom": "LBS",
"packageTiHi": "2x3",
"lineLotNumber": "LOT-2025-001",
"lineBatchNumber": "BATCH-2025-001",
"lineManufactureDate": "2025-08-15",
"lineExpiry": "2027-08-15",
"lineCountryOfOrigin": "USA"
}
]
}
]
}
]
}
]'