Create Shipment
3 min
Create a load using the Core Track service. This data is passed down to the Appointment Manager and can also create a delivery in Dynamic Yard.
Rate Limit
60 requests per minute
Format Supported
JSON
Authenticated Resource
API Key
For more information on Authentication, click here.
Production
POST
https://api.fourkites.com/api/v1/tracking
curl --location --request POST 'https://api.fourkites.com/api/v1/tracking' \
--header 'Content-Type: application/json' \
--header 'apikey: REPLACE_KEY_VALUE' \
--data-raw '{
"trackingInfo": {
"driverPhone": "",
"trailerNumber": "2106030123"
},
"load": {
"loadNumber": "Test-appointment",
"nonTrackable": false,
"priority": "hot",
"originalScac": "csapitl",
"carrierPermalink": "carrierseranew",
"carrierName": "carrierseranew",
"tags": [],
"shipper": null,
"products": [],
"referenceNumbers": [
"2256492",
"ProductType: Bulk"
],
"stops": [
{
"stopType": "delivery",
"stopReferenceId": "xyz",
"customer": {
"id": "customer-company-6439",
"poNumbers": [
"po-pickup-1"
]
},
"completeAddress": "976 County Road 394, Delphos, KS, US",
"addressLine1": "976 County Road 394",
"city": "Delphos",
"state": "KS",
"county": "Cloud",
"loadingType": "Drop-HOOK",
"country": "US",
"postalCode": "67436",
"latitude": 39.31831267307849,
"longitude": -97.7440669937134,
"geofencePoints": [],
"appointmentTime": "2024-12-23T20:00:00.000Z",
"wantTime": null,
"earliestWantTime": null,
"latestWantTime": null,
"transportationMode": "truck",
"addressType": "",
"useLocalLatLng": true,
"pallets": [
{
"number": 1,
"parts": [
{
"customerPartNumber": "Mat1",
"quantity": 1000,
"shipperPartNumber": "Mat1",
"weight": "3072.0 LB",
"description": "Hello, This is description of Mat1"
}
]
}
]
},
{
"stopType": "pickup",
"stopReferenceId": "abc",
"customer": {
"id": "customer-company-6439",
"originalCustomerId": "",
"poNumbers": [
"po-delivery-1",
"po-delivery-2"
]
},
"name": "CypressSt",
"loadingType": "drop-hook",
"externalAddressId": "ZACHARY",
"completeAddress": null,
"addressLine1": null,
"city": null,
"state": null,
"country": null,
"postalCode": null,
"latitude": null,
"longitude": null,
"geofencePoints": [],
"appointmentTime": "2024-12-13T20:00:00.000Z",
"wantTime": "2024-12-30T20:00:00.000Z",
"earliestWantTime": null,
"latestWantTime": null,
"transportationMode": "Air",
"addressType": "",
"useLocalLatLng": true,
"pallets": [
{
"number": 1,
"parts": [
{
"customerPartNumber": "Mat2",
"quantity": 10,
"shipperPartNumber": "Mat2",
"weight": "3072.0 LB",
"description": "Hello, This is description of Mat2"
}
]
}
]
}
]
},
"simpleUpdate": true
}'Staging
POST
https://api-staging.fourkites.com/api/v1/tracking
curl --location --request POST 'https://api-staging.fourkites.com/api/v1/tracking' \
--header 'Content-Type: application/json' \
--header 'apikey: REPLACE_KEY_VALUE' \
--data-raw '{
"trackingInfo": {
"driverPhone": "",
"trailerNumber": "2106030123"
},
"load": {
"loadNumber": "Test-appointment",
"nonTrackable": false,
"priority": "hot",
"originalScac": "csapitl",
"carrierPermalink": "carrierseranew",
"carrierName": "carrierseranew",
"tags": [],
"shipper": null,
"products": [],
"referenceNumbers": [
"2256492",
"ProductType: Bulk"
],
"stops": [
{
"stopType": "delivery",
"stopReferenceId": "xyz",
"customer": {
"id": "customer-company-6439",
"poNumbers": [
"po-pickup-1"
]
},
"completeAddress": "976 County Road 394, Delphos, KS, US",
"addressLine1": "976 County Road 394",
"city": "Delphos",
"state": "KS",
"county": "Cloud",
"loadingType": "Drop-HOOK",
"country": "US",
"postalCode": "67436",
"latitude": 39.31831267307849,
"longitude": -97.7440669937134,
"geofencePoints": [],
"appointmentTime": "2024-12-23T20:00:00.000Z",
"wantTime": null,
"earliestWantTime": null,
"latestWantTime": null,
"transportationMode": "truck",
"addressType": "",
"useLocalLatLng": true,
"pallets": [
{
"number": 1,
"parts": [
{
"customerPartNumber": "Mat1",
"quantity": 1000,
"shipperPartNumber": "Mat1",
"weight": "3072.0 LB",
"description": "Hello, This is description of Mat1"
}
]
}
]
},
{
"stopType": "pickup",
"stopReferenceId": "abc",
"customer": {
"id": "customer-company-6439",
"originalCustomerId": "",
"poNumbers": [
"po-delivery-1",
"po-delivery-2"
]
},
"name": "CypressSt",
"loadingType": "drop-hook",
"externalAddressId": "ZACHARY",
"completeAddress": null,
"addressLine1": null,
"city": null,
"state": null,
"country": null,
"postalCode": null,
"latitude": null,
"longitude": null,
"geofencePoints": [],
"appointmentTime": "2024-12-13T20:00:00.000Z",
"wantTime": "2024-12-30T20:00:00.000Z",
"earliestWantTime": null,
"latestWantTime": null,
"transportationMode": "Air",
"addressType": "",
"useLocalLatLng": true,
"pallets": [
{
"number": 1,
"parts": [
{
"customerPartNumber": "Mat2",
"quantity": 10,
"shipperPartNumber": "Mat2",
"weight": "3072.0 LB",
"description": "Hello, This is description of Mat2"
}
]
}
]
}
]
},
"simpleUpdate": true
}'
While creating the load from Trac UI, below are the fields to be used.
AM field | Trac Field(UI) | Trac Field(Using API) |
|---|---|---|
Carrier | Carrier | load.carrierPermalink |
Customer | Customer | load.stops.customer.id |
location ID | External location ID | load.stops.externalAddressId |
Product Type | load_reference_1 or load_reference_2 or load_reference_3 ( in CSV file while bulk creating) | load.referenceNumbers Ex - referenceNumbers : [ProductType:Bulk]. Use prefix ProductType. |
Material Id | shipper_part_number (in CSV file while bulk creating) | load.stops.pallets.parts.shipperPartNumber |
Load mode | NA | Based on load.stops.transportationMode LoadMode is populated. loadMode/actualLoadMode |
SupplierId | NA | NA |
Trailer Type | NA | NA |
Shipping Type | dropDown near to stops | stops.stopType Valid Values pickup, delivery (case sensitive ) |
Appointment Type | NA | stops.loadingType Valid Values Live , Drop-hook (case insensitive ) InValid Values Drop hook , Drophook |