--- title: Create Shipment slug: fourkites-api-reference/V5t9-create-shipment description: Learn how to create loads and shipments using the Core Track service with this comprehensive document. Code examples containing headers and data parameters are provided to guide you through the process. Upon making an API call, you will receive a response icon: {"apiMethod":"POST"} createdAt: 2023-04-14T05:29:09.000Z --- 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. :::hint{type="info"} ### Rate Limit **60 requests per minute** ::: :::hint{type="info"} ### Format Supported **JSON** ::: :::hint{type="info"} ### Authenticated Resource **API Key** ::: For more information on Authentication, [click here](https://docs.fourkites.com/api-reference/authentication). :::ApiMethodV2 ```json { "name": "Production", "method": "POST", "url": "https://api.fourkites.com/api/v1/tracking", "description": "", "tab": "examples", "examples": { "languages": [ { "id": "yfIZX8PulPqkOs5V0qsYN", "language": "curl", "code": "curl --location --request POST 'https://api.fourkites.com/api/v1/tracking' \\\n--header 'Content-Type: application/json' \\\n--header 'apikey: REPLACE_KEY_VALUE' \\\n--data-raw '{\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"trailerNumber\": \"2106030123\"\n },\n \"load\": {\n \"loadNumber\": \"Test-appointment\",\n \"nonTrackable\": false,\n \"priority\": \"hot\",\n \"originalScac\": \"csapitl\",\n \"carrierPermalink\": \"carrierseranew\",\n \"carrierName\": \"carrierseranew\",\n \"tags\": [],\n \"shipper\": null,\n \"products\": [],\n \"referenceNumbers\": [\n \"2256492\",\n \"ProductType: Bulk\"\n ],\n \"stops\": [\n {\n \"stopType\": \"delivery\",\n \"stopReferenceId\": \"xyz\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"poNumbers\": [\n \"po-pickup-1\"\n ]\n },\n \"completeAddress\": \"976 County Road 394, Delphos, KS, US\",\n \"addressLine1\": \"976 County Road 394\",\n \"city\": \"Delphos\",\n \"state\": \"KS\",\n \"county\": \"Cloud\",\n \"loadingType\": \"Drop-HOOK\",\n \"country\": \"US\",\n \"postalCode\": \"67436\",\n \"latitude\": 39.31831267307849,\n \"longitude\": -97.7440669937134,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-23T20:00:00.000Z\",\n \"wantTime\": null,\n \"earliestWantTime\": null,\n \"latestWantTime\": null,\n \"transportationMode\": \"truck\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat1\",\n \"quantity\": 1000,\n \"shipperPartNumber\": \"Mat1\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat1\"\n }\n ]\n }\n ]\n },\n {\n \"stopType\": \"pickup\",\n \"stopReferenceId\": \"abc\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"originalCustomerId\": \"\",\n \"poNumbers\": [\n \"po-delivery-1\",\n \"po-delivery-2\"\n ]\n },\n \"name\": \"CypressSt\",\n \"loadingType\": \"drop-hook\",\n \"externalAddressId\": \"ZACHARY\",\n \"completeAddress\": null,\n \"addressLine1\": null,\n \"city\": null,\n \"state\": null,\n \"country\": null,\n \"postalCode\": null,\n \"latitude\": null,\n \"longitude\": null,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-13T20:00:00.000Z\",\n \"wantTime\": \"2024-12-30T20:00:00.000Z\",\n \"earliestWantTime\": null,\n \"latestWantTime\": null,\n \"transportationMode\": \"Air\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat2\",\n \"quantity\": 10,\n \"shipperPartNumber\": \"Mat2\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat2\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"simpleUpdate\": true\n}'", "customLabel": "" }, { "id": "3f2ZgsUBid4ZNVx8YqRow", "language": "java", "code": "OkHttpClient client = new OkHttpClient().newBuilder()\n .build();\nMediaType mediaType = MediaType.parse(\"application/json\");\nRequestBody body = RequestBody.create(mediaType, \"{\\n \\\"trackingInfo\\\": {\\n \\\"driverPhone\\\": \\\"\\\",\\n \\\"trailerNumber\\\": \\\"2106030123\\\"\\n },\\n \\\"load\\\": {\\n \\\"loadNumber\\\": \\\"Test-appointment\\\",\\n \\\"nonTrackable\\\": false,\\n \\\"priority\\\": \\\"hot\\\",\\n \\\"originalScac\\\": \\\"csapitl\\\",\\n \\\"carrierPermalink\\\": \\\"carrierseranew\\\",\\n \\\"carrierName\\\": \\\"carrierseranew\\\",\\n \\\"tags\\\": [],\\n \\\"shipper\\\": null,\\n \\\"products\\\": [],\\n \\\"referenceNumbers\\\": [\\n \\\"2256492\\\",\\n \\\"ProductType: Bulk\\\"\\n ],\\n \\\"stops\\\": [\\n {\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"stopReferenceId\\\": \\\"xyz\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"customer-company-6439\\\",\\n \\\"poNumbers\\\": [\\n \\\"po-pickup-1\\\"\\n ]\\n },\\n \\\"completeAddress\\\": \\\"976 County Road 394, Delphos, KS, US\\\",\\n \\\"addressLine1\\\": \\\"976 County Road 394\\\",\\n \\\"city\\\": \\\"Delphos\\\",\\n \\\"state\\\": \\\"KS\\\",\\n \\\"county\\\": \\\"Cloud\\\",\\n \\\"loadingType\\\": \\\"Drop-HOOK\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"postalCode\\\": \\\"67436\\\",\\n \\\"latitude\\\": 39.31831267307849,\\n \\\"longitude\\\": -97.7440669937134,\\n \\\"geofencePoints\\\": [],\\n \\\"appointmentTime\\\": \\\"2024-12-23T20:00:00.000Z\\\",\\n \\\"wantTime\\\": null,\\n \\\"earliestWantTime\\\": null,\\n \\\"latestWantTime\\\": null,\\n \\\"transportationMode\\\": \\\"truck\\\",\\n \\\"addressType\\\": \\\"\\\",\\n \\\"useLocalLatLng\\\": true,\\n \\\"pallets\\\": [\\n {\\n \\\"number\\\": 1,\\n \\\"parts\\\": [\\n {\\n \\\"customerPartNumber\\\": \\\"Mat1\\\",\\n \\\"quantity\\\": 1000,\\n \\\"shipperPartNumber\\\": \\\"Mat1\\\",\\n \\\"weight\\\": \\\"3072.0 LB\\\",\\n \\\"description\\\": \\\"Hello, This is description of Mat1\\\"\\n }\\n ]\\n }\\n ]\\n },\\n {\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"stopReferenceId\\\": \\\"abc\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"customer-company-6439\\\",\\n \\\"originalCustomerId\\\": \\\"\\\",\\n \\\"poNumbers\\\": [\\n \\\"po-delivery-1\\\",\\n \\\"po-delivery-2\\\"\\n ]\\n },\\n \\\"name\\\": \\\"CypressSt\\\",\\n \\\"loadingType\\\": \\\"drop-hook\\\",\\n \\\"externalAddressId\\\": \\\"ZACHARY\\\",\\n \\\"completeAddress\\\": null,\\n \\\"addressLine1\\\": null,\\n \\\"city\\\": null,\\n \\\"state\\\": null,\\n \\\"country\\\": null,\\n \\\"postalCode\\\": null,\\n \\\"latitude\\\": null,\\n \\\"longitude\\\": null,\\n \\\"geofencePoints\\\": [],\\n \\\"appointmentTime\\\": \\\"2024-12-13T20:00:00.000Z\\\",\\n \\\"wantTime\\\": \\\"2024-12-30T20:00:00.000Z\\\",\\n \\\"earliestWantTime\\\": null,\\n \\\"latestWantTime\\\": null,\\n \\\"transportationMode\\\": \\\"Air\\\",\\n \\\"addressType\\\": \\\"\\\",\\n \\\"useLocalLatLng\\\": true,\\n \\\"pallets\\\": [\\n {\\n \\\"number\\\": 1,\\n \\\"parts\\\": [\\n {\\n \\\"customerPartNumber\\\": \\\"Mat2\\\",\\n \\\"quantity\\\": 10,\\n \\\"shipperPartNumber\\\": \\\"Mat2\\\",\\n \\\"weight\\\": \\\"3072.0 LB\\\",\\n \\\"description\\\": \\\"Hello, This is description of Mat2\\\"\\n }\\n ]\\n }\\n ]\\n }\\n ]\\n },\\n \\\"simpleUpdate\\\": true\\n}\");\nRequest request = new Request.Builder()\n .url(\"https://api.fourkites.com/api/v1/tracking\")\n .method(\"POST\", body)\n .addHeader(\"Content-Type\", \"application/json\")\n .addHeader(\"apikey\", \"REPLACE_KEY_VALUE\")\n .build();\nResponse response = client.newCall(request).execute();", "customLabel": "" }, { "id": "JNuVnLx1lIxuKgW6FNW-D", "language": "javascript", "code": "var settings = {\n \"url\": \"https://api.fourkites.com/api/v1/tracking\",\n \"method\": \"POST\",\n \"timeout\": 0,\n \"headers\": {\n \"Content-Type\": \"application/json\",\n \"apikey\": \"REPLACE_KEY_VALUE\"\n },\n \"data\": JSON.stringify({\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"trailerNumber\": \"2106030123\"\n },\n \"load\": {\n \"loadNumber\": \"Test-appointment\",\n \"nonTrackable\": false,\n \"priority\": \"hot\",\n \"originalScac\": \"csapitl\",\n \"carrierPermalink\": \"carrierseranew\",\n \"carrierName\": \"carrierseranew\",\n \"tags\": [],\n \"shipper\": null,\n \"products\": [],\n \"referenceNumbers\": [\n \"2256492\",\n \"ProductType: Bulk\"\n ],\n \"stops\": [\n {\n \"stopType\": \"delivery\",\n \"stopReferenceId\": \"xyz\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"poNumbers\": [\n \"po-pickup-1\"\n ]\n },\n \"completeAddress\": \"976 County Road 394, Delphos, KS, US\",\n \"addressLine1\": \"976 County Road 394\",\n \"city\": \"Delphos\",\n \"state\": \"KS\",\n \"county\": \"Cloud\",\n \"loadingType\": \"Drop-HOOK\",\n \"country\": \"US\",\n \"postalCode\": \"67436\",\n \"latitude\": 39.31831267307849,\n \"longitude\": -97.7440669937134,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-23T20:00:00.000Z\",\n \"wantTime\": null,\n \"earliestWantTime\": null,\n \"latestWantTime\": null,\n \"transportationMode\": \"truck\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat1\",\n \"quantity\": 1000,\n \"shipperPartNumber\": \"Mat1\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat1\"\n }\n ]\n }\n ]\n },\n {\n \"stopType\": \"pickup\",\n \"stopReferenceId\": \"abc\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"originalCustomerId\": \"\",\n \"poNumbers\": [\n \"po-delivery-1\",\n \"po-delivery-2\"\n ]\n },\n \"name\": \"CypressSt\",\n \"loadingType\": \"drop-hook\",\n \"externalAddressId\": \"ZACHARY\",\n \"completeAddress\": null,\n \"addressLine1\": null,\n \"city\": null,\n \"state\": null,\n \"country\": null,\n \"postalCode\": null,\n \"latitude\": null,\n \"longitude\": null,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-13T20:00:00.000Z\",\n \"wantTime\": \"2024-12-30T20:00:00.000Z\",\n \"earliestWantTime\": null,\n \"latestWantTime\": null,\n \"transportationMode\": \"Air\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat2\",\n \"quantity\": 10,\n \"shipperPartNumber\": \"Mat2\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat2\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"simpleUpdate\": true\n }),\n};\n\n$.ajax(settings).done(function (response) {\n console.log(response);\n});", "customLabel": "" }, { "id": "gZOO4Gme2Mt5vuRSHUJtw", "language": "swift", "code": "import Foundation\n#if canImport(FoundationNetworking)\nimport FoundationNetworking\n#endif\n\nvar semaphore = DispatchSemaphore (value: 0)\n\nlet parameters = \"{\\n \\\"trackingInfo\\\": {\\n \\\"driverPhone\\\": \\\"\\\",\\n \\\"trailerNumber\\\": \\\"2106030123\\\"\\n },\\n \\\"load\\\": {\\n \\\"loadNumber\\\": \\\"Test-appointment\\\",\\n \\\"nonTrackable\\\": false,\\n \\\"priority\\\": \\\"hot\\\",\\n \\\"originalScac\\\": \\\"csapitl\\\",\\n \\\"carrierPermalink\\\": \\\"carrierseranew\\\",\\n \\\"carrierName\\\": \\\"carrierseranew\\\",\\n \\\"tags\\\": [],\\n \\\"shipper\\\": null,\\n \\\"products\\\": [],\\n \\\"referenceNumbers\\\": [\\n \\\"2256492\\\",\\n \\\"ProductType: Bulk\\\"\\n ],\\n \\\"stops\\\": [\\n {\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"stopReferenceId\\\": \\\"xyz\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"customer-company-6439\\\",\\n \\\"poNumbers\\\": [\\n \\\"po-pickup-1\\\"\\n ]\\n },\\n \\\"completeAddress\\\": \\\"976 County Road 394, Delphos, KS, US\\\",\\n \\\"addressLine1\\\": \\\"976 County Road 394\\\",\\n \\\"city\\\": \\\"Delphos\\\",\\n \\\"state\\\": \\\"KS\\\",\\n \\\"county\\\": \\\"Cloud\\\",\\n \\\"loadingType\\\": \\\"Drop-HOOK\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"postalCode\\\": \\\"67436\\\",\\n \\\"latitude\\\": 39.31831267307849,\\n \\\"longitude\\\": -97.7440669937134,\\n \\\"geofencePoints\\\": [],\\n \\\"appointmentTime\\\": \\\"2024-12-23T20:00:00.000Z\\\",\\n \\\"wantTime\\\": null,\\n \\\"earliestWantTime\\\": null,\\n \\\"latestWantTime\\\": null,\\n \\\"transportationMode\\\": \\\"truck\\\",\\n \\\"addressType\\\": \\\"\\\",\\n \\\"useLocalLatLng\\\": true,\\n \\\"pallets\\\": [\\n {\\n \\\"number\\\": 1,\\n \\\"parts\\\": [\\n {\\n \\\"customerPartNumber\\\": \\\"Mat1\\\",\\n \\\"quantity\\\": 1000,\\n \\\"shipperPartNumber\\\": \\\"Mat1\\\",\\n \\\"weight\\\": \\\"3072.0 LB\\\",\\n \\\"description\\\": \\\"Hello, This is description of Mat1\\\"\\n }\\n ]\\n }\\n ]\\n },\\n {\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"stopReferenceId\\\": \\\"abc\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"customer-company-6439\\\",\\n \\\"originalCustomerId\\\": \\\"\\\",\\n \\\"poNumbers\\\": [\\n \\\"po-delivery-1\\\",\\n \\\"po-delivery-2\\\"\\n ]\\n },\\n \\\"name\\\": \\\"CypressSt\\\",\\n \\\"loadingType\\\": \\\"drop-hook\\\",\\n \\\"externalAddressId\\\": \\\"ZACHARY\\\",\\n \\\"completeAddress\\\": null,\\n \\\"addressLine1\\\": null,\\n \\\"city\\\": null,\\n \\\"state\\\": null,\\n \\\"country\\\": null,\\n \\\"postalCode\\\": null,\\n \\\"latitude\\\": null,\\n \\\"longitude\\\": null,\\n \\\"geofencePoints\\\": [],\\n \\\"appointmentTime\\\": \\\"2024-12-13T20:00:00.000Z\\\",\\n \\\"wantTime\\\": \\\"2024-12-30T20:00:00.000Z\\\",\\n \\\"earliestWantTime\\\": null,\\n \\\"latestWantTime\\\": null,\\n \\\"transportationMode\\\": \\\"Air\\\",\\n \\\"addressType\\\": \\\"\\\",\\n \\\"useLocalLatLng\\\": true,\\n \\\"pallets\\\": [\\n {\\n \\\"number\\\": 1,\\n \\\"parts\\\": [\\n {\\n \\\"customerPartNumber\\\": \\\"Mat2\\\",\\n \\\"quantity\\\": 10,\\n \\\"shipperPartNumber\\\": \\\"Mat2\\\",\\n \\\"weight\\\": \\\"3072.0 LB\\\",\\n \\\"description\\\": \\\"Hello, This is description of Mat2\\\"\\n }\\n ]\\n }\\n ]\\n }\\n ]\\n },\\n \\\"simpleUpdate\\\": true\\n}\"\nlet postData = parameters.data(using: .utf8)\n\nvar request = URLRequest(url: URL(string: \"https://api.fourkites.com/api/v1/tracking\")!,timeoutInterval: Double.infinity)\nrequest.addValue(\"application/json\", forHTTPHeaderField: \"Content-Type\")\nrequest.addValue(\"REPLACE_KEY_VALUE\", forHTTPHeaderField: \"apikey\")\n\nrequest.httpMethod = \"POST\"\nrequest.httpBody = postData\n\nlet task = URLSession.shared.dataTask(with: request) { data, response, error in \n guard let data = data else {\n print(String(describing: error))\n semaphore.signal()\n return\n }\n print(String(data: data, encoding: .utf8)!)\n semaphore.signal()\n}\n\ntask.resume()\nsemaphore.wait()\n", "customLabel": "" }, { "id": "iUoZ8gYeS4G9vpSmxbs2N", "language": "csharp", "code": "var client = new RestClient(\"https://api.fourkites.com/api/v1/tracking\");\nclient.Timeout = -1;\nvar request = new RestRequest(Method.POST);\nrequest.AddHeader(\"Content-Type\", \"application/json\");\nrequest.AddHeader(\"apikey\", \"REPLACE_KEY_VALUE\");\nvar body = @\"{\" + \"\\n\" +\n@\" \"\"trackingInfo\"\": {\" + \"\\n\" +\n@\" \"\"driverPhone\"\": \"\"\"\",\" + \"\\n\" +\n@\" \"\"trailerNumber\"\": \"\"2106030123\"\"\" + \"\\n\" +\n@\" },\" + \"\\n\" +\n@\" \"\"load\"\": {\" + \"\\n\" +\n@\" \"\"loadNumber\"\": \"\"Test-appointment\"\",\" + \"\\n\" +\n@\" \"\"nonTrackable\"\": false,\" + \"\\n\" +\n@\" \"\"priority\"\": \"\"hot\"\",\" + \"\\n\" +\n@\" \"\"originalScac\"\": \"\"csapitl\"\",\" + \"\\n\" +\n@\" \"\"carrierPermalink\"\": \"\"carrierseranew\"\",\" + \"\\n\" +\n@\" \"\"carrierName\"\": \"\"carrierseranew\"\",\" + \"\\n\" +\n@\" \"\"tags\"\": [],\" + \"\\n\" +\n@\" \"\"shipper\"\": null,\" + \"\\n\" +\n@\" \"\"products\"\": [],\" + \"\\n\" +\n@\" \"\"referenceNumbers\"\": [\" + \"\\n\" +\n@\" \"\"2256492\"\",\" + \"\\n\" +\n@\" \"\"ProductType: Bulk\"\"\" + \"\\n\" +\n@\" ],\" + \"\\n\" +\n@\" \"\"stops\"\": [\" + \"\\n\" +\n@\" {\" + \"\\n\" +\n@\" \"\"stopType\"\": \"\"delivery\"\",\" + \"\\n\" +\n@\" \"\"stopReferenceId\"\": \"\"xyz\"\",\" + \"\\n\" +\n@\" \"\"customer\"\": {\" + \"\\n\" +\n@\" \"\"id\"\": \"\"customer-company-6439\"\",\" + \"\\n\" +\n@\" \"\"poNumbers\"\": [\" + \"\\n\" +\n@\" \"\"po-pickup-1\"\"\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" },\" + \"\\n\" +\n@\" \"\"completeAddress\"\": \"\"976 County Road 394, Delphos, KS, US\"\",\" + \"\\n\" +\n@\" \"\"addressLine1\"\": \"\"976 County Road 394\"\",\" + \"\\n\" +\n@\" \"\"city\"\": \"\"Delphos\"\",\" + \"\\n\" +\n@\" \"\"state\"\": \"\"KS\"\",\" + \"\\n\" +\n@\" \"\"county\"\": \"\"Cloud\"\",\" + \"\\n\" +\n@\" \"\"loadingType\"\": \"\"Drop-HOOK\"\",\" + \"\\n\" +\n@\" \"\"country\"\": \"\"US\"\",\" + \"\\n\" +\n@\" \"\"postalCode\"\": \"\"67436\"\",\" + \"\\n\" +\n@\" \"\"latitude\"\": 39.31831267307849,\" + \"\\n\" +\n@\" \"\"longitude\"\": -97.7440669937134,\" + \"\\n\" +\n@\" \"\"geofencePoints\"\": [],\" + \"\\n\" +\n@\" \"\"appointmentTime\"\": \"\"2024-12-23T20:00:00.000Z\"\",\" + \"\\n\" +\n@\" \"\"wantTime\"\": null,\" + \"\\n\" +\n@\" \"\"earliestWantTime\"\": null,\" + \"\\n\" +\n@\" \"\"latestWantTime\"\": null,\" + \"\\n\" +\n@\" \"\"transportationMode\"\": \"\"truck\"\",\" + \"\\n\" +\n@\" \"\"addressType\"\": \"\"\"\",\" + \"\\n\" +\n@\" \"\"useLocalLatLng\"\": true,\" + \"\\n\" +\n@\" \"\"pallets\"\": [\" + \"\\n\" +\n@\" {\" + \"\\n\" +\n@\" \"\"number\"\": 1,\" + \"\\n\" +\n@\" \"\"parts\"\": [\" + \"\\n\" +\n@\" {\" + \"\\n\" +\n@\" \"\"customerPartNumber\"\": \"\"Mat1\"\",\" + \"\\n\" +\n@\" \"\"quantity\"\": 1000,\" + \"\\n\" +\n@\" \"\"shipperPartNumber\"\": \"\"Mat1\"\",\" + \"\\n\" +\n@\" \"\"weight\"\": \"\"3072.0 LB\"\",\" + \"\\n\" +\n@\" \"\"description\"\": \"\"Hello, This is description of Mat1\"\"\" + \"\\n\" +\n@\" }\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" }\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" },\" + \"\\n\" +\n@\" {\" + \"\\n\" +\n@\" \"\"stopType\"\": \"\"pickup\"\",\" + \"\\n\" +\n@\" \"\"stopReferenceId\"\": \"\"abc\"\",\" + \"\\n\" +\n@\" \"\"customer\"\": {\" + \"\\n\" +\n@\" \"\"id\"\": \"\"customer-company-6439\"\",\" + \"\\n\" +\n@\" \"\"originalCustomerId\"\": \"\"\"\",\" + \"\\n\" +\n@\" \"\"poNumbers\"\": [\" + \"\\n\" +\n@\" \"\"po-delivery-1\"\",\" + \"\\n\" +\n@\" \"\"po-delivery-2\"\"\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" },\" + \"\\n\" +\n@\" \"\"name\"\": \"\"CypressSt\"\",\" + \"\\n\" +\n@\" \"\"loadingType\"\": \"\"drop-hook\"\",\" + \"\\n\" +\n@\" \"\"externalAddressId\"\": \"\"ZACHARY\"\",\" + \"\\n\" +\n@\" \"\"completeAddress\"\": null,\" + \"\\n\" +\n@\" \"\"addressLine1\"\": null,\" + \"\\n\" +\n@\" \"\"city\"\": null,\" + \"\\n\" +\n@\" \"\"state\"\": null,\" + \"\\n\" +\n@\" \"\"country\"\": null,\" + \"\\n\" +\n@\" \"\"postalCode\"\": null,\" + \"\\n\" +\n@\" \"\"latitude\"\": null,\" + \"\\n\" +\n@\" \"\"longitude\"\": null,\" + \"\\n\" +\n@\" \"\"geofencePoints\"\": [],\" + \"\\n\" +\n@\" \"\"appointmentTime\"\": \"\"2024-12-13T20:00:00.000Z\"\",\" + \"\\n\" +\n@\" \"\"wantTime\"\": \"\"2024-12-30T20:00:00.000Z\"\",\" + \"\\n\" +\n@\" \"\"earliestWantTime\"\": null,\" + \"\\n\" +\n@\" \"\"latestWantTime\"\": null,\" + \"\\n\" +\n@\" \"\"transportationMode\"\": \"\"Air\"\",\" + \"\\n\" +\n@\" \"\"addressType\"\": \"\"\"\",\" + \"\\n\" +\n@\" \"\"useLocalLatLng\"\": true,\" + \"\\n\" +\n@\" \"\"pallets\"\": [\" + \"\\n\" +\n@\" {\" + \"\\n\" +\n@\" \"\"number\"\": 1,\" + \"\\n\" +\n@\" \"\"parts\"\": [\" + \"\\n\" +\n@\" {\" + \"\\n\" +\n@\" \"\"customerPartNumber\"\": \"\"Mat2\"\",\" + \"\\n\" +\n@\" \"\"quantity\"\": 10,\" + \"\\n\" +\n@\" \"\"shipperPartNumber\"\": \"\"Mat2\"\",\" + \"\\n\" +\n@\" \"\"weight\"\": \"\"3072.0 LB\"\",\" + \"\\n\" +\n@\" \"\"description\"\": \"\"Hello, This is description of Mat2\"\"\" + \"\\n\" +\n@\" }\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" }\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" }\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" },\" + \"\\n\" +\n@\" \"\"simpleUpdate\"\": true\" + \"\\n\" +\n@\"}\";\nrequest.AddParameter(\"application/json\", body, ParameterType.RequestBody);\nIRestResponse response = client.Execute(request);\nConsole.WriteLine(response.Content);", "customLabel": "" }, { "id": "n9j9uXBPGTMEIR-0KyPP8", "language": "go", "code": "package main\n\nimport (\n \"fmt\"\n \"strings\"\n \"net/http\"\n \"io/ioutil\"\n)\n\nfunc main() {\n\n url := \"https://api.fourkites.com/api/v1/tracking\"\n method := \"POST\"\n\n payload := strings.NewReader(`{\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"trailerNumber\": \"2106030123\"\n },\n \"load\": {\n \"loadNumber\": \"Test-appointment\",\n \"nonTrackable\": false,\n \"priority\": \"hot\",\n \"originalScac\": \"csapitl\",\n \"carrierPermalink\": \"carrierseranew\",\n \"carrierName\": \"carrierseranew\",\n \"tags\": [],\n \"shipper\": null,\n \"products\": [],\n \"referenceNumbers\": [\n \"2256492\",\n \"ProductType: Bulk\"\n ],\n \"stops\": [\n {\n \"stopType\": \"delivery\",\n \"stopReferenceId\": \"xyz\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"poNumbers\": [\n \"po-pickup-1\"\n ]\n },\n \"completeAddress\": \"976 County Road 394, Delphos, KS, US\",\n \"addressLine1\": \"976 County Road 394\",\n \"city\": \"Delphos\",\n \"state\": \"KS\",\n \"county\": \"Cloud\",\n \"loadingType\": \"Drop-HOOK\",\n \"country\": \"US\",\n \"postalCode\": \"67436\",\n \"latitude\": 39.31831267307849,\n \"longitude\": -97.7440669937134,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-23T20:00:00.000Z\",\n \"wantTime\": null,\n \"earliestWantTime\": null,\n \"latestWantTime\": null,\n \"transportationMode\": \"truck\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat1\",\n \"quantity\": 1000,\n \"shipperPartNumber\": \"Mat1\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat1\"\n }\n ]\n }\n ]\n },\n {\n \"stopType\": \"pickup\",\n \"stopReferenceId\": \"abc\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"originalCustomerId\": \"\",\n \"poNumbers\": [\n \"po-delivery-1\",\n \"po-delivery-2\"\n ]\n },\n \"name\": \"CypressSt\",\n \"loadingType\": \"drop-hook\",\n \"externalAddressId\": \"ZACHARY\",\n \"completeAddress\": null,\n \"addressLine1\": null,\n \"city\": null,\n \"state\": null,\n \"country\": null,\n \"postalCode\": null,\n \"latitude\": null,\n \"longitude\": null,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-13T20:00:00.000Z\",\n \"wantTime\": \"2024-12-30T20:00:00.000Z\",\n \"earliestWantTime\": null,\n \"latestWantTime\": null,\n \"transportationMode\": \"Air\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat2\",\n \"quantity\": 10,\n \"shipperPartNumber\": \"Mat2\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat2\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"simpleUpdate\": true\n}`)\n\n client := &http.Client {\n }\n req, err := http.NewRequest(method, url, payload)\n\n if err != nil {\n fmt.Println(err)\n return\n }\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"apikey\", \"REPLACE_KEY_VALUE\")\n\n res, err := client.Do(req)\n if err != nil {\n fmt.Println(err)\n return\n }\n defer res.Body.Close()\n\n body, err := ioutil.ReadAll(res.Body)\n if err != nil {\n fmt.Println(err)\n return\n }\n fmt.Println(string(body))\n}", "customLabel": "" }, { "id": "MsysfcVOH1PDojkwtfVwd", "language": "ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.fourkites.com/api/v1/tracking\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"Content-Type\"] = \"application/json\"\nrequest[\"apikey\"] = \"REPLACE_KEY_VALUE\"\nrequest.body = JSON.dump({\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"trailerNumber\": \"2106030123\"\n },\n \"load\": {\n \"loadNumber\": \"Test-appointment\",\n \"nonTrackable\": false,\n \"priority\": \"hot\",\n \"originalScac\": \"csapitl\",\n \"carrierPermalink\": \"carrierseranew\",\n \"carrierName\": \"carrierseranew\",\n \"tags\": [],\n \"shipper\": nil,\n \"products\": [],\n \"referenceNumbers\": [\n \"2256492\",\n \"ProductType: Bulk\"\n ],\n \"stops\": [\n {\n \"stopType\": \"delivery\",\n \"stopReferenceId\": \"xyz\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"poNumbers\": [\n \"po-pickup-1\"\n ]\n },\n \"completeAddress\": \"976 County Road 394, Delphos, KS, US\",\n \"addressLine1\": \"976 County Road 394\",\n \"city\": \"Delphos\",\n \"state\": \"KS\",\n \"county\": \"Cloud\",\n \"loadingType\": \"Drop-HOOK\",\n \"country\": \"US\",\n \"postalCode\": \"67436\",\n \"latitude\": 39.31831267307849,\n \"longitude\": -97.7440669937134,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-23T20:00:00.000Z\",\n \"wantTime\": nil,\n \"earliestWantTime\": nil,\n \"latestWantTime\": nil,\n \"transportationMode\": \"truck\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat1\",\n \"quantity\": 1000,\n \"shipperPartNumber\": \"Mat1\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat1\"\n }\n ]\n }\n ]\n },\n {\n \"stopType\": \"pickup\",\n \"stopReferenceId\": \"abc\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"originalCustomerId\": \"\",\n \"poNumbers\": [\n \"po-delivery-1\",\n \"po-delivery-2\"\n ]\n },\n \"name\": \"CypressSt\",\n \"loadingType\": \"drop-hook\",\n \"externalAddressId\": \"ZACHARY\",\n \"completeAddress\": nil,\n \"addressLine1\": nil,\n \"city\": nil,\n \"state\": nil,\n \"country\": nil,\n \"postalCode\": nil,\n \"latitude\": nil,\n \"longitude\": nil,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-13T20:00:00.000Z\",\n \"wantTime\": \"2024-12-30T20:00:00.000Z\",\n \"earliestWantTime\": nil,\n \"latestWantTime\": nil,\n \"transportationMode\": \"Air\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat2\",\n \"quantity\": 10,\n \"shipperPartNumber\": \"Mat2\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat2\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"simpleUpdate\": true\n})\n\nresponse = https.request(request)\nputs response.read_body\n", "customLabel": "" }, { "id": "9s_M9A4gtewNaS3pDVX8s", "language": "python", "code": "import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.fourkites.com\")\npayload = json.dumps({\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"trailerNumber\": \"2106030123\"\n },\n \"load\": {\n \"loadNumber\": \"Test-appointment\",\n \"nonTrackable\": False,\n \"priority\": \"hot\",\n \"originalScac\": \"csapitl\",\n \"carrierPermalink\": \"carrierseranew\",\n \"carrierName\": \"carrierseranew\",\n \"tags\": [],\n \"shipper\": None,\n \"products\": [],\n \"referenceNumbers\": [\n \"2256492\",\n \"ProductType: Bulk\"\n ],\n \"stops\": [\n {\n \"stopType\": \"delivery\",\n \"stopReferenceId\": \"xyz\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"poNumbers\": [\n \"po-pickup-1\"\n ]\n },\n \"completeAddress\": \"976 County Road 394, Delphos, KS, US\",\n \"addressLine1\": \"976 County Road 394\",\n \"city\": \"Delphos\",\n \"state\": \"KS\",\n \"county\": \"Cloud\",\n \"loadingType\": \"Drop-HOOK\",\n \"country\": \"US\",\n \"postalCode\": \"67436\",\n \"latitude\": 39.31831267307849,\n \"longitude\": -97.7440669937134,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-23T20:00:00.000Z\",\n \"wantTime\": None,\n \"earliestWantTime\": None,\n \"latestWantTime\": None,\n \"transportationMode\": \"truck\",\n \"addressType\": \"\",\n \"useLocalLatLng\": True,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat1\",\n \"quantity\": 1000,\n \"shipperPartNumber\": \"Mat1\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat1\"\n }\n ]\n }\n ]\n },\n {\n \"stopType\": \"pickup\",\n \"stopReferenceId\": \"abc\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"originalCustomerId\": \"\",\n \"poNumbers\": [\n \"po-delivery-1\",\n \"po-delivery-2\"\n ]\n },\n \"name\": \"CypressSt\",\n \"loadingType\": \"drop-hook\",\n \"externalAddressId\": \"ZACHARY\",\n \"completeAddress\": None,\n \"addressLine1\": None,\n \"city\": None,\n \"state\": None,\n \"country\": None,\n \"postalCode\": None,\n \"latitude\": None,\n \"longitude\": None,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-13T20:00:00.000Z\",\n \"wantTime\": \"2024-12-30T20:00:00.000Z\",\n \"earliestWantTime\": None,\n \"latestWantTime\": None,\n \"transportationMode\": \"Air\",\n \"addressType\": \"\",\n \"useLocalLatLng\": True,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat2\",\n \"quantity\": 10,\n \"shipperPartNumber\": \"Mat2\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat2\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"simpleUpdate\": True\n})\nheaders = {\n 'Content-Type': 'application/json',\n 'apikey': 'REPLACE_KEY_VALUE'\n}\nconn.request(\"POST\", \"/api/v1/tracking\", payload, headers)\nres = conn.getresponse()\ndata = res.read()\nprint(data.decode(\"utf-8\"))", "customLabel": "" } ], "selectedLanguageId": "yfIZX8PulPqkOs5V0qsYN" }, "results": { "languages": [ { "id": "HKDIxxuWLl7i1XUUOjAJj", "language": "200", "customLabel": "", "code": "{\n \"loadId\": 432728294,\n \"message\": \"Load creation request has been submitted successfully\",\n \"requestId\": \"cpcqp7k6o9momjngb5rg\",\n \"statusCode\": 200\n}" } ], "selectedLanguageId": "HKDIxxuWLl7i1XUUOjAJj" }, "request": { "pathParameters": [], "queryParameters": [], "headerParameters": [], "bodyDataParameters": [ { "name": "trackingInfo", "kind": "optional", "type": "object", "description": "It indicates the information required for tracking the load.", "children": [ { "name": "driverPhone", "kind": "optional", "type": "string", "description": "It indicates a valid mobile number. Example: +13125555555" }, { "name": "trailerNumber", "kind": "optional", "type": "string", "description": "It indicates the trailer number assigned to the load." } ] }, { "name": "load", "kind": "optional", "type": "object", "description": "It is the parent object for the load. Place the load attributes inside this object.", "children": [ { "name": "loadNumber", "kind": "required", "type": "string", "description": "Unique load identifier from shipper's system. The load Number or BOL is an important piece of information used to link the load with truck information received from the Carrier's TMS" }, { "name": "nonTrackable", "kind": "optional", "type": "string", "description": "indicator specifying if the load should be created in the Core Track platform. If \"true\" the load will bypass Core Track (as it is considered \"non-trackable\") but the data will continue to pass down to Appointment Manager and Dynamic Yard for use as appointments and deliveries" }, { "name": "priority", "kind": "optional", "type": "string", "description": "It indicates whether a load is of normal or high priority. If priority is set as ‘hot’, the load will be marked as ‘Hot’. Valid values: ‘normal’, ‘high’ and ‘hot’. Defaults to normal. Setting the 'Priority' as 'hot' will mark the load as 'Hot' load." }, { "name": "originalScac", "kind": "optional", "type": "string", "description": "SCAC or Service Provider ID of the carrier assigned to the load. The carrier should have approved sharing of their telematics data on FourKites for the customer" }, { "name": "carrierPermalink", "kind": "optional", "type": "string", "description": "Permalink of the carrier" }, { "name": "carrierName", "kind": "optional", "type": "string", "description": "Name of the carrier." }, { "name": "tags", "kind": "required", "type": "array", "description": "List of labels or categories associated with the load. Tags can be used to filter groups of loads" }, { "name": "products", "kind": "optional", "type": "object", "description": "It indicates the list of temperature tracked products on a load and their temperature tracking information." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It is the list of load level reference numbers associated with a load. (CM)" }, { "name": "stops", "kind": "optional", "type": "object", "description": "Stop-specific parameters.", "children": [ { "name": "stopType", "kind": "optional", "type": "string", "description": "Indicates whether the stop is a pickup, delivery stop. " }, { "name": "stopReferenceId", "kind": "optional", "type": "string", "description": "Alphanumeric code generated in the load creator’s system which is unique to a specific stop in a specific load. It is used to know which stop and update is applied to in FourKites" }, { "name": "customer", "kind": "optional", "type": "object", "description": "Customer-specific parameters", "children": [ { "name": "id", "kind": "optional", "type": "string", "description": "Unique identifier for a customer loaded in the shipper’s master data in FourKites. Please refer to supporting documentation on using customers in FourKites" }, { "name": "poNumbers", "kind": "optional", "type": "string", "description": "List of PO Numbers associated with the stop" } ] }, { "name": "completeAddress", "kind": "optional", "type": "string", "description": "Complete address of the stop" }, { "name": "addressLine1", "kind": "required", "type": "string", "description": "First line of the stop’s street address" }, { "name": "city", "kind": "required", "type": "string", "description": "Stop's city" }, { "name": "state", "kind": "required", "type": "string", "description": "Stop's state" }, { "name": "county", "kind": "optional", "type": "string", "description": "To which county the stop belong to" }, { "name": "loadingType", "kind": "optional", "type": "string", "description": "Indicates whether the loading type is live or drop-hook" }, { "name": "country", "kind": "required", "type": "string", "description": "Valid country code of the stop" }, { "name": "postalCode", "kind": "required", "type": "string", "description": "Valid postal code of the stop" }, { "name": "latitude", "kind": "optional", "type": "string", "description": "It indicates the latitude of the stop's location. \tIt is formatted to decimal degrees.The only accepted format of lat/long by FourKites is the \"Decimal Degrees\" format. For example: 41.8781 (lat), -87.6298 (long)." }, { "name": "longitude", "kind": "optional", "type": "string", "description": "It indicates the longitude of the stop's location. \tIt is formatted to decimal degrees.The only accepted format of lat/long by FourKites® is the \"Decimal Degrees\" format. For example: 41.8781 (lat), -87.6298 (long)." }, { "name": "geofencePoints", "kind": "optional", "type": "array", "description": "It indicates the list of lat/long coordinates of the corners of the polygon geofence around the stop to be used for detecting arrival." }, { "name": "appointmentTime", "kind": "required", "type": "string", "description": "It indicates the scheduled appointment time at the stop in the stop's local time zone in ISO 8601 format. ISO 8601 format Appointment times cannot be more than 4 days in the past from the current time." }, { "name": "wantTime", "kind": "optional", "type": "string", "description": "It indicates the time by which the load must be delivered to the consignee in stop's local time zone in ISO 8601 format. (CM)\n" }, { "name": "earliestWantTime", "kind": "required", "type": "string", "description": "It indicates the earliest time by which the load must be delivered to the consignee in the stop's local timezone in ISO 8601 format. (CM). If the earliestWantTime is sent, then the latestWantTime must also be sent." }, { "name": "latestWantTime", "kind": "required", "type": "string", "description": "It indicates the latest time by which the load must be delivered to the consignee in the stop's local timezone in ISO 8601 format. (CM). If the latestWantTime is sent, then the earliestWantTime must also be sent." }, { "name": "transportationMode", "kind": "optional", "type": "string", "description": "It defines the mode of the load. Valid values: \"TL\", \"LTL\", \"PARCEL\"" }, { "name": "pallets", "kind": "optional", "type": "object", "description": "It indicates the list of pallets to be delivered at the stop. Each pallet has a pallet number and list of parts.", "children": [ { "name": "number", "kind": "optional", "type": "string", "description": "Indicates total number of pallets" }, { "name": "parts", "kind": "optional", "type": "object", "description": "It indicates the list of parts in the pallet.", "children": [ { "name": "customerPartNumber", "kind": "optional", "type": "string", "description": "It indicates the customer part number." }, { "name": "quantity", "kind": "optional", "type": "string", "description": "It indicates the quantity of the part." }, { "name": "shipperPartNumber", "kind": "optional", "type": "string", "description": "It indicates the shipper/manufacturer’s part number." }, { "name": "weight", "kind": "optional", "type": "string", "description": "It indicates the weight of the part." }, { "name": "description", "kind": "optional", "type": "string", "description": "Description given to the part of the pallet" } ] } ] } ] } ] } ], "formDataParameters": [] }, "currentNewParameter": { "label": "Body Parameter", "value": "bodyDataParameters" }, "autoGeneratedAnchorSlug": "production", "legacyHash": "jSeHj_W2RdTlCoA0s2EI8" } ``` ::: :::ApiMethodV2 ```json { "name": "Staging", "method": "POST", "url": "https://api-staging.fourkites.com/api/v1/tracking", "description": "", "tab": "examples", "examples": { "languages": [ { "id": "yfIZX8PulPqkOs5V0qsYN", "language": "curl", "code": "curl --location --request POST 'https://api-staging.fourkites.com/api/v1/tracking' \\\n--header 'Content-Type: application/json' \\\n--header 'apikey: REPLACE_KEY_VALUE' \\\n--data-raw '{\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"trailerNumber\": \"2106030123\"\n },\n \"load\": {\n \"loadNumber\": \"Test-appointment\",\n \"nonTrackable\": false,\n \"priority\": \"hot\",\n \"originalScac\": \"csapitl\",\n \"carrierPermalink\": \"carrierseranew\",\n \"carrierName\": \"carrierseranew\",\n \"tags\": [],\n \"shipper\": null,\n \"products\": [],\n \"referenceNumbers\": [\n \"2256492\",\n \"ProductType: Bulk\"\n ],\n \"stops\": [\n {\n \"stopType\": \"delivery\",\n \"stopReferenceId\": \"xyz\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"poNumbers\": [\n \"po-pickup-1\"\n ]\n },\n \"completeAddress\": \"976 County Road 394, Delphos, KS, US\",\n \"addressLine1\": \"976 County Road 394\",\n \"city\": \"Delphos\",\n \"state\": \"KS\",\n \"county\": \"Cloud\",\n \"loadingType\": \"Drop-HOOK\",\n \"country\": \"US\",\n \"postalCode\": \"67436\",\n \"latitude\": 39.31831267307849,\n \"longitude\": -97.7440669937134,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-23T20:00:00.000Z\",\n \"wantTime\": null,\n \"earliestWantTime\": null,\n \"latestWantTime\": null,\n \"transportationMode\": \"truck\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat1\",\n \"quantity\": 1000,\n \"shipperPartNumber\": \"Mat1\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat1\"\n }\n ]\n }\n ]\n },\n {\n \"stopType\": \"pickup\",\n \"stopReferenceId\": \"abc\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"originalCustomerId\": \"\",\n \"poNumbers\": [\n \"po-delivery-1\",\n \"po-delivery-2\"\n ]\n },\n \"name\": \"CypressSt\",\n \"loadingType\": \"drop-hook\",\n \"externalAddressId\": \"ZACHARY\",\n \"completeAddress\": null,\n \"addressLine1\": null,\n \"city\": null,\n \"state\": null,\n \"country\": null,\n \"postalCode\": null,\n \"latitude\": null,\n \"longitude\": null,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-13T20:00:00.000Z\",\n \"wantTime\": \"2024-12-30T20:00:00.000Z\",\n \"earliestWantTime\": null,\n \"latestWantTime\": null,\n \"transportationMode\": \"Air\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat2\",\n \"quantity\": 10,\n \"shipperPartNumber\": \"Mat2\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat2\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"simpleUpdate\": true\n}'", "customLabel": "" }, { "id": "3f2ZgsUBid4ZNVx8YqRow", "language": "java", "code": "OkHttpClient client = new OkHttpClient().newBuilder()\n .build();\nMediaType mediaType = MediaType.parse(\"application/json\");\nRequestBody body = RequestBody.create(mediaType, \"{\\n \\\"trackingInfo\\\": {\\n \\\"driverPhone\\\": \\\"\\\",\\n \\\"trailerNumber\\\": \\\"2106030123\\\"\\n },\\n \\\"load\\\": {\\n \\\"loadNumber\\\": \\\"Test-appointment\\\",\\n \\\"nonTrackable\\\": false,\\n \\\"priority\\\": \\\"hot\\\",\\n \\\"originalScac\\\": \\\"csapitl\\\",\\n \\\"carrierPermalink\\\": \\\"carrierseranew\\\",\\n \\\"carrierName\\\": \\\"carrierseranew\\\",\\n \\\"tags\\\": [],\\n \\\"shipper\\\": null,\\n \\\"products\\\": [],\\n \\\"referenceNumbers\\\": [\\n \\\"2256492\\\",\\n \\\"ProductType: Bulk\\\"\\n ],\\n \\\"stops\\\": [\\n {\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"stopReferenceId\\\": \\\"xyz\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"customer-company-6439\\\",\\n \\\"poNumbers\\\": [\\n \\\"po-pickup-1\\\"\\n ]\\n },\\n \\\"completeAddress\\\": \\\"976 County Road 394, Delphos, KS, US\\\",\\n \\\"addressLine1\\\": \\\"976 County Road 394\\\",\\n \\\"city\\\": \\\"Delphos\\\",\\n \\\"state\\\": \\\"KS\\\",\\n \\\"county\\\": \\\"Cloud\\\",\\n \\\"loadingType\\\": \\\"Drop-HOOK\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"postalCode\\\": \\\"67436\\\",\\n \\\"latitude\\\": 39.31831267307849,\\n \\\"longitude\\\": -97.7440669937134,\\n \\\"geofencePoints\\\": [],\\n \\\"appointmentTime\\\": \\\"2024-12-23T20:00:00.000Z\\\",\\n \\\"wantTime\\\": null,\\n \\\"earliestWantTime\\\": null,\\n \\\"latestWantTime\\\": null,\\n \\\"transportationMode\\\": \\\"truck\\\",\\n \\\"addressType\\\": \\\"\\\",\\n \\\"useLocalLatLng\\\": true,\\n \\\"pallets\\\": [\\n {\\n \\\"number\\\": 1,\\n \\\"parts\\\": [\\n {\\n \\\"customerPartNumber\\\": \\\"Mat1\\\",\\n \\\"quantity\\\": 1000,\\n \\\"shipperPartNumber\\\": \\\"Mat1\\\",\\n \\\"weight\\\": \\\"3072.0 LB\\\",\\n \\\"description\\\": \\\"Hello, This is description of Mat1\\\"\\n }\\n ]\\n }\\n ]\\n },\\n {\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"stopReferenceId\\\": \\\"abc\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"customer-company-6439\\\",\\n \\\"originalCustomerId\\\": \\\"\\\",\\n \\\"poNumbers\\\": [\\n \\\"po-delivery-1\\\",\\n \\\"po-delivery-2\\\"\\n ]\\n },\\n \\\"name\\\": \\\"CypressSt\\\",\\n \\\"loadingType\\\": \\\"drop-hook\\\",\\n \\\"externalAddressId\\\": \\\"ZACHARY\\\",\\n \\\"completeAddress\\\": null,\\n \\\"addressLine1\\\": null,\\n \\\"city\\\": null,\\n \\\"state\\\": null,\\n \\\"country\\\": null,\\n \\\"postalCode\\\": null,\\n \\\"latitude\\\": null,\\n \\\"longitude\\\": null,\\n \\\"geofencePoints\\\": [],\\n \\\"appointmentTime\\\": \\\"2024-12-13T20:00:00.000Z\\\",\\n \\\"wantTime\\\": \\\"2024-12-30T20:00:00.000Z\\\",\\n \\\"earliestWantTime\\\": null,\\n \\\"latestWantTime\\\": null,\\n \\\"transportationMode\\\": \\\"Air\\\",\\n \\\"addressType\\\": \\\"\\\",\\n \\\"useLocalLatLng\\\": true,\\n \\\"pallets\\\": [\\n {\\n \\\"number\\\": 1,\\n \\\"parts\\\": [\\n {\\n \\\"customerPartNumber\\\": \\\"Mat2\\\",\\n \\\"quantity\\\": 10,\\n \\\"shipperPartNumber\\\": \\\"Mat2\\\",\\n \\\"weight\\\": \\\"3072.0 LB\\\",\\n \\\"description\\\": \\\"Hello, This is description of Mat2\\\"\\n }\\n ]\\n }\\n ]\\n }\\n ]\\n },\\n \\\"simpleUpdate\\\": true\\n}\");\nRequest request = new Request.Builder()\n .url(\"https://api-staging.fourkites.com/api/v1/tracking\")\n .method(\"POST\", body)\n .addHeader(\"Content-Type\", \"application/json\")\n .addHeader(\"apikey\", \"REPLACE_KEY_VALUE\")\n .build();\nResponse response = client.newCall(request).execute();", "customLabel": "" }, { "id": "JNuVnLx1lIxuKgW6FNW-D", "language": "javascript", "code": "var settings = {\n \"url\": \"https://api-staging.fourkites.com/api/v1/tracking\",\n \"method\": \"POST\",\n \"timeout\": 0,\n \"headers\": {\n \"Content-Type\": \"application/json\",\n \"apikey\": \"REPLACE_KEY_VALUE\"\n },\n \"data\": JSON.stringify({\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"trailerNumber\": \"2106030123\"\n },\n \"load\": {\n \"loadNumber\": \"Test-appointment\",\n \"nonTrackable\": false,\n \"priority\": \"hot\",\n \"originalScac\": \"csapitl\",\n \"carrierPermalink\": \"carrierseranew\",\n \"carrierName\": \"carrierseranew\",\n \"tags\": [],\n \"shipper\": null,\n \"products\": [],\n \"referenceNumbers\": [\n \"2256492\",\n \"ProductType: Bulk\"\n ],\n \"stops\": [\n {\n \"stopType\": \"delivery\",\n \"stopReferenceId\": \"xyz\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"poNumbers\": [\n \"po-pickup-1\"\n ]\n },\n \"completeAddress\": \"976 County Road 394, Delphos, KS, US\",\n \"addressLine1\": \"976 County Road 394\",\n \"city\": \"Delphos\",\n \"state\": \"KS\",\n \"county\": \"Cloud\",\n \"loadingType\": \"Drop-HOOK\",\n \"country\": \"US\",\n \"postalCode\": \"67436\",\n \"latitude\": 39.31831267307849,\n \"longitude\": -97.7440669937134,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-23T20:00:00.000Z\",\n \"wantTime\": null,\n \"earliestWantTime\": null,\n \"latestWantTime\": null,\n \"transportationMode\": \"truck\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat1\",\n \"quantity\": 1000,\n \"shipperPartNumber\": \"Mat1\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat1\"\n }\n ]\n }\n ]\n },\n {\n \"stopType\": \"pickup\",\n \"stopReferenceId\": \"abc\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"originalCustomerId\": \"\",\n \"poNumbers\": [\n \"po-delivery-1\",\n \"po-delivery-2\"\n ]\n },\n \"name\": \"CypressSt\",\n \"loadingType\": \"drop-hook\",\n \"externalAddressId\": \"ZACHARY\",\n \"completeAddress\": null,\n \"addressLine1\": null,\n \"city\": null,\n \"state\": null,\n \"country\": null,\n \"postalCode\": null,\n \"latitude\": null,\n \"longitude\": null,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-13T20:00:00.000Z\",\n \"wantTime\": \"2024-12-30T20:00:00.000Z\",\n \"earliestWantTime\": null,\n \"latestWantTime\": null,\n \"transportationMode\": \"Air\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat2\",\n \"quantity\": 10,\n \"shipperPartNumber\": \"Mat2\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat2\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"simpleUpdate\": true\n }),\n};\n\n$.ajax(settings).done(function (response) {\n console.log(response);\n});", "customLabel": "" }, { "id": "gZOO4Gme2Mt5vuRSHUJtw", "language": "swift", "code": "import Foundation\n#if canImport(FoundationNetworking)\nimport FoundationNetworking\n#endif\n\nvar semaphore = DispatchSemaphore (value: 0)\n\nlet parameters = \"{\\n \\\"trackingInfo\\\": {\\n \\\"driverPhone\\\": \\\"\\\",\\n \\\"trailerNumber\\\": \\\"2106030123\\\"\\n },\\n \\\"load\\\": {\\n \\\"loadNumber\\\": \\\"Test-appointment\\\",\\n \\\"nonTrackable\\\": false,\\n \\\"priority\\\": \\\"hot\\\",\\n \\\"originalScac\\\": \\\"csapitl\\\",\\n \\\"carrierPermalink\\\": \\\"carrierseranew\\\",\\n \\\"carrierName\\\": \\\"carrierseranew\\\",\\n \\\"tags\\\": [],\\n \\\"shipper\\\": null,\\n \\\"products\\\": [],\\n \\\"referenceNumbers\\\": [\\n \\\"2256492\\\",\\n \\\"ProductType: Bulk\\\"\\n ],\\n \\\"stops\\\": [\\n {\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"stopReferenceId\\\": \\\"xyz\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"customer-company-6439\\\",\\n \\\"poNumbers\\\": [\\n \\\"po-pickup-1\\\"\\n ]\\n },\\n \\\"completeAddress\\\": \\\"976 County Road 394, Delphos, KS, US\\\",\\n \\\"addressLine1\\\": \\\"976 County Road 394\\\",\\n \\\"city\\\": \\\"Delphos\\\",\\n \\\"state\\\": \\\"KS\\\",\\n \\\"county\\\": \\\"Cloud\\\",\\n \\\"loadingType\\\": \\\"Drop-HOOK\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"postalCode\\\": \\\"67436\\\",\\n \\\"latitude\\\": 39.31831267307849,\\n \\\"longitude\\\": -97.7440669937134,\\n \\\"geofencePoints\\\": [],\\n \\\"appointmentTime\\\": \\\"2024-12-23T20:00:00.000Z\\\",\\n \\\"wantTime\\\": null,\\n \\\"earliestWantTime\\\": null,\\n \\\"latestWantTime\\\": null,\\n \\\"transportationMode\\\": \\\"truck\\\",\\n \\\"addressType\\\": \\\"\\\",\\n \\\"useLocalLatLng\\\": true,\\n \\\"pallets\\\": [\\n {\\n \\\"number\\\": 1,\\n \\\"parts\\\": [\\n {\\n \\\"customerPartNumber\\\": \\\"Mat1\\\",\\n \\\"quantity\\\": 1000,\\n \\\"shipperPartNumber\\\": \\\"Mat1\\\",\\n \\\"weight\\\": \\\"3072.0 LB\\\",\\n \\\"description\\\": \\\"Hello, This is description of Mat1\\\"\\n }\\n ]\\n }\\n ]\\n },\\n {\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"stopReferenceId\\\": \\\"abc\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"customer-company-6439\\\",\\n \\\"originalCustomerId\\\": \\\"\\\",\\n \\\"poNumbers\\\": [\\n \\\"po-delivery-1\\\",\\n \\\"po-delivery-2\\\"\\n ]\\n },\\n \\\"name\\\": \\\"CypressSt\\\",\\n \\\"loadingType\\\": \\\"drop-hook\\\",\\n \\\"externalAddressId\\\": \\\"ZACHARY\\\",\\n \\\"completeAddress\\\": null,\\n \\\"addressLine1\\\": null,\\n \\\"city\\\": null,\\n \\\"state\\\": null,\\n \\\"country\\\": null,\\n \\\"postalCode\\\": null,\\n \\\"latitude\\\": null,\\n \\\"longitude\\\": null,\\n \\\"geofencePoints\\\": [],\\n \\\"appointmentTime\\\": \\\"2024-12-13T20:00:00.000Z\\\",\\n \\\"wantTime\\\": \\\"2024-12-30T20:00:00.000Z\\\",\\n \\\"earliestWantTime\\\": null,\\n \\\"latestWantTime\\\": null,\\n \\\"transportationMode\\\": \\\"Air\\\",\\n \\\"addressType\\\": \\\"\\\",\\n \\\"useLocalLatLng\\\": true,\\n \\\"pallets\\\": [\\n {\\n \\\"number\\\": 1,\\n \\\"parts\\\": [\\n {\\n \\\"customerPartNumber\\\": \\\"Mat2\\\",\\n \\\"quantity\\\": 10,\\n \\\"shipperPartNumber\\\": \\\"Mat2\\\",\\n \\\"weight\\\": \\\"3072.0 LB\\\",\\n \\\"description\\\": \\\"Hello, This is description of Mat2\\\"\\n }\\n ]\\n }\\n ]\\n }\\n ]\\n },\\n \\\"simpleUpdate\\\": true\\n}\"\nlet postData = parameters.data(using: .utf8)\n\nvar request = URLRequest(url: URL(string: \"https://api-staging.fourkites.com/api/v1/tracking\")!,timeoutInterval: Double.infinity)\nrequest.addValue(\"application/json\", forHTTPHeaderField: \"Content-Type\")\nrequest.addValue(\"REPLACE_KEY_VALUE\", forHTTPHeaderField: \"apikey\")\n\nrequest.httpMethod = \"POST\"\nrequest.httpBody = postData\n\nlet task = URLSession.shared.dataTask(with: request) { data, response, error in \n guard let data = data else {\n print(String(describing: error))\n semaphore.signal()\n return\n }\n print(String(data: data, encoding: .utf8)!)\n semaphore.signal()\n}\n\ntask.resume()\nsemaphore.wait()\n", "customLabel": "" }, { "id": "iUoZ8gYeS4G9vpSmxbs2N", "language": "csharp", "code": "var client = new RestClient(\"https://api-staging.fourkites.com/api/v1/tracking\");\nclient.Timeout = -1;\nvar request = new RestRequest(Method.POST);\nrequest.AddHeader(\"Content-Type\", \"application/json\");\nrequest.AddHeader(\"apikey\", \"REPLACE_KEY_VALUE\");\nvar body = @\"{\" + \"\\n\" +\n@\" \"\"trackingInfo\"\": {\" + \"\\n\" +\n@\" \"\"driverPhone\"\": \"\"\"\",\" + \"\\n\" +\n@\" \"\"trailerNumber\"\": \"\"2106030123\"\"\" + \"\\n\" +\n@\" },\" + \"\\n\" +\n@\" \"\"load\"\": {\" + \"\\n\" +\n@\" \"\"loadNumber\"\": \"\"Test-appointment\"\",\" + \"\\n\" +\n@\" \"\"nonTrackable\"\": false,\" + \"\\n\" +\n@\" \"\"priority\"\": \"\"hot\"\",\" + \"\\n\" +\n@\" \"\"originalScac\"\": \"\"csapitl\"\",\" + \"\\n\" +\n@\" \"\"carrierPermalink\"\": \"\"carrierseranew\"\",\" + \"\\n\" +\n@\" \"\"carrierName\"\": \"\"carrierseranew\"\",\" + \"\\n\" +\n@\" \"\"tags\"\": [],\" + \"\\n\" +\n@\" \"\"shipper\"\": null,\" + \"\\n\" +\n@\" \"\"products\"\": [],\" + \"\\n\" +\n@\" \"\"referenceNumbers\"\": [\" + \"\\n\" +\n@\" \"\"2256492\"\",\" + \"\\n\" +\n@\" \"\"ProductType: Bulk\"\"\" + \"\\n\" +\n@\" ],\" + \"\\n\" +\n@\" \"\"stops\"\": [\" + \"\\n\" +\n@\" {\" + \"\\n\" +\n@\" \"\"stopType\"\": \"\"delivery\"\",\" + \"\\n\" +\n@\" \"\"stopReferenceId\"\": \"\"xyz\"\",\" + \"\\n\" +\n@\" \"\"customer\"\": {\" + \"\\n\" +\n@\" \"\"id\"\": \"\"customer-company-6439\"\",\" + \"\\n\" +\n@\" \"\"poNumbers\"\": [\" + \"\\n\" +\n@\" \"\"po-pickup-1\"\"\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" },\" + \"\\n\" +\n@\" \"\"completeAddress\"\": \"\"976 County Road 394, Delphos, KS, US\"\",\" + \"\\n\" +\n@\" \"\"addressLine1\"\": \"\"976 County Road 394\"\",\" + \"\\n\" +\n@\" \"\"city\"\": \"\"Delphos\"\",\" + \"\\n\" +\n@\" \"\"state\"\": \"\"KS\"\",\" + \"\\n\" +\n@\" \"\"county\"\": \"\"Cloud\"\",\" + \"\\n\" +\n@\" \"\"loadingType\"\": \"\"Drop-HOOK\"\",\" + \"\\n\" +\n@\" \"\"country\"\": \"\"US\"\",\" + \"\\n\" +\n@\" \"\"postalCode\"\": \"\"67436\"\",\" + \"\\n\" +\n@\" \"\"latitude\"\": 39.31831267307849,\" + \"\\n\" +\n@\" \"\"longitude\"\": -97.7440669937134,\" + \"\\n\" +\n@\" \"\"geofencePoints\"\": [],\" + \"\\n\" +\n@\" \"\"appointmentTime\"\": \"\"2024-12-23T20:00:00.000Z\"\",\" + \"\\n\" +\n@\" \"\"wantTime\"\": null,\" + \"\\n\" +\n@\" \"\"earliestWantTime\"\": null,\" + \"\\n\" +\n@\" \"\"latestWantTime\"\": null,\" + \"\\n\" +\n@\" \"\"transportationMode\"\": \"\"truck\"\",\" + \"\\n\" +\n@\" \"\"addressType\"\": \"\"\"\",\" + \"\\n\" +\n@\" \"\"useLocalLatLng\"\": true,\" + \"\\n\" +\n@\" \"\"pallets\"\": [\" + \"\\n\" +\n@\" {\" + \"\\n\" +\n@\" \"\"number\"\": 1,\" + \"\\n\" +\n@\" \"\"parts\"\": [\" + \"\\n\" +\n@\" {\" + \"\\n\" +\n@\" \"\"customerPartNumber\"\": \"\"Mat1\"\",\" + \"\\n\" +\n@\" \"\"quantity\"\": 1000,\" + \"\\n\" +\n@\" \"\"shipperPartNumber\"\": \"\"Mat1\"\",\" + \"\\n\" +\n@\" \"\"weight\"\": \"\"3072.0 LB\"\",\" + \"\\n\" +\n@\" \"\"description\"\": \"\"Hello, This is description of Mat1\"\"\" + \"\\n\" +\n@\" }\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" }\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" },\" + \"\\n\" +\n@\" {\" + \"\\n\" +\n@\" \"\"stopType\"\": \"\"pickup\"\",\" + \"\\n\" +\n@\" \"\"stopReferenceId\"\": \"\"abc\"\",\" + \"\\n\" +\n@\" \"\"customer\"\": {\" + \"\\n\" +\n@\" \"\"id\"\": \"\"customer-company-6439\"\",\" + \"\\n\" +\n@\" \"\"originalCustomerId\"\": \"\"\"\",\" + \"\\n\" +\n@\" \"\"poNumbers\"\": [\" + \"\\n\" +\n@\" \"\"po-delivery-1\"\",\" + \"\\n\" +\n@\" \"\"po-delivery-2\"\"\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" },\" + \"\\n\" +\n@\" \"\"name\"\": \"\"CypressSt\"\",\" + \"\\n\" +\n@\" \"\"loadingType\"\": \"\"drop-hook\"\",\" + \"\\n\" +\n@\" \"\"externalAddressId\"\": \"\"ZACHARY\"\",\" + \"\\n\" +\n@\" \"\"completeAddress\"\": null,\" + \"\\n\" +\n@\" \"\"addressLine1\"\": null,\" + \"\\n\" +\n@\" \"\"city\"\": null,\" + \"\\n\" +\n@\" \"\"state\"\": null,\" + \"\\n\" +\n@\" \"\"country\"\": null,\" + \"\\n\" +\n@\" \"\"postalCode\"\": null,\" + \"\\n\" +\n@\" \"\"latitude\"\": null,\" + \"\\n\" +\n@\" \"\"longitude\"\": null,\" + \"\\n\" +\n@\" \"\"geofencePoints\"\": [],\" + \"\\n\" +\n@\" \"\"appointmentTime\"\": \"\"2024-12-13T20:00:00.000Z\"\",\" + \"\\n\" +\n@\" \"\"wantTime\"\": \"\"2024-12-30T20:00:00.000Z\"\",\" + \"\\n\" +\n@\" \"\"earliestWantTime\"\": null,\" + \"\\n\" +\n@\" \"\"latestWantTime\"\": null,\" + \"\\n\" +\n@\" \"\"transportationMode\"\": \"\"Air\"\",\" + \"\\n\" +\n@\" \"\"addressType\"\": \"\"\"\",\" + \"\\n\" +\n@\" \"\"useLocalLatLng\"\": true,\" + \"\\n\" +\n@\" \"\"pallets\"\": [\" + \"\\n\" +\n@\" {\" + \"\\n\" +\n@\" \"\"number\"\": 1,\" + \"\\n\" +\n@\" \"\"parts\"\": [\" + \"\\n\" +\n@\" {\" + \"\\n\" +\n@\" \"\"customerPartNumber\"\": \"\"Mat2\"\",\" + \"\\n\" +\n@\" \"\"quantity\"\": 10,\" + \"\\n\" +\n@\" \"\"shipperPartNumber\"\": \"\"Mat2\"\",\" + \"\\n\" +\n@\" \"\"weight\"\": \"\"3072.0 LB\"\",\" + \"\\n\" +\n@\" \"\"description\"\": \"\"Hello, This is description of Mat2\"\"\" + \"\\n\" +\n@\" }\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" }\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" }\" + \"\\n\" +\n@\" ]\" + \"\\n\" +\n@\" },\" + \"\\n\" +\n@\" \"\"simpleUpdate\"\": true\" + \"\\n\" +\n@\"}\";\nrequest.AddParameter(\"application/json\", body, ParameterType.RequestBody);\nIRestResponse response = client.Execute(request);\nConsole.WriteLine(response.Content);", "customLabel": "" }, { "id": "n9j9uXBPGTMEIR-0KyPP8", "language": "go", "code": "package main\n\nimport (\n \"fmt\"\n \"strings\"\n \"net/http\"\n \"io/ioutil\"\n)\n\nfunc main() {\n\n url := \"https://api-staging.fourkites.com/api/v1/tracking\"\n method := \"POST\"\n\n payload := strings.NewReader(`{\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"trailerNumber\": \"2106030123\"\n },\n \"load\": {\n \"loadNumber\": \"Test-appointment\",\n \"nonTrackable\": false,\n \"priority\": \"hot\",\n \"originalScac\": \"csapitl\",\n \"carrierPermalink\": \"carrierseranew\",\n \"carrierName\": \"carrierseranew\",\n \"tags\": [],\n \"shipper\": null,\n \"products\": [],\n \"referenceNumbers\": [\n \"2256492\",\n \"ProductType: Bulk\"\n ],\n \"stops\": [\n {\n \"stopType\": \"delivery\",\n \"stopReferenceId\": \"xyz\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"poNumbers\": [\n \"po-pickup-1\"\n ]\n },\n \"completeAddress\": \"976 County Road 394, Delphos, KS, US\",\n \"addressLine1\": \"976 County Road 394\",\n \"city\": \"Delphos\",\n \"state\": \"KS\",\n \"county\": \"Cloud\",\n \"loadingType\": \"Drop-HOOK\",\n \"country\": \"US\",\n \"postalCode\": \"67436\",\n \"latitude\": 39.31831267307849,\n \"longitude\": -97.7440669937134,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-23T20:00:00.000Z\",\n \"wantTime\": null,\n \"earliestWantTime\": null,\n \"latestWantTime\": null,\n \"transportationMode\": \"truck\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat1\",\n \"quantity\": 1000,\n \"shipperPartNumber\": \"Mat1\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat1\"\n }\n ]\n }\n ]\n },\n {\n \"stopType\": \"pickup\",\n \"stopReferenceId\": \"abc\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"originalCustomerId\": \"\",\n \"poNumbers\": [\n \"po-delivery-1\",\n \"po-delivery-2\"\n ]\n },\n \"name\": \"CypressSt\",\n \"loadingType\": \"drop-hook\",\n \"externalAddressId\": \"ZACHARY\",\n \"completeAddress\": null,\n \"addressLine1\": null,\n \"city\": null,\n \"state\": null,\n \"country\": null,\n \"postalCode\": null,\n \"latitude\": null,\n \"longitude\": null,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-13T20:00:00.000Z\",\n \"wantTime\": \"2024-12-30T20:00:00.000Z\",\n \"earliestWantTime\": null,\n \"latestWantTime\": null,\n \"transportationMode\": \"Air\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat2\",\n \"quantity\": 10,\n \"shipperPartNumber\": \"Mat2\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat2\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"simpleUpdate\": true\n}`)\n\n client := &http.Client {\n }\n req, err := http.NewRequest(method, url, payload)\n\n if err != nil {\n fmt.Println(err)\n return\n }\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"apikey\", \"REPLACE_KEY_VALUE\")\n\n res, err := client.Do(req)\n if err != nil {\n fmt.Println(err)\n return\n }\n defer res.Body.Close()\n\n body, err := ioutil.ReadAll(res.Body)\n if err != nil {\n fmt.Println(err)\n return\n }\n fmt.Println(string(body))\n}", "customLabel": "" }, { "id": "MsysfcVOH1PDojkwtfVwd", "language": "ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api-staging.fourkites.com/api/v1/tracking\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"Content-Type\"] = \"application/json\"\nrequest[\"apikey\"] = \"REPLACE_KEY_VALUE\"\nrequest.body = JSON.dump({\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"trailerNumber\": \"2106030123\"\n },\n \"load\": {\n \"loadNumber\": \"Test-appointment\",\n \"nonTrackable\": false,\n \"priority\": \"hot\",\n \"originalScac\": \"csapitl\",\n \"carrierPermalink\": \"carrierseranew\",\n \"carrierName\": \"carrierseranew\",\n \"tags\": [],\n \"shipper\": nil,\n \"products\": [],\n \"referenceNumbers\": [\n \"2256492\",\n \"ProductType: Bulk\"\n ],\n \"stops\": [\n {\n \"stopType\": \"delivery\",\n \"stopReferenceId\": \"xyz\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"poNumbers\": [\n \"po-pickup-1\"\n ]\n },\n \"completeAddress\": \"976 County Road 394, Delphos, KS, US\",\n \"addressLine1\": \"976 County Road 394\",\n \"city\": \"Delphos\",\n \"state\": \"KS\",\n \"county\": \"Cloud\",\n \"loadingType\": \"Drop-HOOK\",\n \"country\": \"US\",\n \"postalCode\": \"67436\",\n \"latitude\": 39.31831267307849,\n \"longitude\": -97.7440669937134,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-23T20:00:00.000Z\",\n \"wantTime\": nil,\n \"earliestWantTime\": nil,\n \"latestWantTime\": nil,\n \"transportationMode\": \"truck\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat1\",\n \"quantity\": 1000,\n \"shipperPartNumber\": \"Mat1\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat1\"\n }\n ]\n }\n ]\n },\n {\n \"stopType\": \"pickup\",\n \"stopReferenceId\": \"abc\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"originalCustomerId\": \"\",\n \"poNumbers\": [\n \"po-delivery-1\",\n \"po-delivery-2\"\n ]\n },\n \"name\": \"CypressSt\",\n \"loadingType\": \"drop-hook\",\n \"externalAddressId\": \"ZACHARY\",\n \"completeAddress\": nil,\n \"addressLine1\": nil,\n \"city\": nil,\n \"state\": nil,\n \"country\": nil,\n \"postalCode\": nil,\n \"latitude\": nil,\n \"longitude\": nil,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-13T20:00:00.000Z\",\n \"wantTime\": \"2024-12-30T20:00:00.000Z\",\n \"earliestWantTime\": nil,\n \"latestWantTime\": nil,\n \"transportationMode\": \"Air\",\n \"addressType\": \"\",\n \"useLocalLatLng\": true,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat2\",\n \"quantity\": 10,\n \"shipperPartNumber\": \"Mat2\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat2\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"simpleUpdate\": true\n})\n\nresponse = https.request(request)\nputs response.read_body\n", "customLabel": "" }, { "id": "9s_M9A4gtewNaS3pDVX8s", "language": "python", "code": "import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api-staging.fourkites.com\")\npayload = json.dumps({\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"trailerNumber\": \"2106030123\"\n },\n \"load\": {\n \"loadNumber\": \"Test-appointment\",\n \"nonTrackable\": False,\n \"priority\": \"hot\",\n \"originalScac\": \"csapitl\",\n \"carrierPermalink\": \"carrierseranew\",\n \"carrierName\": \"carrierseranew\",\n \"tags\": [],\n \"shipper\": None,\n \"products\": [],\n \"referenceNumbers\": [\n \"2256492\",\n \"ProductType: Bulk\"\n ],\n \"stops\": [\n {\n \"stopType\": \"delivery\",\n \"stopReferenceId\": \"xyz\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"poNumbers\": [\n \"po-pickup-1\"\n ]\n },\n \"completeAddress\": \"976 County Road 394, Delphos, KS, US\",\n \"addressLine1\": \"976 County Road 394\",\n \"city\": \"Delphos\",\n \"state\": \"KS\",\n \"county\": \"Cloud\",\n \"loadingType\": \"Drop-HOOK\",\n \"country\": \"US\",\n \"postalCode\": \"67436\",\n \"latitude\": 39.31831267307849,\n \"longitude\": -97.7440669937134,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-23T20:00:00.000Z\",\n \"wantTime\": None,\n \"earliestWantTime\": None,\n \"latestWantTime\": None,\n \"transportationMode\": \"truck\",\n \"addressType\": \"\",\n \"useLocalLatLng\": True,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat1\",\n \"quantity\": 1000,\n \"shipperPartNumber\": \"Mat1\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat1\"\n }\n ]\n }\n ]\n },\n {\n \"stopType\": \"pickup\",\n \"stopReferenceId\": \"abc\",\n \"customer\": {\n \"id\": \"customer-company-6439\",\n \"originalCustomerId\": \"\",\n \"poNumbers\": [\n \"po-delivery-1\",\n \"po-delivery-2\"\n ]\n },\n \"name\": \"CypressSt\",\n \"loadingType\": \"drop-hook\",\n \"externalAddressId\": \"ZACHARY\",\n \"completeAddress\": None,\n \"addressLine1\": None,\n \"city\": None,\n \"state\": None,\n \"country\": None,\n \"postalCode\": None,\n \"latitude\": None,\n \"longitude\": None,\n \"geofencePoints\": [],\n \"appointmentTime\": \"2024-12-13T20:00:00.000Z\",\n \"wantTime\": \"2024-12-30T20:00:00.000Z\",\n \"earliestWantTime\": None,\n \"latestWantTime\": None,\n \"transportationMode\": \"Air\",\n \"addressType\": \"\",\n \"useLocalLatLng\": True,\n \"pallets\": [\n {\n \"number\": 1,\n \"parts\": [\n {\n \"customerPartNumber\": \"Mat2\",\n \"quantity\": 10,\n \"shipperPartNumber\": \"Mat2\",\n \"weight\": \"3072.0 LB\",\n \"description\": \"Hello, This is description of Mat2\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"simpleUpdate\": True\n})\nheaders = {\n 'Content-Type': 'application/json',\n 'apikey': 'REPLACE_KEY_VALUE'\n}\nconn.request(\"POST\", \"/api/v1/tracking\", payload, headers)\nres = conn.getresponse()\ndata = res.read()\nprint(data.decode(\"utf-8\"))", "customLabel": "" } ], "selectedLanguageId": "yfIZX8PulPqkOs5V0qsYN" }, "results": { "languages": [ { "id": "HKDIxxuWLl7i1XUUOjAJj", "language": "200", "customLabel": "", "code": "{\n \"loadId\": 432728294,\n \"message\": \"Load creation request has been submitted successfully\",\n \"requestId\": \"cpcqp7k6o9momjngb5rg\",\n \"statusCode\": 200\n}" } ], "selectedLanguageId": "HKDIxxuWLl7i1XUUOjAJj" }, "request": { "pathParameters": [], "queryParameters": [], "headerParameters": [], "bodyDataParameters": [ { "name": "trackingInfo", "kind": "optional", "type": "object", "description": "It indicates the information required for tracking the load.", "children": [ { "name": "driverPhone", "kind": "optional", "type": "string", "description": "It indicates a valid mobile number. Example: +13125555555" }, { "name": "trailerNumber", "kind": "optional", "type": "string", "description": "It indicates the trailer number assigned to the load." } ] }, { "name": "load", "kind": "optional", "type": "object", "description": "It is the parent object for the load. Place the load attributes inside this object.", "children": [ { "name": "loadNumber", "kind": "required", "type": "string", "description": "Unique load identifier from shipper's system. The load Number or BOL is an important piece of information used to link the load with truck information received from the Carrier's TMS" }, { "name": "nonTrackable", "kind": "optional", "type": "string", "description": "indicator specifying if the load should be created in the Core Track platform. If \"true\" the load will bypass Core Track (as it is considered \"non-trackable\") but the data will continue to pass down to Appointment Manager and Dynamic Yard for use as appointments and deliveries" }, { "name": "priority", "kind": "optional", "type": "string", "description": "It indicates whether a load is of normal or high priority. If priority is set as ‘hot’, the load will be marked as ‘Hot’. Valid values: ‘normal’, ‘high’ and ‘hot’. Defaults to normal. Setting the 'Priority' as 'hot' will mark the load as 'Hot' load." }, { "name": "originalScac", "kind": "optional", "type": "string", "description": "SCAC or Service Provider ID of the carrier assigned to the load. The carrier should have approved sharing of their telematics data on FourKites for the customer" }, { "name": "carrierPermalink", "kind": "optional", "type": "string", "description": "Permalink of the carrier" }, { "name": "carrierName", "kind": "optional", "type": "string", "description": "Name of the carrier." }, { "name": "tags", "kind": "required", "type": "array", "description": "List of labels or categories associated with the load. Tags can be used to filter groups of loads" }, { "name": "products", "kind": "optional", "type": "object", "description": "It indicates the list of temperature tracked products on a load and their temperature tracking information." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It is the list of load level reference numbers associated with a load. (CM)" }, { "name": "stops", "kind": "optional", "type": "object", "description": "Stop-specific parameters.", "children": [ { "name": "stopType", "kind": "optional", "type": "string", "description": "Indicates whether the stop is a pickup, delivery stop. " }, { "name": "stopReferenceId", "kind": "optional", "type": "string", "description": "Alphanumeric code generated in the load creator’s system which is unique to a specific stop in a specific load. It is used to know which stop and update is applied to in FourKites" }, { "name": "customer", "kind": "optional", "type": "object", "description": "Customer-specific parameters", "children": [ { "name": "id", "kind": "optional", "type": "string", "description": "Unique identifier for a customer loaded in the shipper’s master data in FourKites. Please refer to supporting documentation on using customers in FourKites" }, { "name": "poNumbers", "kind": "optional", "type": "string", "description": "List of PO Numbers associated with the stop" } ] }, { "name": "completeAddress", "kind": "optional", "type": "string", "description": "Complete address of the stop" }, { "name": "addressLine1", "kind": "required", "type": "string", "description": "First line of the stop’s street address" }, { "name": "city", "kind": "required", "type": "string", "description": "Stop's city" }, { "name": "state", "kind": "required", "type": "string", "description": "Stop's state" }, { "name": "county", "kind": "optional", "type": "string", "description": "To which county the stop belong to" }, { "name": "loadingType", "kind": "optional", "type": "string", "description": "Indicates whether the loading type is live or drop-hook" }, { "name": "country", "kind": "required", "type": "string", "description": "Valid country code of the stop" }, { "name": "postalCode", "kind": "required", "type": "string", "description": "Valid postal code of the stop" }, { "name": "latitude", "kind": "optional", "type": "string", "description": "It indicates the latitude of the stop's location. \tIt is formatted to decimal degrees.The only accepted format of lat/long by FourKites is the \"Decimal Degrees\" format. For example: 41.8781 (lat), -87.6298 (long)." }, { "name": "longitude", "kind": "optional", "type": "string", "description": "It indicates the longitude of the stop's location. \tIt is formatted to decimal degrees.The only accepted format of lat/long by FourKites® is the \"Decimal Degrees\" format. For example: 41.8781 (lat), -87.6298 (long)." }, { "name": "geofencePoints", "kind": "optional", "type": "array", "description": "It indicates the list of lat/long coordinates of the corners of the polygon geofence around the stop to be used for detecting arrival." }, { "name": "appointmentTime", "kind": "required", "type": "string", "description": "It indicates the scheduled appointment time at the stop in the stop's local time zone in ISO 8601 format. ISO 8601 format Appointment times cannot be more than 4 days in the past from the current time." }, { "name": "wantTime", "kind": "optional", "type": "string", "description": "It indicates the time by which the load must be delivered to the consignee in stop's local time zone in ISO 8601 format. (CM)\n" }, { "name": "earliestWantTime", "kind": "required", "type": "string", "description": "It indicates the earliest time by which the load must be delivered to the consignee in the stop's local timezone in ISO 8601 format. (CM). If the earliestWantTime is sent, then the latestWantTime must also be sent." }, { "name": "latestWantTime", "kind": "required", "type": "string", "description": "It indicates the latest time by which the load must be delivered to the consignee in the stop's local timezone in ISO 8601 format. (CM). If the latestWantTime is sent, then the earliestWantTime must also be sent." }, { "name": "transportationMode", "kind": "optional", "type": "string", "description": "It defines the mode of the load. Valid values: \"TL\", \"LTL\", \"PARCEL\"" }, { "name": "pallets", "kind": "optional", "type": "object", "description": "It indicates the list of pallets to be delivered at the stop. Each pallet has a pallet number and list of parts.", "children": [ { "name": "number", "kind": "optional", "type": "string", "description": "Indicates total number of pallets" }, { "name": "parts", "kind": "optional", "type": "object", "description": "It indicates the list of parts in the pallet.", "children": [ { "name": "customerPartNumber", "kind": "optional", "type": "string", "description": "It indicates the customer part number." }, { "name": "quantity", "kind": "optional", "type": "string", "description": "It indicates the quantity of the part." }, { "name": "shipperPartNumber", "kind": "optional", "type": "string", "description": "It indicates the shipper/manufacturer’s part number." }, { "name": "weight", "kind": "optional", "type": "string", "description": "It indicates the weight of the part." }, { "name": "description", "kind": "optional", "type": "string", "description": "Description given to the part of the pallet" } ] } ] } ] } ] } ], "formDataParameters": [] }, "currentNewParameter": { "label": "Body Parameter", "value": "bodyDataParameters" }, "autoGeneratedAnchorSlug": "staging", "legacyHash": "gX-jv0lghnHMx--gSfC5Q" } ``` ::: ![](https://api.archbee.com/api/optimize/2iLZ8zq0u-v-CPzk98WTR/KiNH27-sENdT7iD9pA6ub_screenshot-2024-05-31-at-62641-pm.png) 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
 
  |