--- title: Create Shipment slug: fourkites-api-reference/create-shipment description: Learn how to create and track loads in FourKites® API with this comprehensive document. Discover code snippets for making POST requests in various programming languages, setting up request headers and bodies, and handling responses. Dive into load paramet icon: {"faIcon":"fa-solid fa-folder-open"} createdAt: 2023-03-24T08:54:26.000Z --- :::CtaButton{label="Request Attribute Table - All Load Modes" docId="op9nYTAQBlMAe0_TqFBcw" openInNewTab="true"} ::: :::hint{type="danger"} ### ⚠️ Important Update: The Pallets structure is being deprecated. Please transition to for product details. [Learn more](https://docs.fourkites.com/api-reference/BXk7-create-shipment#ICU0Y) ::: :::hint{type="success"} Please be advised that the terms "**Shipment**" and "**Load**" are interchangeable in all our API documentation. ::: :::hint{type="info"} If you receive a server error **(5xx error code)**, please try again a few times. It's best to wait a little longer between each retry attempt. Try at least 3-5 times before giving up, as many server issues resolve themselves quickly. ::: Create Shipment/Load API allows authorized users to create a new load for tracking. :::hint{type="warning"} This API is called after the carrier has accepted the tender for the load. FourKites does not limit customers from creating more than one load with the same load number or PRO number -- creation of more than one load with the same load or PRO number will cause duplication of loads, which will end up affecting the tracking performance. Customers are advised to handle this on their side. To learn more about Idempotency Protection, [refer here](https://docs.fourkites.com/api-reference/idempotency-protection). ::: :::hint{type="warning"} When you create a load using only `latitude` and `longitude` without including other address details (such as `city`, `state`, `country`, or `addressLine`), you need to ensure the **Process Lat/Long From API** flag is enabled for your company. If not, reach out to your Customer Success Manager at FourKites to have it enabled. If the **Process Lat/Long From API** flag is enabled for your company, you do not have to consider `addressLine1` as a mandatory field. ::: :::hint{type="info"} ### Shipment Creation Timeliness **OTR Shipments**: We highly recommend creating shipments before the pickup appointment. Ideally, shipments should be created at least two days in advance to allow carriers sufficient time for asset assignment. **Ocean Shipments**: For ocean shipments, we recommend creating loads as early as possible. However, they must be created no later than before the vessel departure event occurs at the Port of Loading. **Air & Rail Shipments**: We require Air & Rail shipments to be created before pickup to ensure seamless end-to-end milestone tracking. ::: :::hint{type="info"} ### Rate Limit **1 request per second** ::: :::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). :::hint{type="info"} ### Point to note: `productLineItems` will serve as the standard place to receive product details corresponding to every stop. This structure will need to be followed going forward instead of `pallets` - `pallets` will soon be phased out. The `productId` will be a mandatory field for every product line item, and it should be unique for a specific product. ::: :::hint{type="info"} [Refer here](https://docs.fourkites.com/api-reference/BXk7-create-shipment#gqKaS) for the field descriptions of [Product Line Items](https://docs.fourkites.com/api-reference/BXk7-create-shipment#gqKaS) & [Shipment Cost Schema](https://docs.fourkites.com/api-reference/BXk7-create-shipment#wEmhS). ::: :::ApiMethodV2 ```json { "tab": "examples", "url": "https://api.fourkites.com/api/v1/tracking", "name": "Production", "method": "POST", "request": { "pathParameters": [], "queryParameters": [], "headerParameters": [], "bodyDataParameters": [ { "name": "modeDetails", "kind": "optional", "type": "object", "description": "It contains the mode information about the load that we create.", "children": [ { "name": "shipperModes", "kind": "optional", "type": "string", "description": "It defines the mode of the load. Valid values: \"TL\", \"LTL\", \"RAIL\", \"OCEAN\", \"PARCEL\", \"AIR\"" }, { "name": "carrierModes", "kind": "optional", "type": "string", "description": "It defines the mode of the load. Valid values: \"TL\", \"LTL\", \"RAIL\", \"OCEAN\", \"PARCEL\", \"AIR" } ] }, { "name": "load", "kind": "required", "type": "object", "description": "It is the parent object for the load. Place the load attributes inside this object.", "children": [ { "name": "carrierPermalink", "kind": "optional", "type": "string", "description": "It is the unique identifier for the carrier in the FK platform." }, { "name": "carrierName", "kind": "optional", "type": "string", "description": "It is the name of the carrier in the FK platform." }, { "name": "carrier", "kind": "required", "type": "string", "description": "It is the 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": "shipperAccountNumber", "kind": "optional", "type": "string", "description": "The shipper's carrier account number, used to identify the shipper account associated with a shipment. Enables carrier integrations to retrieve account-gated data such as proof of delivery documents and signature images. " }, { "name": "haulType", "kind": "optional", "type": "array", "description": "It indicates whether the load is an inbound or an outbound load. Valid values: \"inbound_load\", \"outbound_load\", \"short_haul\", \"round_trip\", \"brokered_load\", \"non-brokered_load\", \"inbound_load\", \"outbound_load\", travel_ban_warnings\"" }, { "name": "loadNumber", "kind": "required", "type": "string", "description": "It is the 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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the Oload." }, { "name": "bookingNumber", "kind": "optional", "type": "string", "description": "It indicates the shipping line's booking number" }, { "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": "masterSequenceNumber", "kind": "optional", "type": "string", "description": "It is the unique sequence number that represents the leg of the trip used for Consignment Pooling." }, { "name": "masterReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of consignment loads in order to group them. For example, consignmentReferenceNumber: “XAF-BATCH-1”. (Conditional Mandatory)" }, { "name": "simulaneousTrackingReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of simultaneous loads in order to group them. For example, simultaneousTrackingReferenceNumber: “E900018290”" }, { "name": "proNumber", "kind": "optional", "type": "string", "description": "This is a number that is created usually after pickup or at pickup for LTL loads. CM for LTL loads" }, { "name": "products", "kind": "optional", "type": "object", "description": "It indicates the list of temperature tracked products on a load and their temperature tracking information.", "children": [ { "name": "lowerTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the lower bound (in degrees Fahrenheit) of the acceptable temperature range for a product." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of a temperature tracked product." }, { "name": "productId", "kind": "optional", "type": "string", "description": "It indicates the FourKites - internal unique identifier for a temperature tracked product. This is a primary key and duplicates are not allowed. The value must already exist in FourKites®." }, { "name": "setTemperature", "kind": "optional", "type": "string", "description": "It indicates the target temperature at which the product is maintained." }, { "name": "timeToleranceInMinutes", "kind": "optional", "type": "string", "description": "It indicates the acceptable time (in minutes) for a product to maintain a temperature outside the defined temperature range. Exceeding this range for a period of time equal to or greater than this time tolerance will display a critical alert in the Temperature Tracking section of a load." }, { "name": "upperTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the upper bound (in degrees Fahrenheit) of the acceptable temperature range for a product." } ] }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It is the list of load-level reference numbers associated with a load. (CM)" }, { "name": "relayLoad", "kind": "optional", "type": "boolean", "description": "It indicates whether the load is relay or team load. \tValid values: true or false. Defaults to false. (CM)" }, { "name": "stops", "kind": "required", "type": "object", "description": "It is the list of stops for the load.", "children": [ { "name": "addressLine1", "kind": "required", "type": "string", "description": "It indicates the first line of the stop's address." }, { "name": "addressLine2", "kind": "optional", "type": "string", "description": "It indicates the second line of the stop's address." }, { "name": "city", "kind": "required", "type": "string", "description": "It indicates the name of the city. \tWhen we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now we have a restriction to pass state name when the stop doesn't have external AddressId and we match the port with only city & country." }, { "name": "country", "kind": "optional", "type": "string", "description": "It indicates the valid country code. It is the 2 digit country code. When we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now, we have a restriction to pass the state name when the stop doesn't have external AddressId and we want to match the port with only city & country." }, { "name": "customer", "kind": "optional", "type": "object", "description": "It indicates the customer information for the stop. (CM)", "children": [ { "name": "id", "kind": "optional", "type": "string", "description": "It is the unique identifier of the shipper's customer. The customer should have been created in FourKites before associating it to a load's stop. This field is mandatory for new customer creation.(CM)" }, { "name": "poNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of Customer PO Numbers associated with the load's stop. (CM)" }, { "name": "pointOfContact", "kind": "optional", "type": "object", "description": "It indicates the point of contact (POC) information at the stop, capturing name, email, phone number, and whether they should be alerted. You can send up to 5 POCs objects per stop.", "children": [ { "name": "alert", "kind": "optional", "type": "boolean", "description": "It indicates the flag to enable or disable email notifications to the point of contact." }, { "name": "email", "kind": "optional", "type": "string", "description": "It indicates the email address of the point of contact at the stop." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of the point of contact at the stop." }, { "name": "phone", "kind": "optional", "type": "string", "description": "It indicates the phone number of the point of contact at the stop. The ISD code followed by mobile number prepended with \"+\" and no special characters." } ] }, { "name": "name", "kind": "optional", "type": "string", "description": "Name of the customer to automatically pull in customer records. This field along with Id is mandatory for new customer creation." }, { "name": "customerPoFields", "kind": "optional", "type": "object", "description": "This is a list (array) of objects containing purchase order-related details from the customer.", "children": [ { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Represents the delivery number or identifier associated with the purchase order." }, { "name": "deliveryReference", "kind": "optional", "type": "string", "description": "A reference code or identifier related to the delivery, possibly provided by the customer or logistics team." }, { "name": "orderReference", "kind": "optional", "type": "string", "description": "A unique reference for the order, used to track and manage the purchase order." } ] }, { "name": "Parameter name", "kind": "optional", "type": "string", "description": "" } ] }, { "name": "earliestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the earliest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the earliestAppointmentTime is sent, then the latestAppointmentTime must also be sent." }, { "name": "earliestWantTime", "kind": "optional", "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)" }, { "name": "externalAddressId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. UNLOCODE is preferred for port stop creation in the FK platform." }, { "name": "latestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the latest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestAppointmentTime is sent, then the earliestAppointmentTime must also be sent. latestAppointmentTime should be greater than or equal to earliestAppointmentTime." }, { "name": "latestWantTime", "kind": "optional", "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. ISO 8601 format. If the latestWantTime is sent, then the earliestWantTime must also be sent. (CM)" }, { "name": "name", "kind": "required", "type": "string", "description": "It is the name of the stop." }, { "name": "loadingType", "kind": "optional", "type": "string", "description": "Indicates whether the load or shipment is Live or Drop. Valid values : \"live\" or \"drop\"" }, { "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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the pallet record." }, { "name": "number", "kind": "optional", "type": "string", "description": "It indicates the pallet number." }, { "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’s part number." }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "It indicates the part's order 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": "It indicates the description given for the material within the pallet." } ] } ] }, { "name": "postalCode", "kind": "optional", "type": "string", "description": "It indicates the valid postal code for the stop." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of stop level reference numbers associated with the stop. These are searchable within the FourKites platform. (CM)" }, { "name": "sequence", "kind": "optional", "type": "string", "description": "It indicates the stop's sequence on a load. The lower value indicates earliest scheduled stop completion. If the stop sequence is present for one stop on a load, it must be present on all stops. It is recommended to start at 1 and increment by 1 for each additional stop. (CM)" }, { "name": "shipTo", "kind": "optional", "type": "string", "description": "It is the ship to location ID associated with the stop. The shipTo values associated with pickup stops can be filtered using the \"Ship From\" filter. (CM)" }, { "name": "state", "kind": "required", "type": "string", "description": "It indicates the 2 character state code for US & Canada and 3 Character state code for Mexico. It is the 2 character State Code for US & Canada and 3 Character State Code for Mexico." }, { "name": "stopReferenceId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the stop from the customer's system. This populates the \"Reference #\" field on the stop and is used to indicate which stop an update is applied to. (CM)" }, { "name": "stopType", "kind": "required", "type": "string", "description": "It defines the function of the stop. Valid values: \"pickup\", \"delivery\", \"transfer\", \"portOfLoading\", \"transshipmentPort\", \"portOfDischarge\". There should be at least one pickup and delivery stop or one transfer (terminal) and one delivery." }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. \tFor ocean loads, use the port's UNLOCODE." }, { "name": "unloadTimeInMinutes", "kind": "optional", "type": "string", "description": "It indicates the dwell time to be used for the stop in ETA calculations (in minutes). When it is not provided, the company level default value will be used, if available or 90 minutes. This value must be sent in minutes." }, { "name": "productLineItems", "kind": "optional", "type": "object", "description": "", "children": [ { "name": "productId", "kind": "required", "type": "string", "description": "Unique identifier for the product. Mandatory if productLineItems object is present" }, { "name": "productDescription", "kind": "optional", "type": "string", "description": "Detailed description of the product" }, { "name": "productCategory", "kind": "optional", "type": "string", "description": "Category classification of the product" }, { "name": "quantity", "kind": "optional", "type": "integer", "description": "Number of units in the shipment" }, { "name": "measurementUnitCode", "kind": "optional", "type": "string", "description": "Unit of measurement for quantity (e.g., PCE, KG, LB)" }, { "name": "netWeight", "kind": "optional", "type": "string", "description": "Weight of the product excluding packaging" }, { "name": "weightUnit", "kind": "optional", "type": "string", "description": "Unit of measurement for weight (e.g., KGM, LBM)" }, { "name": "unitCost", "kind": "optional", "type": "number", "description": "Cost per unit of the product" }, { "name": "currencyCode", "kind": "optional", "type": "string", "description": "Currency code for cost fields" }, { "name": "extendedCost", "kind": "optional", "type": "number", "description": "Total cost for all units (unitCost × quantity)" }, { "name": "freightCost", "kind": "optional", "type": "number", "description": "Freight cost allocated to this line item" }, { "name": "bestBeforeDate", "kind": "optional", "type": "string", "description": "Expiration or best before date for the product" }, { "name": "additionalCharges", "kind": "optional", "type": "number", "description": "Any additional charges specific to this line item" }, { "name": "tariffCost", "kind": "optional", "type": "number", "description": "Tariff cost for this specific line item" }, { "name": "fourKitesCalculatedTariffCost", "kind": "optional", "type": "number", "description": "System-calculated tariff cost" }, { "name": "totalLandedCost", "kind": "optional", "type": "number", "description": "Total landed cost for this line item" }, { "name": "countryOfOrigin", "kind": "optional", "type": "string", "description": "Country of origin for this product" }, { "name": "harmonizedSystemCode", "kind": "optional", "type": "string", "description": "International trade classification code" }, { "name": "commodityTypeCode", "kind": "optional", "type": "string", "description": "Commodity classification code" }, { "name": "htsusCode", "kind": "optional", "type": "string", "description": "Harmonized Tariff Schedule code for US imports" }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "Purchase order number" }, { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Delivery reference number" }, { "name": "handlingUnitId", "kind": "optional", "type": "string", "description": "Identifier for the handling unit (pallet, box, etc.)" }, { "name": "barcode", "kind": "optional", "type": "string", "description": "Product barcode" }, { "name": "containerType", "kind": "optional", "type": "string", "description": "Type of container (pallet, box, carton, etc.)" }, { "name": "gtin", "kind": "optional", "type": "string", "description": "Global Trade Item Number" }, { "name": "customerPartNumber", "kind": "optional", "type": "string", "description": "Customer's part number for the product" }, { "name": "supplierPartNumber", "kind": "optional", "type": "string", "description": "Supplier's part number for the product" }, { "name": "manufacturerPartNumber", "kind": "optional", "type": "string", "description": "Manufacturer's part number" }, { "name": "itemNumber", "kind": "optional", "type": "string", "description": "Internal item number" }, { "name": "productUpc", "kind": "optional", "type": "string", "description": "Universal Product Code" }, { "name": "deliveryReferences", "kind": "optional", "type": "string", "description": "Array of delivery reference numbers" }, { "name": "orderReferences", "kind": "optional", "type": "string", "description": "Array of order reference numbers" }, { "name": "brandName", "kind": "optional", "type": "string", "description": "Brand name of the product" }, { "name": "minimumTemperature", "kind": "optional", "type": "integer", "description": "Minimum storage/transport temperature" }, { "name": "maximumTemperature", "kind": "optional", "type": "integer", "description": "Maximum storage/transport temperature" }, { "name": "temperatureUnitCode", "kind": "optional", "type": "string", "description": "Temperature unit (cel, fah)" }, { "name": "labelIdentifier", "kind": "optional", "type": "string", "description": "Label identifier for tracking" }, { "name": "productTrackingNumber", "kind": "optional", "type": "string", "description": "Unique tracking number for the product" }, { "name": "deviceType", "kind": "optional", "type": "string", "description": "Type of tracking device (RFID_TAG, QR_CODE, etc.)" } ] } ] }, { "name": "tags", "kind": "optional", "type": "array", "description": "It is the list of tags or labels to be assigned to a load. Loads can be filtered in FourKites using tags. It is used for assigning categories for the load. A single tag can't exceed 50 characters. Even though we don’t have restrictions on the number of tags, it is advisable to keep total characters of all tags within the count of 255. (CM)" }, { "name": "trackingInfo", "kind": "optional", "type": "object", "description": "It indicates the information required for tracking the load.", "children": [ { "name": "deviceId", "kind": "optional", "type": "string", "description": "It indicates the ID of the GPS puck attached to the pallet or the trailer." }, { "name": "driverId", "kind": "optional", "type": "string", "description": "It indicates the driver ID used for CarrierLink access for private fleet owners. The driver ID is used by drivers of private fleet owners to log into CarrierLink and see the loads assigned to them. There should be an existing driver user in the platform with the same driver ID." }, { "name": "driverPhone", "kind": "optional", "type": "string", "description": "It indicates a valid mobile number. Example: +13125555555. \tThe ISD code followed by mobile number prepended with \"+\" and no special characters." }, { "name": "mawb", "kind": "optional", "type": "string", "description": "The carrier’s air waybill issued to cover a consolidated shipment tendered by a forwarder or consolidator." }, { "name": "trailerNumber", "kind": "optional", "type": "string", "description": "It indicates the trailer number assigned to the load." }, { "name": "truckNumber", "kind": "optional", "type": "string", "description": "It indicates the tractor or asset number dispatched by the carrier for the load." } ] }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is for parcel tracking only; any tracking number provided by the carrier or other entities." }, { "name": "truckRoutingParams", "kind": "optional", "type": "object", "description": "It indicates the information required for getting truck specific routing. If provided, the routing of the truck and ETA calculations will be done based on these parameters.", "children": [ { "name": "height", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s height in meters. Valid values: Between 0 and 50." }, { "name": "length", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s length in meters. Valid values: Between 0 and 300." }, { "name": "limitedWeight", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight including trailers and shipped goods in tons. Valid values: Between 0 and 1000." }, { "name": "shippedHazardousGoods", "kind": "optional", "type": "string", "description": "It indicates the list of hazaradous materials in the vehicle. Enum [explosive , gas , flammable , organic , combustible , poison , radioActive , corrosive , poisonousInhalation , harmfulToWater , other]. Valid values: \"explosive\", \"gas\", \"flammable\", \"organic\", \"combustible\", \"poison\", \"radioActive\", \"corrosive\", \"poisonousInhalation\", \"harmfulToWater\", \"other\".\n\nThe shippedHazardousGoods parameter is used in the HERE Maps API to retrieve route and distance details. This parameter is critical because certain routes prohibit the transportation of hazardous goods. By incorporating this parameter, we can ensure the selection of compliant routes, which enables accurate ETAs, precise distance calculations, and appropriate route information." }, { "name": "trailersCount", "kind": "optional", "type": "string", "description": "It specifies the number of trailers pulled by a vehicle. Valid values: 0, 1, 2, 3,4. Defaults to 0." }, { "name": "truckType", "kind": "optional", "type": "string", "description": "It specifies the vehicle type. It defaults to truck. Enum [truck , tractorTruck]. \tValid values: \"truck\" or \"tractorTruck\"." }, { "name": "tunnelCategory", "kind": "optional", "type": "string", "description": "It specifies the tunnel category to restrict certain routes. The route will pass only through tunnels of a less strict category. Enum [B , C , D , E]. \tValid values: \"B\", \"C\", \"D\", \"E\"" }, { "name": "weightPerAxle", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight per axle in tons. Valid values: Between 0 and 1000." }, { "name": "width", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s width in meters. Valid values: Between 0 and 50." } ] }, { "name": "seal", "kind": "optional", "type": "string", "description": "It is the seal number that identifies the seal on the load." }, { "name": "sealStatus", "kind": "optional", "type": "string", "description": "It is the seal status that represents the status of the seal on the load." }, { "name": "simultaneousTrackingSequenceNumber", "kind": "optional", "type": "number", "description": "This parameter will allow Shippers and Carriers to provide the sequence number to order the delivery sequence to calculate better ETAs. \n\nThe earlier logic would consider either the shortest distance or the Appointment time to sequence the stops for ETA calculation.\n\nThe new logic will look like this:\n- If the Simultaneous tracking Sequence number is provided, this will be given the first priority.\n- If not, then use the existing logic." }, { "name": "deliveryNumbers", "kind": "optional", "type": "string", "description": "Array of strings supporting multiple delivery references per shipment (typically comma separated). Same as delivery numbers on deliveries in an order." }, { "name": "masterTrackingNumber", "kind": "optional", "type": "string", "description": "Single string field for shipment relationship tracking. This is primarily to indicate the master tracking number for split parcels." } ], "schema": [ { "name": "carrierPermalink", "kind": "optional", "type": "string", "description": "It is the unique identifier for the carrier in the FK platform." }, { "name": "carrierName", "kind": "optional", "type": "string", "description": "It is the name of the carrier in the FK platform." }, { "name": "carrier", "kind": "required", "type": "string", "description": "It is the 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": "shipperAccountNumber", "kind": "optional", "type": "string", "description": "The shipper's carrier account number, used to identify the shipper account associated with a shipment. Enables carrier integrations to retrieve account-gated data such as proof of delivery documents and signature images. " }, { "name": "haulType", "kind": "optional", "type": "array", "description": "It indicates whether the load is an inbound or an outbound load. Valid values: \"inbound_load\", \"outbound_load\", \"short_haul\", \"round_trip\", \"brokered_load\", \"non-brokered_load\", \"inbound_load\", \"outbound_load\", travel_ban_warnings\"" }, { "name": "loadNumber", "kind": "required", "type": "string", "description": "It is the 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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the Oload." }, { "name": "bookingNumber", "kind": "optional", "type": "string", "description": "It indicates the shipping line's booking number" }, { "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": "masterSequenceNumber", "kind": "optional", "type": "string", "description": "It is the unique sequence number that represents the leg of the trip used for Consignment Pooling." }, { "name": "masterReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of consignment loads in order to group them. For example, consignmentReferenceNumber: “XAF-BATCH-1”. (Conditional Mandatory)" }, { "name": "simulaneousTrackingReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of simultaneous loads in order to group them. For example, simultaneousTrackingReferenceNumber: “E900018290”" }, { "name": "proNumber", "kind": "optional", "type": "string", "description": "This is a number that is created usually after pickup or at pickup for LTL loads. CM for LTL loads" }, { "name": "products", "kind": "optional", "type": "object", "description": "It indicates the list of temperature tracked products on a load and their temperature tracking information.", "children": [ { "name": "lowerTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the lower bound (in degrees Fahrenheit) of the acceptable temperature range for a product." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of a temperature tracked product." }, { "name": "productId", "kind": "optional", "type": "string", "description": "It indicates the FourKites - internal unique identifier for a temperature tracked product. This is a primary key and duplicates are not allowed. The value must already exist in FourKites®." }, { "name": "setTemperature", "kind": "optional", "type": "string", "description": "It indicates the target temperature at which the product is maintained." }, { "name": "timeToleranceInMinutes", "kind": "optional", "type": "string", "description": "It indicates the acceptable time (in minutes) for a product to maintain a temperature outside the defined temperature range. Exceeding this range for a period of time equal to or greater than this time tolerance will display a critical alert in the Temperature Tracking section of a load." }, { "name": "upperTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the upper bound (in degrees Fahrenheit) of the acceptable temperature range for a product." } ] }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It is the list of load-level reference numbers associated with a load. (CM)" }, { "name": "relayLoad", "kind": "optional", "type": "boolean", "description": "It indicates whether the load is relay or team load. \tValid values: true or false. Defaults to false. (CM)" }, { "name": "stops", "kind": "required", "type": "object", "description": "It is the list of stops for the load.", "children": [ { "name": "addressLine1", "kind": "required", "type": "string", "description": "It indicates the first line of the stop's address." }, { "name": "addressLine2", "kind": "optional", "type": "string", "description": "It indicates the second line of the stop's address." }, { "name": "city", "kind": "required", "type": "string", "description": "It indicates the name of the city. \tWhen we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now we have a restriction to pass state name when the stop doesn't have external AddressId and we match the port with only city & country." }, { "name": "country", "kind": "optional", "type": "string", "description": "It indicates the valid country code. It is the 2 digit country code. When we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now, we have a restriction to pass the state name when the stop doesn't have external AddressId and we want to match the port with only city & country." }, { "name": "customer", "kind": "optional", "type": "object", "description": "It indicates the customer information for the stop. (CM)", "children": [ { "name": "id", "kind": "optional", "type": "string", "description": "It is the unique identifier of the shipper's customer. The customer should have been created in FourKites before associating it to a load's stop. This field is mandatory for new customer creation.(CM)" }, { "name": "poNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of Customer PO Numbers associated with the load's stop. (CM)" }, { "name": "pointOfContact", "kind": "optional", "type": "object", "description": "It indicates the point of contact (POC) information at the stop, capturing name, email, phone number, and whether they should be alerted. You can send up to 5 POCs objects per stop.", "children": [ { "name": "alert", "kind": "optional", "type": "boolean", "description": "It indicates the flag to enable or disable email notifications to the point of contact." }, { "name": "email", "kind": "optional", "type": "string", "description": "It indicates the email address of the point of contact at the stop." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of the point of contact at the stop." }, { "name": "phone", "kind": "optional", "type": "string", "description": "It indicates the phone number of the point of contact at the stop. The ISD code followed by mobile number prepended with \"+\" and no special characters." } ] }, { "name": "name", "kind": "optional", "type": "string", "description": "Name of the customer to automatically pull in customer records. This field along with Id is mandatory for new customer creation." }, { "name": "customerPoFields", "kind": "optional", "type": "object", "description": "This is a list (array) of objects containing purchase order-related details from the customer.", "children": [ { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Represents the delivery number or identifier associated with the purchase order." }, { "name": "deliveryReference", "kind": "optional", "type": "string", "description": "A reference code or identifier related to the delivery, possibly provided by the customer or logistics team." }, { "name": "orderReference", "kind": "optional", "type": "string", "description": "A unique reference for the order, used to track and manage the purchase order." } ] }, { "name": "Parameter name", "kind": "optional", "type": "string", "description": "" } ] }, { "name": "earliestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the earliest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the earliestAppointmentTime is sent, then the latestAppointmentTime must also be sent." }, { "name": "earliestWantTime", "kind": "optional", "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)" }, { "name": "externalAddressId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. UNLOCODE is preferred for port stop creation in the FK platform." }, { "name": "latestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the latest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestAppointmentTime is sent, then the earliestAppointmentTime must also be sent. latestAppointmentTime should be greater than or equal to earliestAppointmentTime." }, { "name": "latestWantTime", "kind": "optional", "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. ISO 8601 format. If the latestWantTime is sent, then the earliestWantTime must also be sent. (CM)" }, { "name": "name", "kind": "required", "type": "string", "description": "It is the name of the stop." }, { "name": "loadingType", "kind": "optional", "type": "string", "description": "Indicates whether the load or shipment is Live or Drop. Valid values : \"live\" or \"drop\"" }, { "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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the pallet record." }, { "name": "number", "kind": "optional", "type": "string", "description": "It indicates the pallet number." }, { "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’s part number." }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "It indicates the part's order 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": "It indicates the description given for the material within the pallet." } ] } ] }, { "name": "postalCode", "kind": "optional", "type": "string", "description": "It indicates the valid postal code for the stop." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of stop level reference numbers associated with the stop. These are searchable within the FourKites platform. (CM)" }, { "name": "sequence", "kind": "optional", "type": "string", "description": "It indicates the stop's sequence on a load. The lower value indicates earliest scheduled stop completion. If the stop sequence is present for one stop on a load, it must be present on all stops. It is recommended to start at 1 and increment by 1 for each additional stop. (CM)" }, { "name": "shipTo", "kind": "optional", "type": "string", "description": "It is the ship to location ID associated with the stop. The shipTo values associated with pickup stops can be filtered using the \"Ship From\" filter. (CM)" }, { "name": "state", "kind": "required", "type": "string", "description": "It indicates the 2 character state code for US & Canada and 3 Character state code for Mexico. It is the 2 character State Code for US & Canada and 3 Character State Code for Mexico." }, { "name": "stopReferenceId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the stop from the customer's system. This populates the \"Reference #\" field on the stop and is used to indicate which stop an update is applied to. (CM)" }, { "name": "stopType", "kind": "required", "type": "string", "description": "It defines the function of the stop. Valid values: \"pickup\", \"delivery\", \"transfer\", \"portOfLoading\", \"transshipmentPort\", \"portOfDischarge\". There should be at least one pickup and delivery stop or one transfer (terminal) and one delivery." }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. \tFor ocean loads, use the port's UNLOCODE." }, { "name": "unloadTimeInMinutes", "kind": "optional", "type": "string", "description": "It indicates the dwell time to be used for the stop in ETA calculations (in minutes). When it is not provided, the company level default value will be used, if available or 90 minutes. This value must be sent in minutes." }, { "name": "productLineItems", "kind": "optional", "type": "object", "description": "", "children": [ { "name": "productId", "kind": "required", "type": "string", "description": "Unique identifier for the product. Mandatory if productLineItems object is present" }, { "name": "productDescription", "kind": "optional", "type": "string", "description": "Detailed description of the product" }, { "name": "productCategory", "kind": "optional", "type": "string", "description": "Category classification of the product" }, { "name": "quantity", "kind": "optional", "type": "integer", "description": "Number of units in the shipment" }, { "name": "measurementUnitCode", "kind": "optional", "type": "string", "description": "Unit of measurement for quantity (e.g., PCE, KG, LB)" }, { "name": "netWeight", "kind": "optional", "type": "string", "description": "Weight of the product excluding packaging" }, { "name": "weightUnit", "kind": "optional", "type": "string", "description": "Unit of measurement for weight (e.g., KGM, LBM)" }, { "name": "unitCost", "kind": "optional", "type": "number", "description": "Cost per unit of the product" }, { "name": "currencyCode", "kind": "optional", "type": "string", "description": "Currency code for cost fields" }, { "name": "extendedCost", "kind": "optional", "type": "number", "description": "Total cost for all units (unitCost × quantity)" }, { "name": "freightCost", "kind": "optional", "type": "number", "description": "Freight cost allocated to this line item" }, { "name": "bestBeforeDate", "kind": "optional", "type": "string", "description": "Expiration or best before date for the product" }, { "name": "additionalCharges", "kind": "optional", "type": "number", "description": "Any additional charges specific to this line item" }, { "name": "tariffCost", "kind": "optional", "type": "number", "description": "Tariff cost for this specific line item" }, { "name": "fourKitesCalculatedTariffCost", "kind": "optional", "type": "number", "description": "System-calculated tariff cost" }, { "name": "totalLandedCost", "kind": "optional", "type": "number", "description": "Total landed cost for this line item" }, { "name": "countryOfOrigin", "kind": "optional", "type": "string", "description": "Country of origin for this product" }, { "name": "harmonizedSystemCode", "kind": "optional", "type": "string", "description": "International trade classification code" }, { "name": "commodityTypeCode", "kind": "optional", "type": "string", "description": "Commodity classification code" }, { "name": "htsusCode", "kind": "optional", "type": "string", "description": "Harmonized Tariff Schedule code for US imports" }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "Purchase order number" }, { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Delivery reference number" }, { "name": "handlingUnitId", "kind": "optional", "type": "string", "description": "Identifier for the handling unit (pallet, box, etc.)" }, { "name": "barcode", "kind": "optional", "type": "string", "description": "Product barcode" }, { "name": "containerType", "kind": "optional", "type": "string", "description": "Type of container (pallet, box, carton, etc.)" }, { "name": "gtin", "kind": "optional", "type": "string", "description": "Global Trade Item Number" }, { "name": "customerPartNumber", "kind": "optional", "type": "string", "description": "Customer's part number for the product" }, { "name": "supplierPartNumber", "kind": "optional", "type": "string", "description": "Supplier's part number for the product" }, { "name": "manufacturerPartNumber", "kind": "optional", "type": "string", "description": "Manufacturer's part number" }, { "name": "itemNumber", "kind": "optional", "type": "string", "description": "Internal item number" }, { "name": "productUpc", "kind": "optional", "type": "string", "description": "Universal Product Code" }, { "name": "deliveryReferences", "kind": "optional", "type": "string", "description": "Array of delivery reference numbers" }, { "name": "orderReferences", "kind": "optional", "type": "string", "description": "Array of order reference numbers" }, { "name": "brandName", "kind": "optional", "type": "string", "description": "Brand name of the product" }, { "name": "minimumTemperature", "kind": "optional", "type": "integer", "description": "Minimum storage/transport temperature" }, { "name": "maximumTemperature", "kind": "optional", "type": "integer", "description": "Maximum storage/transport temperature" }, { "name": "temperatureUnitCode", "kind": "optional", "type": "string", "description": "Temperature unit (cel, fah)" }, { "name": "labelIdentifier", "kind": "optional", "type": "string", "description": "Label identifier for tracking" }, { "name": "productTrackingNumber", "kind": "optional", "type": "string", "description": "Unique tracking number for the product" }, { "name": "deviceType", "kind": "optional", "type": "string", "description": "Type of tracking device (RFID_TAG, QR_CODE, etc.)" } ] } ] }, { "name": "tags", "kind": "optional", "type": "array", "description": "It is the list of tags or labels to be assigned to a load. Loads can be filtered in FourKites using tags. It is used for assigning categories for the load. A single tag can't exceed 50 characters. Even though we don’t have restrictions on the number of tags, it is advisable to keep total characters of all tags within the count of 255. (CM)" }, { "name": "trackingInfo", "kind": "optional", "type": "object", "description": "It indicates the information required for tracking the load.", "children": [ { "name": "deviceId", "kind": "optional", "type": "string", "description": "It indicates the ID of the GPS puck attached to the pallet or the trailer." }, { "name": "driverId", "kind": "optional", "type": "string", "description": "It indicates the driver ID used for CarrierLink access for private fleet owners. The driver ID is used by drivers of private fleet owners to log into CarrierLink and see the loads assigned to them. There should be an existing driver user in the platform with the same driver ID." }, { "name": "driverPhone", "kind": "optional", "type": "string", "description": "It indicates a valid mobile number. Example: +13125555555. \tThe ISD code followed by mobile number prepended with \"+\" and no special characters." }, { "name": "mawb", "kind": "optional", "type": "string", "description": "The carrier’s air waybill issued to cover a consolidated shipment tendered by a forwarder or consolidator." }, { "name": "trailerNumber", "kind": "optional", "type": "string", "description": "It indicates the trailer number assigned to the load." }, { "name": "truckNumber", "kind": "optional", "type": "string", "description": "It indicates the tractor or asset number dispatched by the carrier for the load." } ] }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is for parcel tracking only; any tracking number provided by the carrier or other entities." }, { "name": "truckRoutingParams", "kind": "optional", "type": "object", "description": "It indicates the information required for getting truck specific routing. If provided, the routing of the truck and ETA calculations will be done based on these parameters.", "children": [ { "name": "height", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s height in meters. Valid values: Between 0 and 50." }, { "name": "length", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s length in meters. Valid values: Between 0 and 300." }, { "name": "limitedWeight", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight including trailers and shipped goods in tons. Valid values: Between 0 and 1000." }, { "name": "shippedHazardousGoods", "kind": "optional", "type": "string", "description": "It indicates the list of hazaradous materials in the vehicle. Enum [explosive , gas , flammable , organic , combustible , poison , radioActive , corrosive , poisonousInhalation , harmfulToWater , other]. Valid values: \"explosive\", \"gas\", \"flammable\", \"organic\", \"combustible\", \"poison\", \"radioActive\", \"corrosive\", \"poisonousInhalation\", \"harmfulToWater\", \"other\".\n\nThe shippedHazardousGoods parameter is used in the HERE Maps API to retrieve route and distance details. This parameter is critical because certain routes prohibit the transportation of hazardous goods. By incorporating this parameter, we can ensure the selection of compliant routes, which enables accurate ETAs, precise distance calculations, and appropriate route information." }, { "name": "trailersCount", "kind": "optional", "type": "string", "description": "It specifies the number of trailers pulled by a vehicle. Valid values: 0, 1, 2, 3,4. Defaults to 0." }, { "name": "truckType", "kind": "optional", "type": "string", "description": "It specifies the vehicle type. It defaults to truck. Enum [truck , tractorTruck]. \tValid values: \"truck\" or \"tractorTruck\"." }, { "name": "tunnelCategory", "kind": "optional", "type": "string", "description": "It specifies the tunnel category to restrict certain routes. The route will pass only through tunnels of a less strict category. Enum [B , C , D , E]. \tValid values: \"B\", \"C\", \"D\", \"E\"" }, { "name": "weightPerAxle", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight per axle in tons. Valid values: Between 0 and 1000." }, { "name": "width", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s width in meters. Valid values: Between 0 and 50." } ] }, { "name": "seal", "kind": "optional", "type": "string", "description": "It is the seal number that identifies the seal on the load." }, { "name": "sealStatus", "kind": "optional", "type": "string", "description": "It is the seal status that represents the status of the seal on the load." }, { "name": "simultaneousTrackingSequenceNumber", "kind": "optional", "type": "number", "description": "This parameter will allow Shippers and Carriers to provide the sequence number to order the delivery sequence to calculate better ETAs. \n\nThe earlier logic would consider either the shortest distance or the Appointment time to sequence the stops for ETA calculation.\n\nThe new logic will look like this:\n- If the Simultaneous tracking Sequence number is provided, this will be given the first priority.\n- If not, then use the existing logic." }, { "name": "deliveryNumbers", "kind": "optional", "type": "string", "description": "Array of strings supporting multiple delivery references per shipment (typically comma separated). Same as delivery numbers on deliveries in an order." }, { "name": "masterTrackingNumber", "kind": "optional", "type": "string", "description": "Single string field for shipment relationship tracking. This is primarily to indicate the master tracking number for split parcels." } ] } ], "formDataParameters": [] }, "results": { "languages": [ { "id": "vJmaUlHjeNh6wzQ_MfCsY", "code": "{\n \"loadId\": 1000,\n \"message\": \"Load created successfully\",\n \"statusCode\": 200\n}", "language": "200", "customLabel": "" } ], "selectedLanguageId": "vJmaUlHjeNh6wzQ_MfCsY" }, "examples": { "languages": [ { "id": "sa6A_WxCAcH7ovUgPbe2U", "language": "curl", "code": "curl --location 'https://api.fourkites.com/api/v1/tracking' \\\n--header 'Content-Type: application/json' \\\n--header 'apikey: REPLACE_KEY_VALUE' \\\n--data-raw '{\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410.00,\n \"extendedCost\": 1200.00,\n \"freightCost\": 45.50,\n \"additionalCost\": 23.20,\n \"tariffCost\": 85.00,\n \"landedCost\": 1353.70,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": null\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"additionalCharges\": 50.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450.00,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250.00,\n \"freightCost\": 75.00,\n \"totalLandedCost\": 11325.00,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n}'", "customLabel": "" }, { "id": "VRLMi8z6qihm0hVjDQgma", "language": "java", "code": "OkHttpClient client = new OkHttpClient().newBuilder()\n .build();\nMediaType mediaType = MediaType.parse(\"application/json\");\nRequestBody body = RequestBody.create(mediaType, \"{\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"TL\\\",\\n \\\"carrierModes\\\": \\\"\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrierPermalink\\\": \\\"insights-carrier-6870\\\",\\n \\\"carrierName\\\": \\\"Insights Carrier\\\",\\n \\\"carrier\\\": \\\"IC68\\\",\\n \\\"shipperAccountNumber\\\": \\\"tXXXXX234\\\",\\n \\\"haulType\\\": [\\n \\\"inbound_load\\\"\\n ],\\n \\\"loadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"displayLoadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"billOfLading\\\": \\\"billOfLading\\\",\\n \\\"bookingNumber\\\": \\\"bookingNumber\\\",\\n \\\"priority\\\": \\\"high\\\",\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"proNumber\\\": \\\"991\\\",\\n \\\"cost\\\": {\\n \\\"productCost\\\": 410.00,\\n \\\"extendedCost\\\": 1200.00,\\n \\\"freightCost\\\": 45.50,\\n \\\"additionalCost\\\": 23.20,\\n \\\"tariffCost\\\": 85.00,\\n \\\"landedCost\\\": 1353.70,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fourkitesCalculatedTariffCost\\\": null\\n },\\n \\\"products\\\": [\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n },\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Electronic Control Module\\\",\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n }\\n ],\\n \\\"referenceNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"DN-789012\\\",\\n \\\"PO-2025-5678\\\",\\n \\\"DN-345678\\\"\\n ],\\n \\\"deliveryNumbers\\\": \\\"DN-789012, DN-345678\\\",\\n \\\"masterTrackingNumber\\\": \\\"MASTER01\\\",\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"stopId\\\": \\\"1529659839\\\",\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Floor 33\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-001\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"earliestWantTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"externalAddressId\\\": \\\"100\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"latestWantTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"loadingType\\\": \\\"drop\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"bestBeforeDate\\\": \\\"2025-07-15T08:10:00Z\\\",\\n \\\"additionalCharges\\\": 500.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 1951.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"shipTo\\\": \\\"1234\\\",\\n \\\"state\\\": \\\"IL\\\",\\n \\\"stopReferenceId\\\": \\\"1529659839\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"trackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"unloadTimeInMinutes\\\": 120\\n },\\n {\\n \\\"stopId\\\": \\\"1529659852\\\",\\n \\\"addressLine1\\\": \\\"1001 E 17th Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Bloomington\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"PO-2025-5678\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-002\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-20T05:00:00\\\",\\n \\\"externalAddressId\\\": \\\"200\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-20T06:00:00\\\",\\n \\\"name\\\": \\\"Assembly Hall\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"PROD-1234512\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"additionalCharges\\\": 50.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 195.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n },\\n {\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"productName\\\": \\\"Electronic Control Module\\\",\\n \\\"productDescription\\\": \\\"Advanced electronic control unit for automotive applications\\\",\\n \\\"productCategory\\\": \\\"Electronics\\\",\\n \\\"quantity\\\": 25,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 12.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 450.00,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 11250.00,\\n \\\"freightCost\\\": 75.00,\\n \\\"totalLandedCost\\\": 11325.00,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8537109900\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-5678\\\",\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"handlingUnitId\\\": \\\"BOX-002345\\\",\\n \\\"barcode\\\": \\\"234567890123\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"09876543210987\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-ECM-002\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-ECM-890\\\",\\n \\\"brandName\\\": \\\"TechControl\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-ECM-002345\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"47408\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\",\\n \\\"TRK-890123456\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"IN\\\",\\n \\\"stopReferenceId\\\": \\\"1529659852\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"trackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"unloadTimeInMinutes\\\": 150,\\n \\\"wantTime\\\": \\\"2026-07-21T13:00:00Z\\\"\\n }\\n ],\\n \\\"tags\\\": [\\n \\\"Tag1\\\",\\n \\\"Tag2\\\",\\n \\\"Tag3\\\"\\n ],\\n \\\"trackingInfo\\\": {\\n \\\"deviceId\\\": \\\"12356\\\",\\n \\\"driverId\\\": \\\"999\\\",\\n \\\"driverPhone\\\": \\\"+19999999999\\\",\\n \\\"mawb\\\": \\\"17233144555\\\",\\n \\\"trailerNumber\\\": \\\"123\\\",\\n \\\"truckNumber\\\": \\\"456\\\"\\n },\\n \\\"trackingNumber\\\": \\\"123456789\\\",\\n \\\"truckRoutingParams\\\": {\\n \\\"height\\\": \\\"4.145\\\",\\n \\\"length\\\": \\\"14.63\\\",\\n \\\"limitedWeight\\\": \\\"996\\\",\\n \\\"shippedHazardousGoods\\\": \\\"flammable\\\",\\n \\\"trailersCount\\\": 0,\\n \\\"truckType\\\": \\\"truck\\\",\\n \\\"tunnelCategory\\\": \\\"C\\\",\\n \\\"weightPerAxle\\\": \\\"498\\\",\\n \\\"width\\\": \\\"2.438\\\"\\n },\\n \\\"seal\\\": \\\"XYZ123\\\",\\n \\\"sealStatus\\\": \\\"XYZ123\\\"\\n }\\n}\");\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": "y0P2cjJPDcugW4iYQlOsy", "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 \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410,\n \"extendedCost\": 1200,\n \"freightCost\": 45.5,\n \"additionalCost\": 23.2,\n \"tariffCost\": 85,\n \"landedCost\": 1353.7,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": null\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"additionalCharges\": 50,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250,\n \"freightCost\": 75,\n \"totalLandedCost\": 11325,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n }),\n};\n\n$.ajax(settings).done(function (response) {\n console.log(response);\n});", "customLabel": "" }, { "id": "cKuiD8kkjyiesLasUeiQ2", "language": "swift", "code": "let parameters = \"{\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"TL\\\",\\n \\\"carrierModes\\\": \\\"\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrierPermalink\\\": \\\"insights-carrier-6870\\\",\\n \\\"carrierName\\\": \\\"Insights Carrier\\\",\\n \\\"carrier\\\": \\\"IC68\\\",\\n \\\"shipperAccountNumber\\\": \\\"tXXXXX234\\\",\\n \\\"haulType\\\": [\\n \\\"inbound_load\\\"\\n ],\\n \\\"loadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"displayLoadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"billOfLading\\\": \\\"billOfLading\\\",\\n \\\"bookingNumber\\\": \\\"bookingNumber\\\",\\n \\\"priority\\\": \\\"high\\\",\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"proNumber\\\": \\\"991\\\",\\n \\\"cost\\\": {\\n \\\"productCost\\\": 410.00,\\n \\\"extendedCost\\\": 1200.00,\\n \\\"freightCost\\\": 45.50,\\n \\\"additionalCost\\\": 23.20,\\n \\\"tariffCost\\\": 85.00,\\n \\\"landedCost\\\": 1353.70,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fourkitesCalculatedTariffCost\\\": null\\n },\\n \\\"products\\\": [\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n },\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Electronic Control Module\\\",\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n }\\n ],\\n \\\"referenceNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"DN-789012\\\",\\n \\\"PO-2025-5678\\\",\\n \\\"DN-345678\\\"\\n ],\\n \\\"deliveryNumbers\\\": \\\"DN-789012, DN-345678\\\",\\n \\\"masterTrackingNumber\\\": \\\"MASTER01\\\",\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"stopId\\\": \\\"1529659839\\\",\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Floor 33\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-001\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"earliestWantTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"externalAddressId\\\": \\\"100\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"latestWantTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"loadingType\\\": \\\"drop\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"bestBeforeDate\\\": \\\"2025-07-15T08:10:00Z\\\",\\n \\\"additionalCharges\\\": 500.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 1951.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"shipTo\\\": \\\"1234\\\",\\n \\\"state\\\": \\\"IL\\\",\\n \\\"stopReferenceId\\\": \\\"1529659839\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"trackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"unloadTimeInMinutes\\\": 120\\n },\\n {\\n \\\"stopId\\\": \\\"1529659852\\\",\\n \\\"addressLine1\\\": \\\"1001 E 17th Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Bloomington\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"PO-2025-5678\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-002\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-20T05:00:00\\\",\\n \\\"externalAddressId\\\": \\\"200\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-20T06:00:00\\\",\\n \\\"name\\\": \\\"Assembly Hall\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"PROD-1234512\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"additionalCharges\\\": 50.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 195.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n },\\n {\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"productName\\\": \\\"Electronic Control Module\\\",\\n \\\"productDescription\\\": \\\"Advanced electronic control unit for automotive applications\\\",\\n \\\"productCategory\\\": \\\"Electronics\\\",\\n \\\"quantity\\\": 25,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 12.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 450.00,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 11250.00,\\n \\\"freightCost\\\": 75.00,\\n \\\"totalLandedCost\\\": 11325.00,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8537109900\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-5678\\\",\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"handlingUnitId\\\": \\\"BOX-002345\\\",\\n \\\"barcode\\\": \\\"234567890123\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"09876543210987\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-ECM-002\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-ECM-890\\\",\\n \\\"brandName\\\": \\\"TechControl\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-ECM-002345\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"47408\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\",\\n \\\"TRK-890123456\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"IN\\\",\\n \\\"stopReferenceId\\\": \\\"1529659852\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"trackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"unloadTimeInMinutes\\\": 150,\\n \\\"wantTime\\\": \\\"2026-07-21T13:00:00Z\\\"\\n }\\n ],\\n \\\"tags\\\": [\\n \\\"Tag1\\\",\\n \\\"Tag2\\\",\\n \\\"Tag3\\\"\\n ],\\n \\\"trackingInfo\\\": {\\n \\\"deviceId\\\": \\\"12356\\\",\\n \\\"driverId\\\": \\\"999\\\",\\n \\\"driverPhone\\\": \\\"+19999999999\\\",\\n \\\"mawb\\\": \\\"17233144555\\\",\\n \\\"trailerNumber\\\": \\\"123\\\",\\n \\\"truckNumber\\\": \\\"456\\\"\\n },\\n \\\"trackingNumber\\\": \\\"123456789\\\",\\n \\\"truckRoutingParams\\\": {\\n \\\"height\\\": \\\"4.145\\\",\\n \\\"length\\\": \\\"14.63\\\",\\n \\\"limitedWeight\\\": \\\"996\\\",\\n \\\"shippedHazardousGoods\\\": \\\"flammable\\\",\\n \\\"trailersCount\\\": 0,\\n \\\"truckType\\\": \\\"truck\\\",\\n \\\"tunnelCategory\\\": \\\"C\\\",\\n \\\"weightPerAxle\\\": \\\"498\\\",\\n \\\"width\\\": \\\"2.438\\\"\\n },\\n \\\"seal\\\": \\\"XYZ123\\\",\\n \\\"sealStatus\\\": \\\"XYZ123\\\"\\n }\\n}\"\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 return\n }\n print(String(data: data, encoding: .utf8)!)\n}\n\ntask.resume()\n", "customLabel": "" }, { "id": "5dJrjshFeSBU8y2rBAs-E", "language": "csharp", "code": "var client = new HttpClient();\nvar request = new HttpRequestMessage(HttpMethod.Post, \"https://api.fourkites.com/api/v1/tracking\");\nrequest.Headers.Add(\"apikey\", \"REPLACE_KEY_VALUE\");\nvar content = new StringContent(\"{\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"TL\\\",\\n \\\"carrierModes\\\": \\\"\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrierPermalink\\\": \\\"insights-carrier-6870\\\",\\n \\\"carrierName\\\": \\\"Insights Carrier\\\",\\n \\\"carrier\\\": \\\"IC68\\\",\\n \\\"shipperAccountNumber\\\": \\\"tXXXXX234\\\",\\n \\\"haulType\\\": [\\n \\\"inbound_load\\\"\\n ],\\n \\\"loadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"displayLoadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"billOfLading\\\": \\\"billOfLading\\\",\\n \\\"bookingNumber\\\": \\\"bookingNumber\\\",\\n \\\"priority\\\": \\\"high\\\",\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"proNumber\\\": \\\"991\\\",\\n \\\"cost\\\": {\\n \\\"productCost\\\": 410.00,\\n \\\"extendedCost\\\": 1200.00,\\n \\\"freightCost\\\": 45.50,\\n \\\"additionalCost\\\": 23.20,\\n \\\"tariffCost\\\": 85.00,\\n \\\"landedCost\\\": 1353.70,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fourkitesCalculatedTariffCost\\\": null\\n },\\n \\\"products\\\": [\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n },\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Electronic Control Module\\\",\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n }\\n ],\\n \\\"referenceNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"DN-789012\\\",\\n \\\"PO-2025-5678\\\",\\n \\\"DN-345678\\\"\\n ],\\n \\\"deliveryNumbers\\\": \\\"DN-789012, DN-345678\\\",\\n \\\"masterTrackingNumber\\\": \\\"MASTER01\\\",\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"stopId\\\": \\\"1529659839\\\",\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Floor 33\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-001\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"earliestWantTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"externalAddressId\\\": \\\"100\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"latestWantTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"loadingType\\\": \\\"drop\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"bestBeforeDate\\\": \\\"2025-07-15T08:10:00Z\\\",\\n \\\"additionalCharges\\\": 500.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 1951.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"shipTo\\\": \\\"1234\\\",\\n \\\"state\\\": \\\"IL\\\",\\n \\\"stopReferenceId\\\": \\\"1529659839\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"trackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"unloadTimeInMinutes\\\": 120\\n },\\n {\\n \\\"stopId\\\": \\\"1529659852\\\",\\n \\\"addressLine1\\\": \\\"1001 E 17th Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Bloomington\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"PO-2025-5678\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-002\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-20T05:00:00\\\",\\n \\\"externalAddressId\\\": \\\"200\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-20T06:00:00\\\",\\n \\\"name\\\": \\\"Assembly Hall\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"PROD-1234512\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"additionalCharges\\\": 50.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 195.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n },\\n {\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"productName\\\": \\\"Electronic Control Module\\\",\\n \\\"productDescription\\\": \\\"Advanced electronic control unit for automotive applications\\\",\\n \\\"productCategory\\\": \\\"Electronics\\\",\\n \\\"quantity\\\": 25,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 12.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 450.00,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 11250.00,\\n \\\"freightCost\\\": 75.00,\\n \\\"totalLandedCost\\\": 11325.00,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8537109900\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-5678\\\",\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"handlingUnitId\\\": \\\"BOX-002345\\\",\\n \\\"barcode\\\": \\\"234567890123\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"09876543210987\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-ECM-002\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-ECM-890\\\",\\n \\\"brandName\\\": \\\"TechControl\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-ECM-002345\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"47408\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\",\\n \\\"TRK-890123456\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"IN\\\",\\n \\\"stopReferenceId\\\": \\\"1529659852\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"trackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"unloadTimeInMinutes\\\": 150,\\n \\\"wantTime\\\": \\\"2026-07-21T13:00:00Z\\\"\\n }\\n ],\\n \\\"tags\\\": [\\n \\\"Tag1\\\",\\n \\\"Tag2\\\",\\n \\\"Tag3\\\"\\n ],\\n \\\"trackingInfo\\\": {\\n \\\"deviceId\\\": \\\"12356\\\",\\n \\\"driverId\\\": \\\"999\\\",\\n \\\"driverPhone\\\": \\\"+19999999999\\\",\\n \\\"mawb\\\": \\\"17233144555\\\",\\n \\\"trailerNumber\\\": \\\"123\\\",\\n \\\"truckNumber\\\": \\\"456\\\"\\n },\\n \\\"trackingNumber\\\": \\\"123456789\\\",\\n \\\"truckRoutingParams\\\": {\\n \\\"height\\\": \\\"4.145\\\",\\n \\\"length\\\": \\\"14.63\\\",\\n \\\"limitedWeight\\\": \\\"996\\\",\\n \\\"shippedHazardousGoods\\\": \\\"flammable\\\",\\n \\\"trailersCount\\\": 0,\\n \\\"truckType\\\": \\\"truck\\\",\\n \\\"tunnelCategory\\\": \\\"C\\\",\\n \\\"weightPerAxle\\\": \\\"498\\\",\\n \\\"width\\\": \\\"2.438\\\"\\n },\\n \\\"seal\\\": \\\"XYZ123\\\",\\n \\\"sealStatus\\\": \\\"XYZ123\\\"\\n }\\n}\", null, \"application/json\");\nrequest.Content = content;\nvar response = await client.SendAsync(request);\nresponse.EnsureSuccessStatusCode();\nConsole.WriteLine(await response.Content.ReadAsStringAsync());\n", "customLabel": "" }, { "id": "fh2kyGCeGBoH8iok802FY", "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 \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410.00,\n \"extendedCost\": 1200.00,\n \"freightCost\": 45.50,\n \"additionalCost\": 23.20,\n \"tariffCost\": 85.00,\n \"landedCost\": 1353.70,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": null\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"additionalCharges\": 50.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450.00,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250.00,\n \"freightCost\": 75.00,\n \"totalLandedCost\": 11325.00,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n}`)\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": "g62VzmM0ca7QqYHmE8JPV", "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 \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410,\n \"extendedCost\": 1200,\n \"freightCost\": 45.5,\n \"additionalCost\": 23.2,\n \"tariffCost\": 85,\n \"landedCost\": 1353.7,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": nil\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"additionalCharges\": 50,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250,\n \"freightCost\": 75,\n \"totalLandedCost\": 11325,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n})\n\nresponse = https.request(request)\nputs response.read_body\n", "customLabel": "" }, { "id": "2QDWbLPC4OWpgov8hWxjZ", "language": "python", "code": "import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.fourkites.com\")\npayload = json.dumps({\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410,\n \"extendedCost\": 1200,\n \"freightCost\": 45.5,\n \"additionalCost\": 23.2,\n \"tariffCost\": 85,\n \"landedCost\": 1353.7,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": None\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": False,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": False,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": False,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"additionalCharges\": 50,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250,\n \"freightCost\": 75,\n \"totalLandedCost\": 11325,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n})\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": "sa6A_WxCAcH7ovUgPbe2U" }, "description": "\n", "currentNewParameter": { "label": "Body Parameter", "value": "bodyDataParameters" }, "hasTryItOut": false, "autoGeneratedAnchorSlug": "production", "legacyHash": "U6MdPNotZ97puTlB6Z-S9" } ``` ::: :::ApiMethodV2 ```json { "tab": "examples", "url": "https://api-staging.fourkites.com/api/v1/tracking", "name": "Staging", "method": "POST", "request": { "pathParameters": [], "queryParameters": [], "headerParameters": [], "bodyDataParameters": [ { "name": "modeDetails", "kind": "optional", "type": "object", "description": "It contains the mode information about the load that we create.", "children": [ { "name": "shipperModes", "kind": "optional", "type": "string", "description": "It defines the mode of the load. Valid values: \"TL\", \"LTL\", \"RAIL\", \"OCEAN\", \"PARCEL\", \"AIR\"" }, { "name": "carrierModes", "kind": "optional", "type": "string", "description": "It defines the mode of the load. Valid values: \"TL\", \"LTL\", \"RAIL\", \"OCEAN\", \"PARCEL\", \"AIR" } ] }, { "name": "load", "kind": "required", "type": "object", "description": "It is the parent object for the load. Place the load attributes inside this object.", "children": [ { "name": "carrierPermalink", "kind": "optional", "type": "string", "description": "It is the unique identifier for the carrier in the FK platform." }, { "name": "carrierName", "kind": "optional", "type": "string", "description": "It is the name of the carrier in the FK platform." }, { "name": "carrier", "kind": "required", "type": "string", "description": "It is the 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": "shipperAccountNumber", "kind": "optional", "type": "string", "description": "The shipper's carrier account number, used to identify the shipper account associated with a shipment. Enables carrier integrations to retrieve account-gated data such as proof of delivery documents and signature images. " }, { "name": "haulType", "kind": "required", "type": "array", "description": "It indicates whether the load is an inbound or an outbound load. Valid values: \"inbound_load\", \"outbound_load\", \"short_haul\", \"round_trip\", \"brokered_load\", \"non-brokered_load\", \"inbound_load\", \"outbound_load\", travel_ban_warnings\"" }, { "name": "loadNumber", "kind": "required", "type": "string", "description": "It is the 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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the Ocean load." }, { "name": "bookingNumber", "kind": "optional", "type": "string", "description": "It indicates the shipping line's booking number" }, { "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": "masterSequenceNumber", "kind": "optional", "type": "string", "description": "It is the unique sequence number that represents the leg of the trip used for Consignment Pooling." }, { "name": "masterReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of consignment loads in order to group them. For example, consignmentReferenceNumber: “XAF-BATCH-1”. (Conditional Mandatory)" }, { "name": "simulaneousTrackingReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of simultaneous loads in order to group them. For example, simultaneousTrackingReferenceNumber: “E900018290”" }, { "name": "proNumber", "kind": "optional", "type": "string", "description": "This is a number that is created usually after pickup or at pickup for LTL loads. CM for LTL loads" }, { "name": "products", "kind": "optional", "type": "object", "description": "It indicates the list of temperature tracked products on a load and their temperature tracking information.", "children": [ { "name": "lowerTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the lower bound (in degrees Fahrenheit) of the acceptable temperature range for a product." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of a temperature tracked product." }, { "name": "productId", "kind": "optional", "type": "string", "description": "It indicates the FourKites - internal unique identifier for a temperature tracked product. This is a primary key and duplicates are not allowed. The value must already exist in FourKites®." }, { "name": "setTemperature", "kind": "optional", "type": "string", "description": "It indicates the target temperature at which the product is maintained." }, { "name": "timeToleranceInMinutes", "kind": "optional", "type": "string", "description": "It indicates the acceptable time (in minutes) for a product to maintain a temperature outside the defined temperature range. Exceeding this range for a period of time equal to or greater than this time tolerance will display a critical alert in the Temperature Tracking section of a load." }, { "name": "upperTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the upper bound (in degrees Fahrenheit) of the acceptable temperature range for a product." } ] }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It is the list of load-level reference numbers associated with a load. (CM)" }, { "name": "relayLoad", "kind": "optional", "type": "boolean", "description": "It indicates whether the load is relay or team load. \tValid values: true or false. Defaults to false. (CM)" }, { "name": "stops", "kind": "required", "type": "object", "description": "It is the list of stops for the load.", "children": [ { "name": "addressLine1", "kind": "required", "type": "string", "description": "It indicates the first line of the stop's address." }, { "name": "addressLine2", "kind": "optional", "type": "string", "description": "It indicates the second line of the stop's address." }, { "name": "city", "kind": "required", "type": "string", "description": "It indicates the name of the city. \tWhen we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now we have a restriction to pass state name when the stop doesn't have external AddressId and we match the port with only city & country." }, { "name": "country", "kind": "optional", "type": "string", "description": "It indicates the valid country code. It is the 2 digit country code. When we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now, we have a restriction to pass the state name when the stop doesn't have external AddressId and we want to match the port with only city & country." }, { "name": "customer", "kind": "optional", "type": "object", "description": "It indicates the customer information for the stop. (CM)", "children": [ { "name": "id", "kind": "optional", "type": "string", "description": "It is the unique identifier of the shipper's customer. The customer should have been created in FourKites before associating it to a load's stop. (CM)" }, { "name": "poNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of Customer PO Numbers associated with the load's stop. (CM)" }, { "name": "pointOfContact", "kind": "optional", "type": "object", "description": "It indicates the point of contact (POC) information at the stop, capturing name, email, phone number, and whether they should be alerted. You can send up to 5 POCs objects per stop.", "children": [ { "name": "alert", "kind": "optional", "type": "boolean", "description": "It indicates the flag to enable or disable email notifications to the point of contact." }, { "name": "email", "kind": "optional", "type": "string", "description": "It indicates the email address of the point of contact at the stop." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of the point of contact at the stop." }, { "name": "phone", "kind": "optional", "type": "string", "description": "It indicates the phone number of the point of contact at the stop. The ISD code followed by mobile number prepended with \"+\" and no special characters." } ] }, { "name": "customer", "kind": "optional", "type": "string", "description": "Name of the customer to automatically pull in customer record." }, { "name": "customerPoFields", "kind": "optional", "type": "object", "description": "This is a list (array) of objects containing purchase order-related details from the customer.", "children": [ { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Represents the delivery number or identifier associated with the purchase order." }, { "name": "deliveryReference", "kind": "optional", "type": "string", "description": "A reference code or identifier related to the delivery, possibly provided by the customer or logistics team." }, { "name": "orderReference", "kind": "optional", "type": "string", "description": "A unique reference for the order, used to track and manage the purchase order." } ] } ] }, { "name": "earliestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the earliest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the earliestAppointmentTime is sent, then the latestAppointmentTime must also be sent." }, { "name": "earliestWantTime", "kind": "optional", "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)" }, { "name": "externalAddressId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. UNLOCODE is preferred for port stop creation in the FK platform." }, { "name": "latestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the latest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestAppointmentTime is sent, then the earliestAppointmentTime must also be sent. latestAppointmentTime should be greater than or equal to earliestAppointmentTime." }, { "name": "latestWantTime", "kind": "optional", "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. ISO 8601 format. If the latestWantTime is sent, then the earliestWantTime must also be sent. (CM)" }, { "name": "name", "kind": "required", "type": "string", "description": "It is the name of the stop." }, { "name": "loadingType", "kind": "optional", "type": "string", "description": "Indicates whether the load or shipment is Live or Drop. Valid values : \"live\" or \"drop\"" }, { "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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the pallet record." }, { "name": "number", "kind": "optional", "type": "string", "description": "It indicates the pallet number." }, { "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’s part number." }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "It indicates the part's order 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": "It indicates the description given for the material within the pallet." } ] } ] }, { "name": "postalCode", "kind": "optional", "type": "string", "description": "It indicates the valid postal code for the stop." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of stop level reference numbers associated with the stop. These are searchable within the FourKites platform. (CM)" }, { "name": "sequence", "kind": "optional", "type": "string", "description": "It indicates the stop's sequence on a load. The lower value indicates earliest scheduled stop completion. If the stop sequence is present for one stop on a load, it must be present on all stops. It is recommended to start at 1 and increment by 1 for each additional stop. (CM)" }, { "name": "shipTo", "kind": "optional", "type": "string", "description": "It is the ship to location ID associated with the stop. The shipTo values associated with pickup stops can be filtered using the \"Ship From\" filter. (CM)" }, { "name": "state", "kind": "required", "type": "string", "description": "It indicates the 2 character state code for US & Canada and 3 Character state code for Mexico. It is the 2 character State Code for US & Canada and 3 Character State Code for Mexico." }, { "name": "stopReferenceId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the stop from the customer's system. This populates the \"Reference #\" field on the stop and is used to indicate which stop an update is applied to. (CM)" }, { "name": "stopType", "kind": "required", "type": "string", "description": "It defines the function of the stop. Valid values: \"pickup\", \"delivery\", \"transfer\", \"portOfLoading\", \"transshipmentPort\", \"portOfDischarge\". There should be at least one pickup and delivery stop or one transfer (terminal) and one delivery." }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. \tFor ocean loads, use the port's UNLOCODE." }, { "name": "unloadTimeInMinutes", "kind": "optional", "type": "string", "description": "It indicates the dwell time to be used for the stop in ETA calculations (in minutes). When it is not provided, the company level default value will be used, if available or 90 minutes. This value must be sent in minutes." }, { "name": "productLineItems", "kind": "optional", "type": "object", "description": "", "children": [ { "name": "productId", "kind": "required", "type": "string", "description": "Unique identifier for the product. Mandatory if productLineItems object is present" }, { "name": "productName", "kind": "optional", "type": "string", "description": "Display name of the product" }, { "name": "productDescription", "kind": "optional", "type": "string", "description": "Detailed description of the product" }, { "name": "productCategory", "kind": "optional", "type": "string", "description": "Category classification of the product" }, { "name": "quantity", "kind": "optional", "type": "integer", "description": "Number of units in the shipment" }, { "name": "measurementUnitCode", "kind": "optional", "type": "string", "description": "Unit of measurement for quantity (e.g., PCE, KG, LB)" }, { "name": "netWeight", "kind": "optional", "type": "number", "description": "Weight of the product excluding packaging" }, { "name": "weightUnit", "kind": "optional", "type": "string", "description": "Unit of measurement for weight (e.g., KGM, LBM)" }, { "name": "unitCost", "kind": "optional", "type": "number", "description": "Cost per unit of the product" }, { "name": "currencyCode", "kind": "optional", "type": "number", "description": "Currency code for cost fields" }, { "name": "extendedCost", "kind": "optional", "type": "number", "description": "Total cost for all units (unitCost × quantity)" }, { "name": "freightCost", "kind": "optional", "type": "number", "description": "Freight cost allocated to this line item" }, { "name": "bestBeforeDate", "kind": "optional", "type": "string", "description": "Expiration or best before date for the product" }, { "name": "additionalCharges", "kind": "optional", "type": "number", "description": "Any additional charges specific to this line item" }, { "name": "tariffCost", "kind": "optional", "type": "number", "description": "Tariff cost for this specific line item" }, { "name": "fourKitesCalculatedTariffCost", "kind": "optional", "type": "number", "description": "System-calculated tariff cost" }, { "name": "totalLandedCost", "kind": "optional", "type": "number", "description": "Total landed cost for this line item" }, { "name": "countryOfOrigin", "kind": "optional", "type": "string", "description": "Country of origin for this product" }, { "name": "harmonizedSystemCode", "kind": "optional", "type": "string", "description": "International trade classification code\n" }, { "name": "commodityTypeCode", "kind": "optional", "type": "string", "description": "Commodity classification code" }, { "name": "htsusCode", "kind": "optional", "type": "string", "description": "Harmonized Tariff Schedule code for US imports" }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "Purchase order number" }, { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Delivery reference number" }, { "name": "handlingUnitId", "kind": "optional", "type": "string", "description": "Identifier for the handling unit (pallet, box, etc.)" }, { "name": "barcode", "kind": "optional", "type": "string", "description": "Product barcode" }, { "name": "containerType", "kind": "optional", "type": "string", "description": "Type of container (pallet, box, carton, etc.)" }, { "name": "gtin", "kind": "optional", "type": "string", "description": "Global Trade Item Number" }, { "name": "customerPartNumber", "kind": "optional", "type": "string", "description": "Customer's part number for the product" }, { "name": "supplierPartNumber", "kind": "optional", "type": "string", "description": "Supplier's part number for the product" }, { "name": "manufacturerPartNumber", "kind": "optional", "type": "string", "description": "Manufacturer's part number" }, { "name": "itemNumber", "kind": "optional", "type": "string", "description": "Internal item number" }, { "name": "productUpc", "kind": "optional", "type": "string", "description": "Universal Product Code" }, { "name": "deliveryReferences", "kind": "optional", "type": "string", "description": "Array of delivery reference numbers" }, { "name": "orderReferences", "kind": "optional", "type": "string", "description": "Array of order reference numbers" }, { "name": "brandName", "kind": "optional", "type": "string", "description": "Brand name of the product" }, { "name": "minimumTemperature", "kind": "optional", "type": "integer", "description": "Minimum storage/transport temperature" }, { "name": "maximumTemperature", "kind": "optional", "type": "integer", "description": "Maximum storage/transport temperature" }, { "name": "temperatureUnitCode", "kind": "optional", "type": "string", "description": "Temperature unit (cel, fah)\n" }, { "name": "labelIdentifier", "kind": "optional", "type": "string", "description": "Label identifier for tracking" }, { "name": "productTrackingNumber", "kind": "optional", "type": "string", "description": "Unique tracking number for the product" }, { "name": "deviceType", "kind": "optional", "type": "string", "description": "Type of tracking device (RFID_TAG, QR_CODE, etc.)" } ] } ] }, { "name": "tags", "kind": "optional", "type": "array", "description": "It is the list of tags or labels to be assigned to a load. Loads can be filtered in FourKites using tags. It is used for assigning categories for the load. A single tag can't exceed 50 characters. Even though we don’t have restrictions on the number of tags, it is advisable to keep total characters of all tags within the count of 255. (CM)" }, { "name": "trackingInfo", "kind": "optional", "type": "object", "description": "It indicates the information required for tracking the load.", "children": [ { "name": "deviceId", "kind": "optional", "type": "string", "description": "It indicates the ID of the GPS puck attached to the pallet or the trailer." }, { "name": "driverId", "kind": "optional", "type": "string", "description": "It indicates the driver ID used for CarrierLink access for private fleet owners. The driver ID is used by drivers of private fleet owners to log into CarrierLink and see the loads assigned to them. There should be an existing driver user in the platform with the same driver ID." }, { "name": "driverPhone", "kind": "optional", "type": "string", "description": "It indicates a valid mobile number. Example: +13125555555. \tThe ISD code followed by mobile number prepended with \"+\" and no special characters." }, { "name": "mawb", "kind": "optional", "type": "string", "description": "The carrier’s air waybill issued to cover a consolidated shipment tendered by a forwarder or consolidator." }, { "name": "trailerNumber", "kind": "optional", "type": "string", "description": "It indicates the trailer number assigned to the load." }, { "name": "truckNumber", "kind": "optional", "type": "string", "description": "It indicates the tractor or asset number dispatched by the carrier for the load." } ] }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is for parcel tracking only; any tracking number provided by the carrier or other entities." }, { "name": "truckRoutingParams", "kind": "optional", "type": "object", "description": "It indicates the information required for getting truck specific routing. If provided, the routing of the truck and ETA calculations will be done based on these parameters.", "children": [ { "name": "height", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s height in meters. Valid values: Between 0 and 50." }, { "name": "length", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s length in meters. Valid values: Between 0 and 300." }, { "name": "limitedWeight", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight including trailers and shipped goods in tons. Valid values: Between 0 and 1000." }, { "name": "shippedHazardousGoods", "kind": "optional", "type": "string", "description": "It indicates the list of hazaradous materials in the vehicle. Enum [explosive , gas , flammable , organic , combustible , poison , radioActive , corrosive , poisonousInhalation , harmfulToWater , other]. Valid values: \"explosive\", \"gas\", \"flammable\", \"organic\", \"combustible\", \"poison\", \"radioActive\", \"corrosive\", \"poisonousInhalation\", \"harmfulToWater\", \"other\".\n\n" }, { "name": "trailersCount", "kind": "optional", "type": "string", "description": "It specifies the number of trailers pulled by a vehicle. Valid values: 0, 1, 2, 3,4. Defaults to 0." }, { "name": "truckType", "kind": "optional", "type": "string", "description": "It specifies the vehicle type. It defaults to truck. Enum [truck , tractorTruck]. \tValid values: \"truck\" or \"tractorTruck\"." }, { "name": "tunnelCategory", "kind": "optional", "type": "string", "description": "It specifies the tunnel category to restrict certain routes. The route will pass only through tunnels of a less strict category. Enum [B , C , D , E]. \tValid values: \"B\", \"C\", \"D\", \"E\"" }, { "name": "weightPerAxle", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight per axle in tons. Valid values: Between 0 and 1000." }, { "name": "width", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s width in meters. Valid values: Between 0 and 50." } ] }, { "name": "seal", "kind": "optional", "type": "string", "description": "It is the seal number that identifies the seal on the load." }, { "name": "sealStatus", "kind": "optional", "type": "string", "description": "It is the seal status that represents the status of the seal on the load." }, { "name": "simultaneousTrackingSequenceNumber", "kind": "optional", "type": "number", "description": "This parameter will allow Shippers and Carriers to provide the sequence number to order the delivery sequence to calculate better ETAs. \n\nThe earlier logic would consider either the shortest distance or the Appointment time to sequence the stops for ETA calculation.\n\nThe new logic will look like this:\n- If the Simultaneous tracking Sequence number is provided, this will be given the first priority.\n- If not, then use the existing logic." }, { "name": "deliveryNumbers", "kind": "optional", "type": "string", "description": "Array of strings supporting multiple delivery references per shipment (typically comma separated). Same as delivery numbers on deliveries in an order." }, { "name": "masterTrackingNumber", "kind": "optional", "type": "string", "description": "Single string field for shipment relationship tracking. This is primarily to indicate the master tracking number for split parcels." } ], "schema": [ { "name": "carrierPermalink", "kind": "optional", "type": "string", "description": "It is the unique identifier for the carrier in the FK platform." }, { "name": "carrierName", "kind": "optional", "type": "string", "description": "It is the name of the carrier in the FK platform." }, { "name": "carrier", "kind": "required", "type": "string", "description": "It is the 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": "shipperAccountNumber", "kind": "optional", "type": "string", "description": "The shipper's carrier account number, used to identify the shipper account associated with a shipment. Enables carrier integrations to retrieve account-gated data such as proof of delivery documents and signature images. " }, { "name": "haulType", "kind": "required", "type": "array", "description": "It indicates whether the load is an inbound or an outbound load. Valid values: \"inbound_load\", \"outbound_load\", \"short_haul\", \"round_trip\", \"brokered_load\", \"non-brokered_load\", \"inbound_load\", \"outbound_load\", travel_ban_warnings\"" }, { "name": "loadNumber", "kind": "required", "type": "string", "description": "It is the 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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the Ocean load." }, { "name": "bookingNumber", "kind": "optional", "type": "string", "description": "It indicates the shipping line's booking number" }, { "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": "masterSequenceNumber", "kind": "optional", "type": "string", "description": "It is the unique sequence number that represents the leg of the trip used for Consignment Pooling." }, { "name": "masterReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of consignment loads in order to group them. For example, consignmentReferenceNumber: “XAF-BATCH-1”. (Conditional Mandatory)" }, { "name": "simulaneousTrackingReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of simultaneous loads in order to group them. For example, simultaneousTrackingReferenceNumber: “E900018290”" }, { "name": "proNumber", "kind": "optional", "type": "string", "description": "This is a number that is created usually after pickup or at pickup for LTL loads. CM for LTL loads" }, { "name": "products", "kind": "optional", "type": "object", "description": "It indicates the list of temperature tracked products on a load and their temperature tracking information.", "children": [ { "name": "lowerTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the lower bound (in degrees Fahrenheit) of the acceptable temperature range for a product." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of a temperature tracked product." }, { "name": "productId", "kind": "optional", "type": "string", "description": "It indicates the FourKites - internal unique identifier for a temperature tracked product. This is a primary key and duplicates are not allowed. The value must already exist in FourKites®." }, { "name": "setTemperature", "kind": "optional", "type": "string", "description": "It indicates the target temperature at which the product is maintained." }, { "name": "timeToleranceInMinutes", "kind": "optional", "type": "string", "description": "It indicates the acceptable time (in minutes) for a product to maintain a temperature outside the defined temperature range. Exceeding this range for a period of time equal to or greater than this time tolerance will display a critical alert in the Temperature Tracking section of a load." }, { "name": "upperTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the upper bound (in degrees Fahrenheit) of the acceptable temperature range for a product." } ] }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It is the list of load-level reference numbers associated with a load. (CM)" }, { "name": "relayLoad", "kind": "optional", "type": "boolean", "description": "It indicates whether the load is relay or team load. \tValid values: true or false. Defaults to false. (CM)" }, { "name": "stops", "kind": "required", "type": "object", "description": "It is the list of stops for the load.", "children": [ { "name": "addressLine1", "kind": "required", "type": "string", "description": "It indicates the first line of the stop's address." }, { "name": "addressLine2", "kind": "optional", "type": "string", "description": "It indicates the second line of the stop's address." }, { "name": "city", "kind": "required", "type": "string", "description": "It indicates the name of the city. \tWhen we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now we have a restriction to pass state name when the stop doesn't have external AddressId and we match the port with only city & country." }, { "name": "country", "kind": "optional", "type": "string", "description": "It indicates the valid country code. It is the 2 digit country code. When we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now, we have a restriction to pass the state name when the stop doesn't have external AddressId and we want to match the port with only city & country." }, { "name": "customer", "kind": "optional", "type": "object", "description": "It indicates the customer information for the stop. (CM)", "children": [ { "name": "id", "kind": "optional", "type": "string", "description": "It is the unique identifier of the shipper's customer. The customer should have been created in FourKites before associating it to a load's stop. (CM)" }, { "name": "poNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of Customer PO Numbers associated with the load's stop. (CM)" }, { "name": "pointOfContact", "kind": "optional", "type": "object", "description": "It indicates the point of contact (POC) information at the stop, capturing name, email, phone number, and whether they should be alerted. You can send up to 5 POCs objects per stop.", "children": [ { "name": "alert", "kind": "optional", "type": "boolean", "description": "It indicates the flag to enable or disable email notifications to the point of contact." }, { "name": "email", "kind": "optional", "type": "string", "description": "It indicates the email address of the point of contact at the stop." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of the point of contact at the stop." }, { "name": "phone", "kind": "optional", "type": "string", "description": "It indicates the phone number of the point of contact at the stop. The ISD code followed by mobile number prepended with \"+\" and no special characters." } ] }, { "name": "customer", "kind": "optional", "type": "string", "description": "Name of the customer to automatically pull in customer record." }, { "name": "customerPoFields", "kind": "optional", "type": "object", "description": "This is a list (array) of objects containing purchase order-related details from the customer.", "children": [ { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Represents the delivery number or identifier associated with the purchase order." }, { "name": "deliveryReference", "kind": "optional", "type": "string", "description": "A reference code or identifier related to the delivery, possibly provided by the customer or logistics team." }, { "name": "orderReference", "kind": "optional", "type": "string", "description": "A unique reference for the order, used to track and manage the purchase order." } ] } ] }, { "name": "earliestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the earliest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the earliestAppointmentTime is sent, then the latestAppointmentTime must also be sent." }, { "name": "earliestWantTime", "kind": "optional", "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)" }, { "name": "externalAddressId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. UNLOCODE is preferred for port stop creation in the FK platform." }, { "name": "latestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the latest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestAppointmentTime is sent, then the earliestAppointmentTime must also be sent. latestAppointmentTime should be greater than or equal to earliestAppointmentTime." }, { "name": "latestWantTime", "kind": "optional", "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. ISO 8601 format. If the latestWantTime is sent, then the earliestWantTime must also be sent. (CM)" }, { "name": "name", "kind": "required", "type": "string", "description": "It is the name of the stop." }, { "name": "loadingType", "kind": "optional", "type": "string", "description": "Indicates whether the load or shipment is Live or Drop. Valid values : \"live\" or \"drop\"" }, { "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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the pallet record." }, { "name": "number", "kind": "optional", "type": "string", "description": "It indicates the pallet number." }, { "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’s part number." }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "It indicates the part's order 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": "It indicates the description given for the material within the pallet." } ] } ] }, { "name": "postalCode", "kind": "optional", "type": "string", "description": "It indicates the valid postal code for the stop." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of stop level reference numbers associated with the stop. These are searchable within the FourKites platform. (CM)" }, { "name": "sequence", "kind": "optional", "type": "string", "description": "It indicates the stop's sequence on a load. The lower value indicates earliest scheduled stop completion. If the stop sequence is present for one stop on a load, it must be present on all stops. It is recommended to start at 1 and increment by 1 for each additional stop. (CM)" }, { "name": "shipTo", "kind": "optional", "type": "string", "description": "It is the ship to location ID associated with the stop. The shipTo values associated with pickup stops can be filtered using the \"Ship From\" filter. (CM)" }, { "name": "state", "kind": "required", "type": "string", "description": "It indicates the 2 character state code for US & Canada and 3 Character state code for Mexico. It is the 2 character State Code for US & Canada and 3 Character State Code for Mexico." }, { "name": "stopReferenceId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the stop from the customer's system. This populates the \"Reference #\" field on the stop and is used to indicate which stop an update is applied to. (CM)" }, { "name": "stopType", "kind": "required", "type": "string", "description": "It defines the function of the stop. Valid values: \"pickup\", \"delivery\", \"transfer\", \"portOfLoading\", \"transshipmentPort\", \"portOfDischarge\". There should be at least one pickup and delivery stop or one transfer (terminal) and one delivery." }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. \tFor ocean loads, use the port's UNLOCODE." }, { "name": "unloadTimeInMinutes", "kind": "optional", "type": "string", "description": "It indicates the dwell time to be used for the stop in ETA calculations (in minutes). When it is not provided, the company level default value will be used, if available or 90 minutes. This value must be sent in minutes." }, { "name": "productLineItems", "kind": "optional", "type": "object", "description": "", "children": [ { "name": "productId", "kind": "required", "type": "string", "description": "Unique identifier for the product. Mandatory if productLineItems object is present" }, { "name": "productName", "kind": "optional", "type": "string", "description": "Display name of the product" }, { "name": "productDescription", "kind": "optional", "type": "string", "description": "Detailed description of the product" }, { "name": "productCategory", "kind": "optional", "type": "string", "description": "Category classification of the product" }, { "name": "quantity", "kind": "optional", "type": "integer", "description": "Number of units in the shipment" }, { "name": "measurementUnitCode", "kind": "optional", "type": "string", "description": "Unit of measurement for quantity (e.g., PCE, KG, LB)" }, { "name": "netWeight", "kind": "optional", "type": "number", "description": "Weight of the product excluding packaging" }, { "name": "weightUnit", "kind": "optional", "type": "string", "description": "Unit of measurement for weight (e.g., KGM, LBM)" }, { "name": "unitCost", "kind": "optional", "type": "number", "description": "Cost per unit of the product" }, { "name": "currencyCode", "kind": "optional", "type": "number", "description": "Currency code for cost fields" }, { "name": "extendedCost", "kind": "optional", "type": "number", "description": "Total cost for all units (unitCost × quantity)" }, { "name": "freightCost", "kind": "optional", "type": "number", "description": "Freight cost allocated to this line item" }, { "name": "bestBeforeDate", "kind": "optional", "type": "string", "description": "Expiration or best before date for the product" }, { "name": "additionalCharges", "kind": "optional", "type": "number", "description": "Any additional charges specific to this line item" }, { "name": "tariffCost", "kind": "optional", "type": "number", "description": "Tariff cost for this specific line item" }, { "name": "fourKitesCalculatedTariffCost", "kind": "optional", "type": "number", "description": "System-calculated tariff cost" }, { "name": "totalLandedCost", "kind": "optional", "type": "number", "description": "Total landed cost for this line item" }, { "name": "countryOfOrigin", "kind": "optional", "type": "string", "description": "Country of origin for this product" }, { "name": "harmonizedSystemCode", "kind": "optional", "type": "string", "description": "International trade classification code\n" }, { "name": "commodityTypeCode", "kind": "optional", "type": "string", "description": "Commodity classification code" }, { "name": "htsusCode", "kind": "optional", "type": "string", "description": "Harmonized Tariff Schedule code for US imports" }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "Purchase order number" }, { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Delivery reference number" }, { "name": "handlingUnitId", "kind": "optional", "type": "string", "description": "Identifier for the handling unit (pallet, box, etc.)" }, { "name": "barcode", "kind": "optional", "type": "string", "description": "Product barcode" }, { "name": "containerType", "kind": "optional", "type": "string", "description": "Type of container (pallet, box, carton, etc.)" }, { "name": "gtin", "kind": "optional", "type": "string", "description": "Global Trade Item Number" }, { "name": "customerPartNumber", "kind": "optional", "type": "string", "description": "Customer's part number for the product" }, { "name": "supplierPartNumber", "kind": "optional", "type": "string", "description": "Supplier's part number for the product" }, { "name": "manufacturerPartNumber", "kind": "optional", "type": "string", "description": "Manufacturer's part number" }, { "name": "itemNumber", "kind": "optional", "type": "string", "description": "Internal item number" }, { "name": "productUpc", "kind": "optional", "type": "string", "description": "Universal Product Code" }, { "name": "deliveryReferences", "kind": "optional", "type": "string", "description": "Array of delivery reference numbers" }, { "name": "orderReferences", "kind": "optional", "type": "string", "description": "Array of order reference numbers" }, { "name": "brandName", "kind": "optional", "type": "string", "description": "Brand name of the product" }, { "name": "minimumTemperature", "kind": "optional", "type": "integer", "description": "Minimum storage/transport temperature" }, { "name": "maximumTemperature", "kind": "optional", "type": "integer", "description": "Maximum storage/transport temperature" }, { "name": "temperatureUnitCode", "kind": "optional", "type": "string", "description": "Temperature unit (cel, fah)\n" }, { "name": "labelIdentifier", "kind": "optional", "type": "string", "description": "Label identifier for tracking" }, { "name": "productTrackingNumber", "kind": "optional", "type": "string", "description": "Unique tracking number for the product" }, { "name": "deviceType", "kind": "optional", "type": "string", "description": "Type of tracking device (RFID_TAG, QR_CODE, etc.)" } ] } ] }, { "name": "tags", "kind": "optional", "type": "array", "description": "It is the list of tags or labels to be assigned to a load. Loads can be filtered in FourKites using tags. It is used for assigning categories for the load. A single tag can't exceed 50 characters. Even though we don’t have restrictions on the number of tags, it is advisable to keep total characters of all tags within the count of 255. (CM)" }, { "name": "trackingInfo", "kind": "optional", "type": "object", "description": "It indicates the information required for tracking the load.", "children": [ { "name": "deviceId", "kind": "optional", "type": "string", "description": "It indicates the ID of the GPS puck attached to the pallet or the trailer." }, { "name": "driverId", "kind": "optional", "type": "string", "description": "It indicates the driver ID used for CarrierLink access for private fleet owners. The driver ID is used by drivers of private fleet owners to log into CarrierLink and see the loads assigned to them. There should be an existing driver user in the platform with the same driver ID." }, { "name": "driverPhone", "kind": "optional", "type": "string", "description": "It indicates a valid mobile number. Example: +13125555555. \tThe ISD code followed by mobile number prepended with \"+\" and no special characters." }, { "name": "mawb", "kind": "optional", "type": "string", "description": "The carrier’s air waybill issued to cover a consolidated shipment tendered by a forwarder or consolidator." }, { "name": "trailerNumber", "kind": "optional", "type": "string", "description": "It indicates the trailer number assigned to the load." }, { "name": "truckNumber", "kind": "optional", "type": "string", "description": "It indicates the tractor or asset number dispatched by the carrier for the load." } ] }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is for parcel tracking only; any tracking number provided by the carrier or other entities." }, { "name": "truckRoutingParams", "kind": "optional", "type": "object", "description": "It indicates the information required for getting truck specific routing. If provided, the routing of the truck and ETA calculations will be done based on these parameters.", "children": [ { "name": "height", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s height in meters. Valid values: Between 0 and 50." }, { "name": "length", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s length in meters. Valid values: Between 0 and 300." }, { "name": "limitedWeight", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight including trailers and shipped goods in tons. Valid values: Between 0 and 1000." }, { "name": "shippedHazardousGoods", "kind": "optional", "type": "string", "description": "It indicates the list of hazaradous materials in the vehicle. Enum [explosive , gas , flammable , organic , combustible , poison , radioActive , corrosive , poisonousInhalation , harmfulToWater , other]. Valid values: \"explosive\", \"gas\", \"flammable\", \"organic\", \"combustible\", \"poison\", \"radioActive\", \"corrosive\", \"poisonousInhalation\", \"harmfulToWater\", \"other\".\n\n" }, { "name": "trailersCount", "kind": "optional", "type": "string", "description": "It specifies the number of trailers pulled by a vehicle. Valid values: 0, 1, 2, 3,4. Defaults to 0." }, { "name": "truckType", "kind": "optional", "type": "string", "description": "It specifies the vehicle type. It defaults to truck. Enum [truck , tractorTruck]. \tValid values: \"truck\" or \"tractorTruck\"." }, { "name": "tunnelCategory", "kind": "optional", "type": "string", "description": "It specifies the tunnel category to restrict certain routes. The route will pass only through tunnels of a less strict category. Enum [B , C , D , E]. \tValid values: \"B\", \"C\", \"D\", \"E\"" }, { "name": "weightPerAxle", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight per axle in tons. Valid values: Between 0 and 1000." }, { "name": "width", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s width in meters. Valid values: Between 0 and 50." } ] }, { "name": "seal", "kind": "optional", "type": "string", "description": "It is the seal number that identifies the seal on the load." }, { "name": "sealStatus", "kind": "optional", "type": "string", "description": "It is the seal status that represents the status of the seal on the load." }, { "name": "simultaneousTrackingSequenceNumber", "kind": "optional", "type": "number", "description": "This parameter will allow Shippers and Carriers to provide the sequence number to order the delivery sequence to calculate better ETAs. \n\nThe earlier logic would consider either the shortest distance or the Appointment time to sequence the stops for ETA calculation.\n\nThe new logic will look like this:\n- If the Simultaneous tracking Sequence number is provided, this will be given the first priority.\n- If not, then use the existing logic." }, { "name": "deliveryNumbers", "kind": "optional", "type": "string", "description": "Array of strings supporting multiple delivery references per shipment (typically comma separated). Same as delivery numbers on deliveries in an order." }, { "name": "masterTrackingNumber", "kind": "optional", "type": "string", "description": "Single string field for shipment relationship tracking. This is primarily to indicate the master tracking number for split parcels." } ] } ], "formDataParameters": [] }, "results": { "languages": [ { "id": "vJmaUlHjeNh6wzQ_MfCsY", "code": "{\n \"loadId\": 1000,\n \"message\": \"Load created successfully\",\n \"statusCode\": 200\n}", "language": "200", "customLabel": "" } ], "selectedLanguageId": "vJmaUlHjeNh6wzQ_MfCsY" }, "examples": { "languages": [ { "id": "sa6A_WxCAcH7ovUgPbe2U", "language": "curl", "code": "curl --location 'https://api-staging.fourkites.com/api/v1/tracking' \\\n--header 'Content-Type: application/json' \\\n--header 'apikey: REPLACE_KEY_VALUE' \\\n--data-raw '{\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410.00,\n \"extendedCost\": 1200.00,\n \"freightCost\": 45.50,\n \"additionalCost\": 23.20,\n \"tariffCost\": 85.00,\n \"landedCost\": 1353.70,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": null\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"additionalCharges\": 50.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450.00,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250.00,\n \"freightCost\": 75.00,\n \"totalLandedCost\": 11325.00,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n}'", "customLabel": "" }, { "id": "VRLMi8z6qihm0hVjDQgma", "language": "java", "code": "OkHttpClient client = new OkHttpClient().newBuilder()\n .build();\nMediaType mediaType = MediaType.parse(\"application/json\");\nRequestBody body = RequestBody.create(mediaType, \"{\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"TL\\\",\\n \\\"carrierModes\\\": \\\"\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrierPermalink\\\": \\\"insights-carrier-6870\\\",\\n \\\"carrierName\\\": \\\"Insights Carrier\\\",\\n \\\"carrier\\\": \\\"IC68\\\",\\n \\\"shipperAccountNumber\\\": \\\"tXXXXX234\\\",\\n \\\"haulType\\\": [\\n \\\"inbound_load\\\"\\n ],\\n \\\"loadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"displayLoadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"billOfLading\\\": \\\"billOfLading\\\",\\n \\\"bookingNumber\\\": \\\"bookingNumber\\\",\\n \\\"priority\\\": \\\"high\\\",\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"proNumber\\\": \\\"991\\\",\\n \\\"cost\\\": {\\n \\\"productCost\\\": 410.00,\\n \\\"extendedCost\\\": 1200.00,\\n \\\"freightCost\\\": 45.50,\\n \\\"additionalCost\\\": 23.20,\\n \\\"tariffCost\\\": 85.00,\\n \\\"landedCost\\\": 1353.70,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fourkitesCalculatedTariffCost\\\": null\\n },\\n \\\"products\\\": [\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n },\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Electronic Control Module\\\",\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n }\\n ],\\n \\\"referenceNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"DN-789012\\\",\\n \\\"PO-2025-5678\\\",\\n \\\"DN-345678\\\"\\n ],\\n \\\"deliveryNumbers\\\": \\\"DN-789012, DN-345678\\\",\\n \\\"masterTrackingNumber\\\": \\\"MASTER01\\\",\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"stopId\\\": \\\"1529659839\\\",\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Floor 33\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-001\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"earliestWantTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"externalAddressId\\\": \\\"100\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"latestWantTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"loadingType\\\": \\\"drop\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"bestBeforeDate\\\": \\\"2025-07-15T08:10:00Z\\\",\\n \\\"additionalCharges\\\": 500.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 1951.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"shipTo\\\": \\\"1234\\\",\\n \\\"state\\\": \\\"IL\\\",\\n \\\"stopReferenceId\\\": \\\"1529659839\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"trackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"unloadTimeInMinutes\\\": 120\\n },\\n {\\n \\\"stopId\\\": \\\"1529659852\\\",\\n \\\"addressLine1\\\": \\\"1001 E 17th Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Bloomington\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"PO-2025-5678\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-002\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-20T05:00:00\\\",\\n \\\"externalAddressId\\\": \\\"200\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-20T06:00:00\\\",\\n \\\"name\\\": \\\"Assembly Hall\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"PROD-1234512\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"additionalCharges\\\": 50.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 195.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n },\\n {\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"productName\\\": \\\"Electronic Control Module\\\",\\n \\\"productDescription\\\": \\\"Advanced electronic control unit for automotive applications\\\",\\n \\\"productCategory\\\": \\\"Electronics\\\",\\n \\\"quantity\\\": 25,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 12.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 450.00,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 11250.00,\\n \\\"freightCost\\\": 75.00,\\n \\\"totalLandedCost\\\": 11325.00,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8537109900\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-5678\\\",\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"handlingUnitId\\\": \\\"BOX-002345\\\",\\n \\\"barcode\\\": \\\"234567890123\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"09876543210987\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-ECM-002\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-ECM-890\\\",\\n \\\"brandName\\\": \\\"TechControl\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-ECM-002345\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"47408\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\",\\n \\\"TRK-890123456\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"IN\\\",\\n \\\"stopReferenceId\\\": \\\"1529659852\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"trackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"unloadTimeInMinutes\\\": 150,\\n \\\"wantTime\\\": \\\"2026-07-21T13:00:00Z\\\"\\n }\\n ],\\n \\\"tags\\\": [\\n \\\"Tag1\\\",\\n \\\"Tag2\\\",\\n \\\"Tag3\\\"\\n ],\\n \\\"trackingInfo\\\": {\\n \\\"deviceId\\\": \\\"12356\\\",\\n \\\"driverId\\\": \\\"999\\\",\\n \\\"driverPhone\\\": \\\"+19999999999\\\",\\n \\\"mawb\\\": \\\"17233144555\\\",\\n \\\"trailerNumber\\\": \\\"123\\\",\\n \\\"truckNumber\\\": \\\"456\\\"\\n },\\n \\\"trackingNumber\\\": \\\"123456789\\\",\\n \\\"truckRoutingParams\\\": {\\n \\\"height\\\": \\\"4.145\\\",\\n \\\"length\\\": \\\"14.63\\\",\\n \\\"limitedWeight\\\": \\\"996\\\",\\n \\\"shippedHazardousGoods\\\": \\\"flammable\\\",\\n \\\"trailersCount\\\": 0,\\n \\\"truckType\\\": \\\"truck\\\",\\n \\\"tunnelCategory\\\": \\\"C\\\",\\n \\\"weightPerAxle\\\": \\\"498\\\",\\n \\\"width\\\": \\\"2.438\\\"\\n },\\n \\\"seal\\\": \\\"XYZ123\\\",\\n \\\"sealStatus\\\": \\\"XYZ123\\\"\\n }\\n}\");\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": "y0P2cjJPDcugW4iYQlOsy", "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 \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410,\n \"extendedCost\": 1200,\n \"freightCost\": 45.5,\n \"additionalCost\": 23.2,\n \"tariffCost\": 85,\n \"landedCost\": 1353.7,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": null\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"additionalCharges\": 50,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250,\n \"freightCost\": 75,\n \"totalLandedCost\": 11325,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n }),\n};\n\n$.ajax(settings).done(function (response) {\n console.log(response);\n});", "customLabel": "" }, { "id": "cKuiD8kkjyiesLasUeiQ2", "language": "swift", "code": "let parameters = \"{\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"TL\\\",\\n \\\"carrierModes\\\": \\\"\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrierPermalink\\\": \\\"insights-carrier-6870\\\",\\n \\\"carrierName\\\": \\\"Insights Carrier\\\",\\n \\\"carrier\\\": \\\"IC68\\\",\\n \\\"shipperAccountNumber\\\": \\\"tXXXXX234\\\",\\n \\\"haulType\\\": [\\n \\\"inbound_load\\\"\\n ],\\n \\\"loadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"displayLoadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"billOfLading\\\": \\\"billOfLading\\\",\\n \\\"bookingNumber\\\": \\\"bookingNumber\\\",\\n \\\"priority\\\": \\\"high\\\",\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"proNumber\\\": \\\"991\\\",\\n \\\"cost\\\": {\\n \\\"productCost\\\": 410.00,\\n \\\"extendedCost\\\": 1200.00,\\n \\\"freightCost\\\": 45.50,\\n \\\"additionalCost\\\": 23.20,\\n \\\"tariffCost\\\": 85.00,\\n \\\"landedCost\\\": 1353.70,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fourkitesCalculatedTariffCost\\\": null\\n },\\n \\\"products\\\": [\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n },\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Electronic Control Module\\\",\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n }\\n ],\\n \\\"referenceNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"DN-789012\\\",\\n \\\"PO-2025-5678\\\",\\n \\\"DN-345678\\\"\\n ],\\n \\\"deliveryNumbers\\\": \\\"DN-789012, DN-345678\\\",\\n \\\"masterTrackingNumber\\\": \\\"MASTER01\\\",\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"stopId\\\": \\\"1529659839\\\",\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Floor 33\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-001\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"earliestWantTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"externalAddressId\\\": \\\"100\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"latestWantTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"loadingType\\\": \\\"drop\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"bestBeforeDate\\\": \\\"2025-07-15T08:10:00Z\\\",\\n \\\"additionalCharges\\\": 500.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 1951.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"shipTo\\\": \\\"1234\\\",\\n \\\"state\\\": \\\"IL\\\",\\n \\\"stopReferenceId\\\": \\\"1529659839\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"trackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"unloadTimeInMinutes\\\": 120\\n },\\n {\\n \\\"stopId\\\": \\\"1529659852\\\",\\n \\\"addressLine1\\\": \\\"1001 E 17th Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Bloomington\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"PO-2025-5678\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-002\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-20T05:00:00\\\",\\n \\\"externalAddressId\\\": \\\"200\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-20T06:00:00\\\",\\n \\\"name\\\": \\\"Assembly Hall\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"PROD-1234512\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"additionalCharges\\\": 50.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 195.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n },\\n {\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"productName\\\": \\\"Electronic Control Module\\\",\\n \\\"productDescription\\\": \\\"Advanced electronic control unit for automotive applications\\\",\\n \\\"productCategory\\\": \\\"Electronics\\\",\\n \\\"quantity\\\": 25,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 12.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 450.00,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 11250.00,\\n \\\"freightCost\\\": 75.00,\\n \\\"totalLandedCost\\\": 11325.00,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8537109900\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-5678\\\",\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"handlingUnitId\\\": \\\"BOX-002345\\\",\\n \\\"barcode\\\": \\\"234567890123\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"09876543210987\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-ECM-002\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-ECM-890\\\",\\n \\\"brandName\\\": \\\"TechControl\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-ECM-002345\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"47408\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\",\\n \\\"TRK-890123456\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"IN\\\",\\n \\\"stopReferenceId\\\": \\\"1529659852\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"trackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"unloadTimeInMinutes\\\": 150,\\n \\\"wantTime\\\": \\\"2026-07-21T13:00:00Z\\\"\\n }\\n ],\\n \\\"tags\\\": [\\n \\\"Tag1\\\",\\n \\\"Tag2\\\",\\n \\\"Tag3\\\"\\n ],\\n \\\"trackingInfo\\\": {\\n \\\"deviceId\\\": \\\"12356\\\",\\n \\\"driverId\\\": \\\"999\\\",\\n \\\"driverPhone\\\": \\\"+19999999999\\\",\\n \\\"mawb\\\": \\\"17233144555\\\",\\n \\\"trailerNumber\\\": \\\"123\\\",\\n \\\"truckNumber\\\": \\\"456\\\"\\n },\\n \\\"trackingNumber\\\": \\\"123456789\\\",\\n \\\"truckRoutingParams\\\": {\\n \\\"height\\\": \\\"4.145\\\",\\n \\\"length\\\": \\\"14.63\\\",\\n \\\"limitedWeight\\\": \\\"996\\\",\\n \\\"shippedHazardousGoods\\\": \\\"flammable\\\",\\n \\\"trailersCount\\\": 0,\\n \\\"truckType\\\": \\\"truck\\\",\\n \\\"tunnelCategory\\\": \\\"C\\\",\\n \\\"weightPerAxle\\\": \\\"498\\\",\\n \\\"width\\\": \\\"2.438\\\"\\n },\\n \\\"seal\\\": \\\"XYZ123\\\",\\n \\\"sealStatus\\\": \\\"XYZ123\\\"\\n }\\n}\"\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 return\n }\n print(String(data: data, encoding: .utf8)!)\n}\n\ntask.resume()\n", "customLabel": "" }, { "id": "5dJrjshFeSBU8y2rBAs-E", "language": "csharp", "code": "var client = new HttpClient();\nvar request = new HttpRequestMessage(HttpMethod.Post, \"https://api-staging.fourkites.com/api/v1/tracking\");\nrequest.Headers.Add(\"apikey\", \"REPLACE_KEY_VALUE\");\nvar content = new StringContent(\"{\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"TL\\\",\\n \\\"carrierModes\\\": \\\"\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrierPermalink\\\": \\\"insights-carrier-6870\\\",\\n \\\"carrierName\\\": \\\"Insights Carrier\\\",\\n \\\"carrier\\\": \\\"IC68\\\",\\n \\\"shipperAccountNumber\\\": \\\"tXXXXX234\\\",\\n \\\"haulType\\\": [\\n \\\"inbound_load\\\"\\n ],\\n \\\"loadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"displayLoadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"billOfLading\\\": \\\"billOfLading\\\",\\n \\\"bookingNumber\\\": \\\"bookingNumber\\\",\\n \\\"priority\\\": \\\"high\\\",\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"proNumber\\\": \\\"991\\\",\\n \\\"cost\\\": {\\n \\\"productCost\\\": 410.00,\\n \\\"extendedCost\\\": 1200.00,\\n \\\"freightCost\\\": 45.50,\\n \\\"additionalCost\\\": 23.20,\\n \\\"tariffCost\\\": 85.00,\\n \\\"landedCost\\\": 1353.70,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fourkitesCalculatedTariffCost\\\": null\\n },\\n \\\"products\\\": [\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n },\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Electronic Control Module\\\",\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n }\\n ],\\n \\\"referenceNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"DN-789012\\\",\\n \\\"PO-2025-5678\\\",\\n \\\"DN-345678\\\"\\n ],\\n \\\"deliveryNumbers\\\": \\\"DN-789012, DN-345678\\\",\\n \\\"masterTrackingNumber\\\": \\\"MASTER01\\\",\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"stopId\\\": \\\"1529659839\\\",\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Floor 33\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-001\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"earliestWantTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"externalAddressId\\\": \\\"100\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"latestWantTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"loadingType\\\": \\\"drop\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"bestBeforeDate\\\": \\\"2025-07-15T08:10:00Z\\\",\\n \\\"additionalCharges\\\": 500.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 1951.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"shipTo\\\": \\\"1234\\\",\\n \\\"state\\\": \\\"IL\\\",\\n \\\"stopReferenceId\\\": \\\"1529659839\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"trackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"unloadTimeInMinutes\\\": 120\\n },\\n {\\n \\\"stopId\\\": \\\"1529659852\\\",\\n \\\"addressLine1\\\": \\\"1001 E 17th Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Bloomington\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"PO-2025-5678\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-002\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-20T05:00:00\\\",\\n \\\"externalAddressId\\\": \\\"200\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-20T06:00:00\\\",\\n \\\"name\\\": \\\"Assembly Hall\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"PROD-1234512\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"additionalCharges\\\": 50.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 195.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n },\\n {\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"productName\\\": \\\"Electronic Control Module\\\",\\n \\\"productDescription\\\": \\\"Advanced electronic control unit for automotive applications\\\",\\n \\\"productCategory\\\": \\\"Electronics\\\",\\n \\\"quantity\\\": 25,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 12.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 450.00,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 11250.00,\\n \\\"freightCost\\\": 75.00,\\n \\\"totalLandedCost\\\": 11325.00,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8537109900\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-5678\\\",\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"handlingUnitId\\\": \\\"BOX-002345\\\",\\n \\\"barcode\\\": \\\"234567890123\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"09876543210987\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-ECM-002\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-ECM-890\\\",\\n \\\"brandName\\\": \\\"TechControl\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-ECM-002345\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"47408\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\",\\n \\\"TRK-890123456\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"IN\\\",\\n \\\"stopReferenceId\\\": \\\"1529659852\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"trackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"unloadTimeInMinutes\\\": 150,\\n \\\"wantTime\\\": \\\"2026-07-21T13:00:00Z\\\"\\n }\\n ],\\n \\\"tags\\\": [\\n \\\"Tag1\\\",\\n \\\"Tag2\\\",\\n \\\"Tag3\\\"\\n ],\\n \\\"trackingInfo\\\": {\\n \\\"deviceId\\\": \\\"12356\\\",\\n \\\"driverId\\\": \\\"999\\\",\\n \\\"driverPhone\\\": \\\"+19999999999\\\",\\n \\\"mawb\\\": \\\"17233144555\\\",\\n \\\"trailerNumber\\\": \\\"123\\\",\\n \\\"truckNumber\\\": \\\"456\\\"\\n },\\n \\\"trackingNumber\\\": \\\"123456789\\\",\\n \\\"truckRoutingParams\\\": {\\n \\\"height\\\": \\\"4.145\\\",\\n \\\"length\\\": \\\"14.63\\\",\\n \\\"limitedWeight\\\": \\\"996\\\",\\n \\\"shippedHazardousGoods\\\": \\\"flammable\\\",\\n \\\"trailersCount\\\": 0,\\n \\\"truckType\\\": \\\"truck\\\",\\n \\\"tunnelCategory\\\": \\\"C\\\",\\n \\\"weightPerAxle\\\": \\\"498\\\",\\n \\\"width\\\": \\\"2.438\\\"\\n },\\n \\\"seal\\\": \\\"XYZ123\\\",\\n \\\"sealStatus\\\": \\\"XYZ123\\\"\\n }\\n}\", null, \"application/json\");\nrequest.Content = content;\nvar response = await client.SendAsync(request);\nresponse.EnsureSuccessStatusCode();\nConsole.WriteLine(await response.Content.ReadAsStringAsync());\n", "customLabel": "" }, { "id": "fh2kyGCeGBoH8iok802FY", "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 \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410.00,\n \"extendedCost\": 1200.00,\n \"freightCost\": 45.50,\n \"additionalCost\": 23.20,\n \"tariffCost\": 85.00,\n \"landedCost\": 1353.70,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": null\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"additionalCharges\": 50.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450.00,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250.00,\n \"freightCost\": 75.00,\n \"totalLandedCost\": 11325.00,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n}`)\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": "g62VzmM0ca7QqYHmE8JPV", "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 \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410,\n \"extendedCost\": 1200,\n \"freightCost\": 45.5,\n \"additionalCost\": 23.2,\n \"tariffCost\": 85,\n \"landedCost\": 1353.7,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": nil\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"additionalCharges\": 50,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250,\n \"freightCost\": 75,\n \"totalLandedCost\": 11325,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n})\n\nresponse = https.request(request)\nputs response.read_body\n", "customLabel": "" }, { "id": "2QDWbLPC4OWpgov8hWxjZ", "language": "python", "code": "import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api-staging.fourkites.com\")\npayload = json.dumps({\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410,\n \"extendedCost\": 1200,\n \"freightCost\": 45.5,\n \"additionalCost\": 23.2,\n \"tariffCost\": 85,\n \"landedCost\": 1353.7,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": None\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": False,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": False,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": False,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"additionalCharges\": 50,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250,\n \"freightCost\": 75,\n \"totalLandedCost\": 11325,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n})\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": "sa6A_WxCAcH7ovUgPbe2U" }, "description": "\n", "currentNewParameter": { "label": "Body Parameter", "value": "bodyDataParameters" }, "hasTryItOut": false, "autoGeneratedAnchorSlug": "staging", "legacyHash": "esiCCwW9e7o4b00G58bd3" } ``` ::: :::ApiMethodV2 ```json { "tab": "examples", "url": "https://api.ng.fourkites.com/api/v1/tracking", "name": "Azure - Production", "method": "POST", "request": { "pathParameters": [], "queryParameters": [], "headerParameters": [], "bodyDataParameters": [ { "name": "modeDetails", "kind": "optional", "type": "object", "description": "It contains the mode information about the load that we create.", "children": [ { "name": "shipperModes", "kind": "optional", "type": "string", "description": "It defines the mode of the load. Valid values: \"TL\", \"LTL\", \"RAIL\", \"OCEAN\", \"PARCEL\", \"AIR\"" }, { "name": "carrierModes", "kind": "optional", "type": "string", "description": "It defines the mode of the load. Valid values: \"TL\", \"LTL\", \"RAIL\", \"OCEAN\", \"PARCEL\", \"AIR" } ] }, { "name": "load", "kind": "required", "type": "object", "description": "It is the parent object for the load. Place the load attributes inside this object.", "children": [ { "name": "carrierPermalink", "kind": "optional", "type": "string", "description": "It is the unique identifier for the carrier in the FK platform." }, { "name": "carrierName", "kind": "optional", "type": "string", "description": "It is the name of the carrier in the FK platform." }, { "name": "carrier", "kind": "required", "type": "string", "description": "It is the 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": "shipperAccountNumber", "kind": "optional", "type": "string", "description": "The shipper's carrier account number, used to identify the shipper account associated with a shipment. Enables carrier integrations to retrieve account-gated data such as proof of delivery documents and signature images. " }, { "name": "haulType", "kind": "required", "type": "array", "description": "It indicates whether the load is an inbound or an outbound load. Valid values: \"inbound_load\", \"outbound_load\", \"short_haul\", \"round_trip\", \"brokered_load\", \"non-brokered_load\", \"inbound_load\", \"outbound_load\", travel_ban_warnings\"" }, { "name": "loadNumber", "kind": "required", "type": "string", "description": "It is the 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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the Ocean load." }, { "name": "bookingNumber", "kind": "optional", "type": "string", "description": "It indicates the shipping line's booking number" }, { "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": "masterSequenceNumber", "kind": "optional", "type": "string", "description": "It is the unique sequence number that represents the leg of the trip used for Consignment Pooling." }, { "name": "masterReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of consignment loads in order to group them. For example, consignmentReferenceNumber: “XAF-BATCH-1”. (Conditional Mandatory)" }, { "name": "simulaneousTrackingReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of simultaneous loads in order to group them. For example, simultaneousTrackingReferenceNumber: “E900018290”" }, { "name": "proNumber", "kind": "optional", "type": "string", "description": "This is a number that is created usually after pickup or at pickup for LTL loads. CM for LTL loads" }, { "name": "products", "kind": "optional", "type": "object", "description": "It indicates the list of temperature tracked products on a load and their temperature tracking information.", "children": [ { "name": "lowerTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the lower bound (in degrees Fahrenheit) of the acceptable temperature range for a product." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of a temperature tracked product." }, { "name": "productId", "kind": "optional", "type": "string", "description": "It indicates the FourKites - internal unique identifier for a temperature tracked product. This is a primary key and duplicates are not allowed. The value must already exist in FourKites®." }, { "name": "setTemperature", "kind": "optional", "type": "string", "description": "It indicates the target temperature at which the product is maintained." }, { "name": "timeToleranceInMinutes", "kind": "optional", "type": "string", "description": "It indicates the acceptable time (in minutes) for a product to maintain a temperature outside the defined temperature range. Exceeding this range for a period of time equal to or greater than this time tolerance will display a critical alert in the Temperature Tracking section of a load." }, { "name": "upperTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the upper bound (in degrees Fahrenheit) of the acceptable temperature range for a product." } ] }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It is the list of load-level reference numbers associated with a load. (CM)" }, { "name": "relayLoad", "kind": "optional", "type": "boolean", "description": "It indicates whether the load is relay or team load. \tValid values: true or false. Defaults to false. (CM)" }, { "name": "stops", "kind": "required", "type": "object", "description": "It is the list of stops for the load.", "children": [ { "name": "addressLine1", "kind": "required", "type": "string", "description": "It indicates the first line of the stop's address." }, { "name": "addressLine2", "kind": "optional", "type": "string", "description": "It indicates the second line of the stop's address." }, { "name": "city", "kind": "required", "type": "string", "description": "It indicates the name of the city. \tWhen we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now we have a restriction to pass state name when the stop doesn't have external AddressId and we match the port with only city & country." }, { "name": "country", "kind": "optional", "type": "string", "description": "It indicates the valid country code. It is the 2 digit country code. When we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now, we have a restriction to pass the state name when the stop doesn't have external AddressId and we want to match the port with only city & country." }, { "name": "customer", "kind": "optional", "type": "object", "description": "It indicates the customer information for the stop. (CM)", "children": [ { "name": "id", "kind": "optional", "type": "string", "description": "It is the unique identifier of the shipper's customer. The customer should have been created in FourKites before associating it to a load's stop. (CM)" }, { "name": "poNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of Customer PO Numbers associated with the load's stop. (CM)" }, { "name": "pointOfContact", "kind": "optional", "type": "object", "description": "It indicates the point of contact (POC) information at the stop, capturing name, email, phone number, and whether they should be alerted. You can send up to 5 POCs objects per stop.", "children": [ { "name": "alert", "kind": "optional", "type": "boolean", "description": "It indicates the flag to enable or disable email notifications to the point of contact." }, { "name": "email", "kind": "optional", "type": "string", "description": "It indicates the email address of the point of contact at the stop." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of the point of contact at the stop." }, { "name": "phone", "kind": "optional", "type": "string", "description": "It indicates the phone number of the point of contact at the stop. The ISD code followed by mobile number prepended with \"+\" and no special characters." } ] }, { "name": "customer", "kind": "optional", "type": "string", "description": "Name of the customer to automatically pull in customer record." }, { "name": "customerPoFields", "kind": "optional", "type": "object", "description": "This is a list (array) of objects containing purchase order-related details from the customer.", "children": [ { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Represents the delivery number or identifier associated with the purchase order." }, { "name": "deliveryReference", "kind": "optional", "type": "string", "description": "A reference code or identifier related to the delivery, possibly provided by the customer or logistics team." }, { "name": "orderReference", "kind": "optional", "type": "string", "description": "A unique reference for the order, used to track and manage the purchase order." } ] } ] }, { "name": "earliestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the earliest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the earliestAppointmentTime is sent, then the latestAppointmentTime must also be sent." }, { "name": "earliestWantTime", "kind": "optional", "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)" }, { "name": "externalAddressId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. UNLOCODE is preferred for port stop creation in the FK platform." }, { "name": "latestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the latest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestAppointmentTime is sent, then the earliestAppointmentTime must also be sent. latestAppointmentTime should be greater than or equal to earliestAppointmentTime." }, { "name": "latestWantTime", "kind": "optional", "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. ISO 8601 format. If the latestWantTime is sent, then the earliestWantTime must also be sent. (CM)" }, { "name": "name", "kind": "required", "type": "string", "description": "It is the name of the stop." }, { "name": "loadingType", "kind": "optional", "type": "string", "description": "Indicates whether the load or shipment is Live or Drop. Valid values : \"live\" or \"drop\"" }, { "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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the pallet record." }, { "name": "number", "kind": "optional", "type": "string", "description": "It indicates the pallet number." }, { "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’s part number." }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "It indicates the part's order 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": "It indicates the description given for the material within the pallet." } ] } ] }, { "name": "postalCode", "kind": "optional", "type": "string", "description": "It indicates the valid postal code for the stop." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of stop level reference numbers associated with the stop. These are searchable within the FourKites platform. (CM)" }, { "name": "sequence", "kind": "optional", "type": "string", "description": "It indicates the stop's sequence on a load. The lower value indicates earliest scheduled stop completion. If the stop sequence is present for one stop on a load, it must be present on all stops. It is recommended to start at 1 and increment by 1 for each additional stop. (CM)" }, { "name": "shipTo", "kind": "optional", "type": "string", "description": "It is the ship to location ID associated with the stop. The shipTo values associated with pickup stops can be filtered using the \"Ship From\" filter. (CM)" }, { "name": "state", "kind": "required", "type": "string", "description": "It indicates the 2 character state code for US & Canada and 3 Character state code for Mexico. It is the 2 character State Code for US & Canada and 3 Character State Code for Mexico." }, { "name": "stopReferenceId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the stop from the customer's system. This populates the \"Reference #\" field on the stop and is used to indicate which stop an update is applied to. (CM)" }, { "name": "stopType", "kind": "required", "type": "string", "description": "It defines the function of the stop. Valid values: \"pickup\", \"delivery\", \"transfer\", \"portOfLoading\", \"transshipmentPort\", \"portOfDischarge\". There should be at least one pickup and delivery stop or one transfer (terminal) and one delivery." }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. \tFor ocean loads, use the port's UNLOCODE." }, { "name": "unloadTimeInMinutes", "kind": "optional", "type": "string", "description": "It indicates the dwell time to be used for the stop in ETA calculations (in minutes). When it is not provided, the company level default value will be used, if available or 90 minutes. This value must be sent in minutes." }, { "name": "productLineItems", "kind": "optional", "type": "object", "description": "", "children": [ { "name": "productId", "kind": "required", "type": "string", "description": "Unique identifier for the product. Mandatory if productLineItems object is present" }, { "name": "productName", "kind": "optional", "type": "string", "description": "Display name of the product" }, { "name": "productDescription", "kind": "optional", "type": "string", "description": "Detailed description of the product" }, { "name": "productCategory", "kind": "optional", "type": "string", "description": "Category classification of the product" }, { "name": "quantity", "kind": "optional", "type": "integer", "description": "Number of units in the shipment" }, { "name": "measurementUnitCode", "kind": "optional", "type": "string", "description": "Unit of measurement for quantity (e.g., PCE, KG, LB)" }, { "name": "netWeight", "kind": "optional", "type": "number", "description": "Weight of the product excluding packaging" }, { "name": "weightUnit", "kind": "optional", "type": "string", "description": "Unit of measurement for weight (e.g., KGM, LBM)" }, { "name": "unitCost", "kind": "optional", "type": "number", "description": "Cost per unit of the product" }, { "name": "currencyCode", "kind": "optional", "type": "number", "description": "Currency code for cost fields" }, { "name": "extendedCost", "kind": "optional", "type": "number", "description": "Total cost for all units (unitCost × quantity)" }, { "name": "freightCost", "kind": "optional", "type": "number", "description": "Freight cost allocated to this line item" }, { "name": "bestBeforeDate", "kind": "optional", "type": "string", "description": "Expiration or best before date for the product" }, { "name": "additionalCharges", "kind": "optional", "type": "number", "description": "Any additional charges specific to this line item" }, { "name": "tariffCost", "kind": "optional", "type": "number", "description": "Tariff cost for this specific line item" }, { "name": "fourKitesCalculatedTariffCost", "kind": "optional", "type": "number", "description": "System-calculated tariff cost" }, { "name": "totalLandedCost", "kind": "optional", "type": "number", "description": "Total landed cost for this line item" }, { "name": "countryOfOrigin", "kind": "optional", "type": "string", "description": "Country of origin for this product" }, { "name": "harmonizedSystemCode", "kind": "optional", "type": "string", "description": "International trade classification code\n" }, { "name": "commodityTypeCode", "kind": "optional", "type": "string", "description": "Commodity classification code" }, { "name": "htsusCode", "kind": "optional", "type": "string", "description": "Harmonized Tariff Schedule code for US imports" }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "Purchase order number" }, { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Delivery reference number" }, { "name": "handlingUnitId", "kind": "optional", "type": "string", "description": "Identifier for the handling unit (pallet, box, etc.)" }, { "name": "barcode", "kind": "optional", "type": "string", "description": "Product barcode" }, { "name": "containerType", "kind": "optional", "type": "string", "description": "Type of container (pallet, box, carton, etc.)" }, { "name": "gtin", "kind": "optional", "type": "string", "description": "Global Trade Item Number" }, { "name": "customerPartNumber", "kind": "optional", "type": "string", "description": "Customer's part number for the product" }, { "name": "supplierPartNumber", "kind": "optional", "type": "string", "description": "Supplier's part number for the product" }, { "name": "manufacturerPartNumber", "kind": "optional", "type": "string", "description": "Manufacturer's part number" }, { "name": "itemNumber", "kind": "optional", "type": "string", "description": "Internal item number" }, { "name": "productUpc", "kind": "optional", "type": "string", "description": "Universal Product Code" }, { "name": "deliveryReferences", "kind": "optional", "type": "string", "description": "Array of delivery reference numbers" }, { "name": "orderReferences", "kind": "optional", "type": "string", "description": "Array of order reference numbers" }, { "name": "brandName", "kind": "optional", "type": "string", "description": "Brand name of the product" }, { "name": "minimumTemperature", "kind": "optional", "type": "integer", "description": "Minimum storage/transport temperature" }, { "name": "maximumTemperature", "kind": "optional", "type": "integer", "description": "Maximum storage/transport temperature" }, { "name": "temperatureUnitCode", "kind": "optional", "type": "string", "description": "Temperature unit (cel, fah)\n" }, { "name": "labelIdentifier", "kind": "optional", "type": "string", "description": "Label identifier for tracking" }, { "name": "productTrackingNumber", "kind": "optional", "type": "string", "description": "Unique tracking number for the product" }, { "name": "deviceType", "kind": "optional", "type": "string", "description": "Type of tracking device (RFID_TAG, QR_CODE, etc.)" } ] } ] }, { "name": "tags", "kind": "optional", "type": "array", "description": "It is the list of tags or labels to be assigned to a load. Loads can be filtered in FourKites using tags. It is used for assigning categories for the load. A single tag can't exceed 50 characters. Even though we don’t have restrictions on the number of tags, it is advisable to keep total characters of all tags within the count of 255. (CM)" }, { "name": "trackingInfo", "kind": "optional", "type": "object", "description": "It indicates the information required for tracking the load.", "children": [ { "name": "deviceId", "kind": "optional", "type": "string", "description": "It indicates the ID of the GPS puck attached to the pallet or the trailer." }, { "name": "driverId", "kind": "optional", "type": "string", "description": "It indicates the driver ID used for CarrierLink access for private fleet owners. The driver ID is used by drivers of private fleet owners to log into CarrierLink and see the loads assigned to them. There should be an existing driver user in the platform with the same driver ID." }, { "name": "driverPhone", "kind": "optional", "type": "string", "description": "It indicates a valid mobile number. Example: +13125555555. \tThe ISD code followed by mobile number prepended with \"+\" and no special characters." }, { "name": "mawb", "kind": "optional", "type": "string", "description": "The carrier’s air waybill issued to cover a consolidated shipment tendered by a forwarder or consolidator." }, { "name": "trailerNumber", "kind": "optional", "type": "string", "description": "It indicates the trailer number assigned to the load." }, { "name": "truckNumber", "kind": "optional", "type": "string", "description": "It indicates the tractor or asset number dispatched by the carrier for the load." } ] }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is for parcel tracking only; any tracking number provided by the carrier or other entities." }, { "name": "truckRoutingParams", "kind": "optional", "type": "object", "description": "It indicates the information required for getting truck specific routing. If provided, the routing of the truck and ETA calculations will be done based on these parameters.", "children": [ { "name": "height", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s height in meters. Valid values: Between 0 and 50." }, { "name": "length", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s length in meters. Valid values: Between 0 and 300." }, { "name": "limitedWeight", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight including trailers and shipped goods in tons. Valid values: Between 0 and 1000." }, { "name": "shippedHazardousGoods", "kind": "optional", "type": "string", "description": "It indicates the list of hazaradous materials in the vehicle. Enum [explosive , gas , flammable , organic , combustible , poison , radioActive , corrosive , poisonousInhalation , harmfulToWater , other]. Valid values: \"explosive\", \"gas\", \"flammable\", \"organic\", \"combustible\", \"poison\", \"radioActive\", \"corrosive\", \"poisonousInhalation\", \"harmfulToWater\", \"other\".\n\n" }, { "name": "trailersCount", "kind": "optional", "type": "string", "description": "It specifies the number of trailers pulled by a vehicle. Valid values: 0, 1, 2, 3,4. Defaults to 0." }, { "name": "truckType", "kind": "optional", "type": "string", "description": "It specifies the vehicle type. It defaults to truck. Enum [truck , tractorTruck]. \tValid values: \"truck\" or \"tractorTruck\"." }, { "name": "tunnelCategory", "kind": "optional", "type": "string", "description": "It specifies the tunnel category to restrict certain routes. The route will pass only through tunnels of a less strict category. Enum [B , C , D , E]. \tValid values: \"B\", \"C\", \"D\", \"E\"" }, { "name": "weightPerAxle", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight per axle in tons. Valid values: Between 0 and 1000." }, { "name": "width", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s width in meters. Valid values: Between 0 and 50." } ] }, { "name": "seal", "kind": "optional", "type": "string", "description": "It is the seal number that identifies the seal on the load." }, { "name": "sealStatus", "kind": "optional", "type": "string", "description": "It is the seal status that represents the status of the seal on the load." }, { "name": "simultaneousTrackingSequenceNumber", "kind": "optional", "type": "number", "description": "This parameter will allow Shippers and Carriers to provide the sequence number to order the delivery sequence to calculate better ETAs. \n\nThe earlier logic would consider either the shortest distance or the Appointment time to sequence the stops for ETA calculation.\n\nThe new logic will look like this:\n- If the Simultaneous tracking Sequence number is provided, this will be given the first priority.\n- If not, then use the existing logic." }, { "name": "deliveryNumbers", "kind": "optional", "type": "string", "description": "Array of strings supporting multiple delivery references per shipment (typically comma separated). Same as delivery numbers on deliveries in an order." }, { "name": "masterTrackingNumber", "kind": "optional", "type": "string", "description": "Single string field for shipment relationship tracking. This is primarily to indicate the master tracking number for split parcels." } ], "schema": [ { "name": "carrierPermalink", "kind": "optional", "type": "string", "description": "It is the unique identifier for the carrier in the FK platform." }, { "name": "carrierName", "kind": "optional", "type": "string", "description": "It is the name of the carrier in the FK platform." }, { "name": "carrier", "kind": "required", "type": "string", "description": "It is the 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": "shipperAccountNumber", "kind": "optional", "type": "string", "description": "The shipper's carrier account number, used to identify the shipper account associated with a shipment. Enables carrier integrations to retrieve account-gated data such as proof of delivery documents and signature images. " }, { "name": "haulType", "kind": "required", "type": "array", "description": "It indicates whether the load is an inbound or an outbound load. Valid values: \"inbound_load\", \"outbound_load\", \"short_haul\", \"round_trip\", \"brokered_load\", \"non-brokered_load\", \"inbound_load\", \"outbound_load\", travel_ban_warnings\"" }, { "name": "loadNumber", "kind": "required", "type": "string", "description": "It is the 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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the Ocean load." }, { "name": "bookingNumber", "kind": "optional", "type": "string", "description": "It indicates the shipping line's booking number" }, { "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": "masterSequenceNumber", "kind": "optional", "type": "string", "description": "It is the unique sequence number that represents the leg of the trip used for Consignment Pooling." }, { "name": "masterReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of consignment loads in order to group them. For example, consignmentReferenceNumber: “XAF-BATCH-1”. (Conditional Mandatory)" }, { "name": "simulaneousTrackingReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of simultaneous loads in order to group them. For example, simultaneousTrackingReferenceNumber: “E900018290”" }, { "name": "proNumber", "kind": "optional", "type": "string", "description": "This is a number that is created usually after pickup or at pickup for LTL loads. CM for LTL loads" }, { "name": "products", "kind": "optional", "type": "object", "description": "It indicates the list of temperature tracked products on a load and their temperature tracking information.", "children": [ { "name": "lowerTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the lower bound (in degrees Fahrenheit) of the acceptable temperature range for a product." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of a temperature tracked product." }, { "name": "productId", "kind": "optional", "type": "string", "description": "It indicates the FourKites - internal unique identifier for a temperature tracked product. This is a primary key and duplicates are not allowed. The value must already exist in FourKites®." }, { "name": "setTemperature", "kind": "optional", "type": "string", "description": "It indicates the target temperature at which the product is maintained." }, { "name": "timeToleranceInMinutes", "kind": "optional", "type": "string", "description": "It indicates the acceptable time (in minutes) for a product to maintain a temperature outside the defined temperature range. Exceeding this range for a period of time equal to or greater than this time tolerance will display a critical alert in the Temperature Tracking section of a load." }, { "name": "upperTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the upper bound (in degrees Fahrenheit) of the acceptable temperature range for a product." } ] }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It is the list of load-level reference numbers associated with a load. (CM)" }, { "name": "relayLoad", "kind": "optional", "type": "boolean", "description": "It indicates whether the load is relay or team load. \tValid values: true or false. Defaults to false. (CM)" }, { "name": "stops", "kind": "required", "type": "object", "description": "It is the list of stops for the load.", "children": [ { "name": "addressLine1", "kind": "required", "type": "string", "description": "It indicates the first line of the stop's address." }, { "name": "addressLine2", "kind": "optional", "type": "string", "description": "It indicates the second line of the stop's address." }, { "name": "city", "kind": "required", "type": "string", "description": "It indicates the name of the city. \tWhen we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now we have a restriction to pass state name when the stop doesn't have external AddressId and we match the port with only city & country." }, { "name": "country", "kind": "optional", "type": "string", "description": "It indicates the valid country code. It is the 2 digit country code. When we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now, we have a restriction to pass the state name when the stop doesn't have external AddressId and we want to match the port with only city & country." }, { "name": "customer", "kind": "optional", "type": "object", "description": "It indicates the customer information for the stop. (CM)", "children": [ { "name": "id", "kind": "optional", "type": "string", "description": "It is the unique identifier of the shipper's customer. The customer should have been created in FourKites before associating it to a load's stop. (CM)" }, { "name": "poNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of Customer PO Numbers associated with the load's stop. (CM)" }, { "name": "pointOfContact", "kind": "optional", "type": "object", "description": "It indicates the point of contact (POC) information at the stop, capturing name, email, phone number, and whether they should be alerted. You can send up to 5 POCs objects per stop.", "children": [ { "name": "alert", "kind": "optional", "type": "boolean", "description": "It indicates the flag to enable or disable email notifications to the point of contact." }, { "name": "email", "kind": "optional", "type": "string", "description": "It indicates the email address of the point of contact at the stop." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of the point of contact at the stop." }, { "name": "phone", "kind": "optional", "type": "string", "description": "It indicates the phone number of the point of contact at the stop. The ISD code followed by mobile number prepended with \"+\" and no special characters." } ] }, { "name": "customer", "kind": "optional", "type": "string", "description": "Name of the customer to automatically pull in customer record." }, { "name": "customerPoFields", "kind": "optional", "type": "object", "description": "This is a list (array) of objects containing purchase order-related details from the customer.", "children": [ { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Represents the delivery number or identifier associated with the purchase order." }, { "name": "deliveryReference", "kind": "optional", "type": "string", "description": "A reference code or identifier related to the delivery, possibly provided by the customer or logistics team." }, { "name": "orderReference", "kind": "optional", "type": "string", "description": "A unique reference for the order, used to track and manage the purchase order." } ] } ] }, { "name": "earliestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the earliest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the earliestAppointmentTime is sent, then the latestAppointmentTime must also be sent." }, { "name": "earliestWantTime", "kind": "optional", "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)" }, { "name": "externalAddressId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. UNLOCODE is preferred for port stop creation in the FK platform." }, { "name": "latestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the latest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestAppointmentTime is sent, then the earliestAppointmentTime must also be sent. latestAppointmentTime should be greater than or equal to earliestAppointmentTime." }, { "name": "latestWantTime", "kind": "optional", "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. ISO 8601 format. If the latestWantTime is sent, then the earliestWantTime must also be sent. (CM)" }, { "name": "name", "kind": "required", "type": "string", "description": "It is the name of the stop." }, { "name": "loadingType", "kind": "optional", "type": "string", "description": "Indicates whether the load or shipment is Live or Drop. Valid values : \"live\" or \"drop\"" }, { "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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the pallet record." }, { "name": "number", "kind": "optional", "type": "string", "description": "It indicates the pallet number." }, { "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’s part number." }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "It indicates the part's order 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": "It indicates the description given for the material within the pallet." } ] } ] }, { "name": "postalCode", "kind": "optional", "type": "string", "description": "It indicates the valid postal code for the stop." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of stop level reference numbers associated with the stop. These are searchable within the FourKites platform. (CM)" }, { "name": "sequence", "kind": "optional", "type": "string", "description": "It indicates the stop's sequence on a load. The lower value indicates earliest scheduled stop completion. If the stop sequence is present for one stop on a load, it must be present on all stops. It is recommended to start at 1 and increment by 1 for each additional stop. (CM)" }, { "name": "shipTo", "kind": "optional", "type": "string", "description": "It is the ship to location ID associated with the stop. The shipTo values associated with pickup stops can be filtered using the \"Ship From\" filter. (CM)" }, { "name": "state", "kind": "required", "type": "string", "description": "It indicates the 2 character state code for US & Canada and 3 Character state code for Mexico. It is the 2 character State Code for US & Canada and 3 Character State Code for Mexico." }, { "name": "stopReferenceId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the stop from the customer's system. This populates the \"Reference #\" field on the stop and is used to indicate which stop an update is applied to. (CM)" }, { "name": "stopType", "kind": "required", "type": "string", "description": "It defines the function of the stop. Valid values: \"pickup\", \"delivery\", \"transfer\", \"portOfLoading\", \"transshipmentPort\", \"portOfDischarge\". There should be at least one pickup and delivery stop or one transfer (terminal) and one delivery." }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. \tFor ocean loads, use the port's UNLOCODE." }, { "name": "unloadTimeInMinutes", "kind": "optional", "type": "string", "description": "It indicates the dwell time to be used for the stop in ETA calculations (in minutes). When it is not provided, the company level default value will be used, if available or 90 minutes. This value must be sent in minutes." }, { "name": "productLineItems", "kind": "optional", "type": "object", "description": "", "children": [ { "name": "productId", "kind": "required", "type": "string", "description": "Unique identifier for the product. Mandatory if productLineItems object is present" }, { "name": "productName", "kind": "optional", "type": "string", "description": "Display name of the product" }, { "name": "productDescription", "kind": "optional", "type": "string", "description": "Detailed description of the product" }, { "name": "productCategory", "kind": "optional", "type": "string", "description": "Category classification of the product" }, { "name": "quantity", "kind": "optional", "type": "integer", "description": "Number of units in the shipment" }, { "name": "measurementUnitCode", "kind": "optional", "type": "string", "description": "Unit of measurement for quantity (e.g., PCE, KG, LB)" }, { "name": "netWeight", "kind": "optional", "type": "number", "description": "Weight of the product excluding packaging" }, { "name": "weightUnit", "kind": "optional", "type": "string", "description": "Unit of measurement for weight (e.g., KGM, LBM)" }, { "name": "unitCost", "kind": "optional", "type": "number", "description": "Cost per unit of the product" }, { "name": "currencyCode", "kind": "optional", "type": "number", "description": "Currency code for cost fields" }, { "name": "extendedCost", "kind": "optional", "type": "number", "description": "Total cost for all units (unitCost × quantity)" }, { "name": "freightCost", "kind": "optional", "type": "number", "description": "Freight cost allocated to this line item" }, { "name": "bestBeforeDate", "kind": "optional", "type": "string", "description": "Expiration or best before date for the product" }, { "name": "additionalCharges", "kind": "optional", "type": "number", "description": "Any additional charges specific to this line item" }, { "name": "tariffCost", "kind": "optional", "type": "number", "description": "Tariff cost for this specific line item" }, { "name": "fourKitesCalculatedTariffCost", "kind": "optional", "type": "number", "description": "System-calculated tariff cost" }, { "name": "totalLandedCost", "kind": "optional", "type": "number", "description": "Total landed cost for this line item" }, { "name": "countryOfOrigin", "kind": "optional", "type": "string", "description": "Country of origin for this product" }, { "name": "harmonizedSystemCode", "kind": "optional", "type": "string", "description": "International trade classification code\n" }, { "name": "commodityTypeCode", "kind": "optional", "type": "string", "description": "Commodity classification code" }, { "name": "htsusCode", "kind": "optional", "type": "string", "description": "Harmonized Tariff Schedule code for US imports" }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "Purchase order number" }, { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Delivery reference number" }, { "name": "handlingUnitId", "kind": "optional", "type": "string", "description": "Identifier for the handling unit (pallet, box, etc.)" }, { "name": "barcode", "kind": "optional", "type": "string", "description": "Product barcode" }, { "name": "containerType", "kind": "optional", "type": "string", "description": "Type of container (pallet, box, carton, etc.)" }, { "name": "gtin", "kind": "optional", "type": "string", "description": "Global Trade Item Number" }, { "name": "customerPartNumber", "kind": "optional", "type": "string", "description": "Customer's part number for the product" }, { "name": "supplierPartNumber", "kind": "optional", "type": "string", "description": "Supplier's part number for the product" }, { "name": "manufacturerPartNumber", "kind": "optional", "type": "string", "description": "Manufacturer's part number" }, { "name": "itemNumber", "kind": "optional", "type": "string", "description": "Internal item number" }, { "name": "productUpc", "kind": "optional", "type": "string", "description": "Universal Product Code" }, { "name": "deliveryReferences", "kind": "optional", "type": "string", "description": "Array of delivery reference numbers" }, { "name": "orderReferences", "kind": "optional", "type": "string", "description": "Array of order reference numbers" }, { "name": "brandName", "kind": "optional", "type": "string", "description": "Brand name of the product" }, { "name": "minimumTemperature", "kind": "optional", "type": "integer", "description": "Minimum storage/transport temperature" }, { "name": "maximumTemperature", "kind": "optional", "type": "integer", "description": "Maximum storage/transport temperature" }, { "name": "temperatureUnitCode", "kind": "optional", "type": "string", "description": "Temperature unit (cel, fah)\n" }, { "name": "labelIdentifier", "kind": "optional", "type": "string", "description": "Label identifier for tracking" }, { "name": "productTrackingNumber", "kind": "optional", "type": "string", "description": "Unique tracking number for the product" }, { "name": "deviceType", "kind": "optional", "type": "string", "description": "Type of tracking device (RFID_TAG, QR_CODE, etc.)" } ] } ] }, { "name": "tags", "kind": "optional", "type": "array", "description": "It is the list of tags or labels to be assigned to a load. Loads can be filtered in FourKites using tags. It is used for assigning categories for the load. A single tag can't exceed 50 characters. Even though we don’t have restrictions on the number of tags, it is advisable to keep total characters of all tags within the count of 255. (CM)" }, { "name": "trackingInfo", "kind": "optional", "type": "object", "description": "It indicates the information required for tracking the load.", "children": [ { "name": "deviceId", "kind": "optional", "type": "string", "description": "It indicates the ID of the GPS puck attached to the pallet or the trailer." }, { "name": "driverId", "kind": "optional", "type": "string", "description": "It indicates the driver ID used for CarrierLink access for private fleet owners. The driver ID is used by drivers of private fleet owners to log into CarrierLink and see the loads assigned to them. There should be an existing driver user in the platform with the same driver ID." }, { "name": "driverPhone", "kind": "optional", "type": "string", "description": "It indicates a valid mobile number. Example: +13125555555. \tThe ISD code followed by mobile number prepended with \"+\" and no special characters." }, { "name": "mawb", "kind": "optional", "type": "string", "description": "The carrier’s air waybill issued to cover a consolidated shipment tendered by a forwarder or consolidator." }, { "name": "trailerNumber", "kind": "optional", "type": "string", "description": "It indicates the trailer number assigned to the load." }, { "name": "truckNumber", "kind": "optional", "type": "string", "description": "It indicates the tractor or asset number dispatched by the carrier for the load." } ] }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is for parcel tracking only; any tracking number provided by the carrier or other entities." }, { "name": "truckRoutingParams", "kind": "optional", "type": "object", "description": "It indicates the information required for getting truck specific routing. If provided, the routing of the truck and ETA calculations will be done based on these parameters.", "children": [ { "name": "height", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s height in meters. Valid values: Between 0 and 50." }, { "name": "length", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s length in meters. Valid values: Between 0 and 300." }, { "name": "limitedWeight", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight including trailers and shipped goods in tons. Valid values: Between 0 and 1000." }, { "name": "shippedHazardousGoods", "kind": "optional", "type": "string", "description": "It indicates the list of hazaradous materials in the vehicle. Enum [explosive , gas , flammable , organic , combustible , poison , radioActive , corrosive , poisonousInhalation , harmfulToWater , other]. Valid values: \"explosive\", \"gas\", \"flammable\", \"organic\", \"combustible\", \"poison\", \"radioActive\", \"corrosive\", \"poisonousInhalation\", \"harmfulToWater\", \"other\".\n\n" }, { "name": "trailersCount", "kind": "optional", "type": "string", "description": "It specifies the number of trailers pulled by a vehicle. Valid values: 0, 1, 2, 3,4. Defaults to 0." }, { "name": "truckType", "kind": "optional", "type": "string", "description": "It specifies the vehicle type. It defaults to truck. Enum [truck , tractorTruck]. \tValid values: \"truck\" or \"tractorTruck\"." }, { "name": "tunnelCategory", "kind": "optional", "type": "string", "description": "It specifies the tunnel category to restrict certain routes. The route will pass only through tunnels of a less strict category. Enum [B , C , D , E]. \tValid values: \"B\", \"C\", \"D\", \"E\"" }, { "name": "weightPerAxle", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight per axle in tons. Valid values: Between 0 and 1000." }, { "name": "width", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s width in meters. Valid values: Between 0 and 50." } ] }, { "name": "seal", "kind": "optional", "type": "string", "description": "It is the seal number that identifies the seal on the load." }, { "name": "sealStatus", "kind": "optional", "type": "string", "description": "It is the seal status that represents the status of the seal on the load." }, { "name": "simultaneousTrackingSequenceNumber", "kind": "optional", "type": "number", "description": "This parameter will allow Shippers and Carriers to provide the sequence number to order the delivery sequence to calculate better ETAs. \n\nThe earlier logic would consider either the shortest distance or the Appointment time to sequence the stops for ETA calculation.\n\nThe new logic will look like this:\n- If the Simultaneous tracking Sequence number is provided, this will be given the first priority.\n- If not, then use the existing logic." }, { "name": "deliveryNumbers", "kind": "optional", "type": "string", "description": "Array of strings supporting multiple delivery references per shipment (typically comma separated). Same as delivery numbers on deliveries in an order." }, { "name": "masterTrackingNumber", "kind": "optional", "type": "string", "description": "Single string field for shipment relationship tracking. This is primarily to indicate the master tracking number for split parcels." } ] } ], "formDataParameters": [] }, "results": { "languages": [ { "id": "vJmaUlHjeNh6wzQ_MfCsY", "code": "{\n \"loadId\": 1000,\n \"message\": \"Load created successfully\",\n \"statusCode\": 200\n}", "language": "200", "customLabel": "" } ], "selectedLanguageId": "vJmaUlHjeNh6wzQ_MfCsY" }, "examples": { "languages": [ { "id": "sa6A_WxCAcH7ovUgPbe2U", "language": "curl", "code": "curl --location 'https://api.ng.fourkites.com/api/v1/tracking' \\\n--header 'Content-Type: application/json' \\\n--header 'apikey: REPLACE_KEY_VALUE' \\\n--data-raw '{\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410.00,\n \"extendedCost\": 1200.00,\n \"freightCost\": 45.50,\n \"additionalCost\": 23.20,\n \"tariffCost\": 85.00,\n \"landedCost\": 1353.70,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": null\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"additionalCharges\": 50.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450.00,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250.00,\n \"freightCost\": 75.00,\n \"totalLandedCost\": 11325.00,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n}'", "customLabel": "" }, { "id": "VRLMi8z6qihm0hVjDQgma", "language": "java", "code": "OkHttpClient client = new OkHttpClient().newBuilder()\n .build();\nMediaType mediaType = MediaType.parse(\"application/json\");\nRequestBody body = RequestBody.create(mediaType, \"{\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"TL\\\",\\n \\\"carrierModes\\\": \\\"\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrierPermalink\\\": \\\"insights-carrier-6870\\\",\\n \\\"carrierName\\\": \\\"Insights Carrier\\\",\\n \\\"carrier\\\": \\\"IC68\\\",\\n \\\"shipperAccountNumber\\\": \\\"tXXXXX234\\\",\\n \\\"haulType\\\": [\\n \\\"inbound_load\\\"\\n ],\\n \\\"loadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"displayLoadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"billOfLading\\\": \\\"billOfLading\\\",\\n \\\"bookingNumber\\\": \\\"bookingNumber\\\",\\n \\\"priority\\\": \\\"high\\\",\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"proNumber\\\": \\\"991\\\",\\n \\\"cost\\\": {\\n \\\"productCost\\\": 410.00,\\n \\\"extendedCost\\\": 1200.00,\\n \\\"freightCost\\\": 45.50,\\n \\\"additionalCost\\\": 23.20,\\n \\\"tariffCost\\\": 85.00,\\n \\\"landedCost\\\": 1353.70,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fourkitesCalculatedTariffCost\\\": null\\n },\\n \\\"products\\\": [\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n },\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Electronic Control Module\\\",\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n }\\n ],\\n \\\"referenceNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"DN-789012\\\",\\n \\\"PO-2025-5678\\\",\\n \\\"DN-345678\\\"\\n ],\\n \\\"deliveryNumbers\\\": \\\"DN-789012, DN-345678\\\",\\n \\\"masterTrackingNumber\\\": \\\"MASTER01\\\",\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"stopId\\\": \\\"1529659839\\\",\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Floor 33\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-001\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"earliestWantTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"externalAddressId\\\": \\\"100\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"latestWantTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"loadingType\\\": \\\"drop\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"bestBeforeDate\\\": \\\"2025-07-15T08:10:00Z\\\",\\n \\\"additionalCharges\\\": 500.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 1951.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"shipTo\\\": \\\"1234\\\",\\n \\\"state\\\": \\\"IL\\\",\\n \\\"stopReferenceId\\\": \\\"1529659839\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"trackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"unloadTimeInMinutes\\\": 120\\n },\\n {\\n \\\"stopId\\\": \\\"1529659852\\\",\\n \\\"addressLine1\\\": \\\"1001 E 17th Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Bloomington\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"PO-2025-5678\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-002\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-20T05:00:00\\\",\\n \\\"externalAddressId\\\": \\\"200\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-20T06:00:00\\\",\\n \\\"name\\\": \\\"Assembly Hall\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"PROD-1234512\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"additionalCharges\\\": 50.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 195.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n },\\n {\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"productName\\\": \\\"Electronic Control Module\\\",\\n \\\"productDescription\\\": \\\"Advanced electronic control unit for automotive applications\\\",\\n \\\"productCategory\\\": \\\"Electronics\\\",\\n \\\"quantity\\\": 25,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 12.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 450.00,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 11250.00,\\n \\\"freightCost\\\": 75.00,\\n \\\"totalLandedCost\\\": 11325.00,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8537109900\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-5678\\\",\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"handlingUnitId\\\": \\\"BOX-002345\\\",\\n \\\"barcode\\\": \\\"234567890123\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"09876543210987\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-ECM-002\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-ECM-890\\\",\\n \\\"brandName\\\": \\\"TechControl\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-ECM-002345\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"47408\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\",\\n \\\"TRK-890123456\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"IN\\\",\\n \\\"stopReferenceId\\\": \\\"1529659852\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"trackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"unloadTimeInMinutes\\\": 150,\\n \\\"wantTime\\\": \\\"2026-07-21T13:00:00Z\\\"\\n }\\n ],\\n \\\"tags\\\": [\\n \\\"Tag1\\\",\\n \\\"Tag2\\\",\\n \\\"Tag3\\\"\\n ],\\n \\\"trackingInfo\\\": {\\n \\\"deviceId\\\": \\\"12356\\\",\\n \\\"driverId\\\": \\\"999\\\",\\n \\\"driverPhone\\\": \\\"+19999999999\\\",\\n \\\"mawb\\\": \\\"17233144555\\\",\\n \\\"trailerNumber\\\": \\\"123\\\",\\n \\\"truckNumber\\\": \\\"456\\\"\\n },\\n \\\"trackingNumber\\\": \\\"123456789\\\",\\n \\\"truckRoutingParams\\\": {\\n \\\"height\\\": \\\"4.145\\\",\\n \\\"length\\\": \\\"14.63\\\",\\n \\\"limitedWeight\\\": \\\"996\\\",\\n \\\"shippedHazardousGoods\\\": \\\"flammable\\\",\\n \\\"trailersCount\\\": 0,\\n \\\"truckType\\\": \\\"truck\\\",\\n \\\"tunnelCategory\\\": \\\"C\\\",\\n \\\"weightPerAxle\\\": \\\"498\\\",\\n \\\"width\\\": \\\"2.438\\\"\\n },\\n \\\"seal\\\": \\\"XYZ123\\\",\\n \\\"sealStatus\\\": \\\"XYZ123\\\"\\n }\\n}\");\nRequest request = new Request.Builder()\n .url(\"https://api.ng.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": "y0P2cjJPDcugW4iYQlOsy", "language": "javascript", "code": "var settings = {\n \"url\": \"https://api.ng.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 \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410,\n \"extendedCost\": 1200,\n \"freightCost\": 45.5,\n \"additionalCost\": 23.2,\n \"tariffCost\": 85,\n \"landedCost\": 1353.7,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": null\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"additionalCharges\": 50,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250,\n \"freightCost\": 75,\n \"totalLandedCost\": 11325,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n }),\n};\n\n$.ajax(settings).done(function (response) {\n console.log(response);\n});", "customLabel": "" }, { "id": "cKuiD8kkjyiesLasUeiQ2", "language": "swift", "code": "let parameters = \"{\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"TL\\\",\\n \\\"carrierModes\\\": \\\"\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrierPermalink\\\": \\\"insights-carrier-6870\\\",\\n \\\"carrierName\\\": \\\"Insights Carrier\\\",\\n \\\"carrier\\\": \\\"IC68\\\",\\n \\\"shipperAccountNumber\\\": \\\"tXXXXX234\\\",\\n \\\"haulType\\\": [\\n \\\"inbound_load\\\"\\n ],\\n \\\"loadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"displayLoadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"billOfLading\\\": \\\"billOfLading\\\",\\n \\\"bookingNumber\\\": \\\"bookingNumber\\\",\\n \\\"priority\\\": \\\"high\\\",\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"proNumber\\\": \\\"991\\\",\\n \\\"cost\\\": {\\n \\\"productCost\\\": 410.00,\\n \\\"extendedCost\\\": 1200.00,\\n \\\"freightCost\\\": 45.50,\\n \\\"additionalCost\\\": 23.20,\\n \\\"tariffCost\\\": 85.00,\\n \\\"landedCost\\\": 1353.70,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fourkitesCalculatedTariffCost\\\": null\\n },\\n \\\"products\\\": [\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n },\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Electronic Control Module\\\",\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n }\\n ],\\n \\\"referenceNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"DN-789012\\\",\\n \\\"PO-2025-5678\\\",\\n \\\"DN-345678\\\"\\n ],\\n \\\"deliveryNumbers\\\": \\\"DN-789012, DN-345678\\\",\\n \\\"masterTrackingNumber\\\": \\\"MASTER01\\\",\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"stopId\\\": \\\"1529659839\\\",\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Floor 33\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-001\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"earliestWantTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"externalAddressId\\\": \\\"100\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"latestWantTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"loadingType\\\": \\\"drop\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"bestBeforeDate\\\": \\\"2025-07-15T08:10:00Z\\\",\\n \\\"additionalCharges\\\": 500.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 1951.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"shipTo\\\": \\\"1234\\\",\\n \\\"state\\\": \\\"IL\\\",\\n \\\"stopReferenceId\\\": \\\"1529659839\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"trackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"unloadTimeInMinutes\\\": 120\\n },\\n {\\n \\\"stopId\\\": \\\"1529659852\\\",\\n \\\"addressLine1\\\": \\\"1001 E 17th Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Bloomington\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"PO-2025-5678\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-002\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-20T05:00:00\\\",\\n \\\"externalAddressId\\\": \\\"200\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-20T06:00:00\\\",\\n \\\"name\\\": \\\"Assembly Hall\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"PROD-1234512\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"additionalCharges\\\": 50.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 195.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n },\\n {\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"productName\\\": \\\"Electronic Control Module\\\",\\n \\\"productDescription\\\": \\\"Advanced electronic control unit for automotive applications\\\",\\n \\\"productCategory\\\": \\\"Electronics\\\",\\n \\\"quantity\\\": 25,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 12.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 450.00,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 11250.00,\\n \\\"freightCost\\\": 75.00,\\n \\\"totalLandedCost\\\": 11325.00,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8537109900\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-5678\\\",\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"handlingUnitId\\\": \\\"BOX-002345\\\",\\n \\\"barcode\\\": \\\"234567890123\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"09876543210987\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-ECM-002\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-ECM-890\\\",\\n \\\"brandName\\\": \\\"TechControl\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-ECM-002345\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"47408\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\",\\n \\\"TRK-890123456\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"IN\\\",\\n \\\"stopReferenceId\\\": \\\"1529659852\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"trackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"unloadTimeInMinutes\\\": 150,\\n \\\"wantTime\\\": \\\"2026-07-21T13:00:00Z\\\"\\n }\\n ],\\n \\\"tags\\\": [\\n \\\"Tag1\\\",\\n \\\"Tag2\\\",\\n \\\"Tag3\\\"\\n ],\\n \\\"trackingInfo\\\": {\\n \\\"deviceId\\\": \\\"12356\\\",\\n \\\"driverId\\\": \\\"999\\\",\\n \\\"driverPhone\\\": \\\"+19999999999\\\",\\n \\\"mawb\\\": \\\"17233144555\\\",\\n \\\"trailerNumber\\\": \\\"123\\\",\\n \\\"truckNumber\\\": \\\"456\\\"\\n },\\n \\\"trackingNumber\\\": \\\"123456789\\\",\\n \\\"truckRoutingParams\\\": {\\n \\\"height\\\": \\\"4.145\\\",\\n \\\"length\\\": \\\"14.63\\\",\\n \\\"limitedWeight\\\": \\\"996\\\",\\n \\\"shippedHazardousGoods\\\": \\\"flammable\\\",\\n \\\"trailersCount\\\": 0,\\n \\\"truckType\\\": \\\"truck\\\",\\n \\\"tunnelCategory\\\": \\\"C\\\",\\n \\\"weightPerAxle\\\": \\\"498\\\",\\n \\\"width\\\": \\\"2.438\\\"\\n },\\n \\\"seal\\\": \\\"XYZ123\\\",\\n \\\"sealStatus\\\": \\\"XYZ123\\\"\\n }\\n}\"\nlet postData = parameters.data(using: .utf8)\n\nvar request = URLRequest(url: URL(string: \"https://api.ng.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 return\n }\n print(String(data: data, encoding: .utf8)!)\n}\n\ntask.resume()\n", "customLabel": "" }, { "id": "5dJrjshFeSBU8y2rBAs-E", "language": "csharp", "code": "var client = new HttpClient();\nvar request = new HttpRequestMessage(HttpMethod.Post, \"https://api.ng.fourkites.com/api/v1/tracking\");\nrequest.Headers.Add(\"apikey\", \"REPLACE_KEY_VALUE\");\nvar content = new StringContent(\"{\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"TL\\\",\\n \\\"carrierModes\\\": \\\"\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrierPermalink\\\": \\\"insights-carrier-6870\\\",\\n \\\"carrierName\\\": \\\"Insights Carrier\\\",\\n \\\"carrier\\\": \\\"IC68\\\",\\n \\\"shipperAccountNumber\\\": \\\"tXXXXX234\\\",\\n \\\"haulType\\\": [\\n \\\"inbound_load\\\"\\n ],\\n \\\"loadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"displayLoadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"billOfLading\\\": \\\"billOfLading\\\",\\n \\\"bookingNumber\\\": \\\"bookingNumber\\\",\\n \\\"priority\\\": \\\"high\\\",\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"proNumber\\\": \\\"991\\\",\\n \\\"cost\\\": {\\n \\\"productCost\\\": 410.00,\\n \\\"extendedCost\\\": 1200.00,\\n \\\"freightCost\\\": 45.50,\\n \\\"additionalCost\\\": 23.20,\\n \\\"tariffCost\\\": 85.00,\\n \\\"landedCost\\\": 1353.70,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fourkitesCalculatedTariffCost\\\": null\\n },\\n \\\"products\\\": [\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n },\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Electronic Control Module\\\",\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n }\\n ],\\n \\\"referenceNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"DN-789012\\\",\\n \\\"PO-2025-5678\\\",\\n \\\"DN-345678\\\"\\n ],\\n \\\"deliveryNumbers\\\": \\\"DN-789012, DN-345678\\\",\\n \\\"masterTrackingNumber\\\": \\\"MASTER01\\\",\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"stopId\\\": \\\"1529659839\\\",\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Floor 33\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-001\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"earliestWantTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"externalAddressId\\\": \\\"100\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"latestWantTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"loadingType\\\": \\\"drop\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"bestBeforeDate\\\": \\\"2025-07-15T08:10:00Z\\\",\\n \\\"additionalCharges\\\": 500.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 1951.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"shipTo\\\": \\\"1234\\\",\\n \\\"state\\\": \\\"IL\\\",\\n \\\"stopReferenceId\\\": \\\"1529659839\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"trackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"unloadTimeInMinutes\\\": 120\\n },\\n {\\n \\\"stopId\\\": \\\"1529659852\\\",\\n \\\"addressLine1\\\": \\\"1001 E 17th Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Bloomington\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"PO-2025-5678\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-002\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-20T05:00:00\\\",\\n \\\"externalAddressId\\\": \\\"200\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-20T06:00:00\\\",\\n \\\"name\\\": \\\"Assembly Hall\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"PROD-1234512\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"additionalCharges\\\": 50.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 195.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n },\\n {\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"productName\\\": \\\"Electronic Control Module\\\",\\n \\\"productDescription\\\": \\\"Advanced electronic control unit for automotive applications\\\",\\n \\\"productCategory\\\": \\\"Electronics\\\",\\n \\\"quantity\\\": 25,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 12.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 450.00,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 11250.00,\\n \\\"freightCost\\\": 75.00,\\n \\\"totalLandedCost\\\": 11325.00,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8537109900\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-5678\\\",\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"handlingUnitId\\\": \\\"BOX-002345\\\",\\n \\\"barcode\\\": \\\"234567890123\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"09876543210987\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-ECM-002\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-ECM-890\\\",\\n \\\"brandName\\\": \\\"TechControl\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-ECM-002345\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"47408\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\",\\n \\\"TRK-890123456\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"IN\\\",\\n \\\"stopReferenceId\\\": \\\"1529659852\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"trackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"unloadTimeInMinutes\\\": 150,\\n \\\"wantTime\\\": \\\"2026-07-21T13:00:00Z\\\"\\n }\\n ],\\n \\\"tags\\\": [\\n \\\"Tag1\\\",\\n \\\"Tag2\\\",\\n \\\"Tag3\\\"\\n ],\\n \\\"trackingInfo\\\": {\\n \\\"deviceId\\\": \\\"12356\\\",\\n \\\"driverId\\\": \\\"999\\\",\\n \\\"driverPhone\\\": \\\"+19999999999\\\",\\n \\\"mawb\\\": \\\"17233144555\\\",\\n \\\"trailerNumber\\\": \\\"123\\\",\\n \\\"truckNumber\\\": \\\"456\\\"\\n },\\n \\\"trackingNumber\\\": \\\"123456789\\\",\\n \\\"truckRoutingParams\\\": {\\n \\\"height\\\": \\\"4.145\\\",\\n \\\"length\\\": \\\"14.63\\\",\\n \\\"limitedWeight\\\": \\\"996\\\",\\n \\\"shippedHazardousGoods\\\": \\\"flammable\\\",\\n \\\"trailersCount\\\": 0,\\n \\\"truckType\\\": \\\"truck\\\",\\n \\\"tunnelCategory\\\": \\\"C\\\",\\n \\\"weightPerAxle\\\": \\\"498\\\",\\n \\\"width\\\": \\\"2.438\\\"\\n },\\n \\\"seal\\\": \\\"XYZ123\\\",\\n \\\"sealStatus\\\": \\\"XYZ123\\\"\\n }\\n}\", null, \"application/json\");\nrequest.Content = content;\nvar response = await client.SendAsync(request);\nresponse.EnsureSuccessStatusCode();\nConsole.WriteLine(await response.Content.ReadAsStringAsync());\n", "customLabel": "" }, { "id": "fh2kyGCeGBoH8iok802FY", "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.ng.fourkites.com/api/v1/tracking\"\n method := \"POST\"\n\n payload := strings.NewReader(`{\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410.00,\n \"extendedCost\": 1200.00,\n \"freightCost\": 45.50,\n \"additionalCost\": 23.20,\n \"tariffCost\": 85.00,\n \"landedCost\": 1353.70,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": null\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"additionalCharges\": 50.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450.00,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250.00,\n \"freightCost\": 75.00,\n \"totalLandedCost\": 11325.00,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n}`)\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": "g62VzmM0ca7QqYHmE8JPV", "language": "ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.ng.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 \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410,\n \"extendedCost\": 1200,\n \"freightCost\": 45.5,\n \"additionalCost\": 23.2,\n \"tariffCost\": 85,\n \"landedCost\": 1353.7,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": nil\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"additionalCharges\": 50,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250,\n \"freightCost\": 75,\n \"totalLandedCost\": 11325,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n})\n\nresponse = https.request(request)\nputs response.read_body\n", "customLabel": "" }, { "id": "2QDWbLPC4OWpgov8hWxjZ", "language": "python", "code": "import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.ng.fourkites.com\")\npayload = json.dumps({\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410,\n \"extendedCost\": 1200,\n \"freightCost\": 45.5,\n \"additionalCost\": 23.2,\n \"tariffCost\": 85,\n \"landedCost\": 1353.7,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": None\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": False,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": False,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": False,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"additionalCharges\": 50,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250,\n \"freightCost\": 75,\n \"totalLandedCost\": 11325,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n})\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": "2QDWbLPC4OWpgov8hWxjZ" }, "description": "\n", "currentNewParameter": { "label": "Body Parameter", "value": "bodyDataParameters" }, "hasTryItOut": false, "autoGeneratedAnchorSlug": "azure-production", "legacyHash": "xH_lz_5VuQFTqzgbBwDRs" } ``` ::: :::ApiMethodV2 ```json { "tab": "examples", "url": "https://api-staging.ng.fourkites.com/api/v1/tracking", "name": "Azure - Staging", "method": "POST", "request": { "pathParameters": [], "queryParameters": [], "headerParameters": [], "bodyDataParameters": [ { "name": "modeDetails", "kind": "optional", "type": "object", "description": "It contains the mode information about the load that we create.", "children": [ { "name": "shipperModes", "kind": "optional", "type": "string", "description": "It defines the mode of the load. Valid values: \"TL\", \"LTL\", \"RAIL\", \"OCEAN\", \"PARCEL\", \"AIR\"" }, { "name": "carrierModes", "kind": "optional", "type": "string", "description": "It defines the mode of the load. Valid values: \"TL\", \"LTL\", \"RAIL\", \"OCEAN\", \"PARCEL\", \"AIR" } ] }, { "name": "load", "kind": "required", "type": "object", "description": "It is the parent object for the load. Place the load attributes inside this object.", "children": [ { "name": "carrierPermalink", "kind": "optional", "type": "string", "description": "It is the unique identifier for the carrier in the FK platform." }, { "name": "carrierName", "kind": "optional", "type": "string", "description": "It is the name of the carrier in the FK platform." }, { "name": "carrier", "kind": "required", "type": "string", "description": "It is the 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": "shipperAccountNumber", "kind": "optional", "type": "string", "description": "The shipper's carrier account number, used to identify the shipper account associated with a shipment. Enables carrier integrations to retrieve account-gated data such as proof of delivery documents and signature images. " }, { "name": "haulType", "kind": "required", "type": "array", "description": "It indicates whether the load is an inbound or an outbound load. Valid values: \"inbound_load\", \"outbound_load\", \"short_haul\", \"round_trip\", \"brokered_load\", \"non-brokered_load\", \"inbound_load\", \"outbound_load\", travel_ban_warnings\"" }, { "name": "loadNumber", "kind": "required", "type": "string", "description": "It is the 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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the Ocean load." }, { "name": "bookingNumber", "kind": "optional", "type": "string", "description": "It indicates the shipping line's booking number" }, { "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": "masterSequenceNumber", "kind": "optional", "type": "string", "description": "It is the unique sequence number that represents the leg of the trip used for Consignment Pooling." }, { "name": "masterReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of consignment loads in order to group them. For example, consignmentReferenceNumber: “XAF-BATCH-1”. (Conditional Mandatory)" }, { "name": "simulaneousTrackingReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of simultaneous loads in order to group them. For example, simultaneousTrackingReferenceNumber: “E900018290”" }, { "name": "proNumber", "kind": "optional", "type": "string", "description": "This is a number that is created usually after pickup or at pickup for LTL loads. CM for LTL loads" }, { "name": "products", "kind": "optional", "type": "object", "description": "It indicates the list of temperature tracked products on a load and their temperature tracking information.", "children": [ { "name": "lowerTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the lower bound (in degrees Fahrenheit) of the acceptable temperature range for a product." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of a temperature tracked product." }, { "name": "productId", "kind": "optional", "type": "string", "description": "It indicates the FourKites - internal unique identifier for a temperature tracked product. This is a primary key and duplicates are not allowed. The value must already exist in FourKites®." }, { "name": "setTemperature", "kind": "optional", "type": "string", "description": "It indicates the target temperature at which the product is maintained." }, { "name": "timeToleranceInMinutes", "kind": "optional", "type": "string", "description": "It indicates the acceptable time (in minutes) for a product to maintain a temperature outside the defined temperature range. Exceeding this range for a period of time equal to or greater than this time tolerance will display a critical alert in the Temperature Tracking section of a load." }, { "name": "upperTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the upper bound (in degrees Fahrenheit) of the acceptable temperature range for a product." } ] }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It is the list of load-level reference numbers associated with a load. (CM)" }, { "name": "relayLoad", "kind": "optional", "type": "boolean", "description": "It indicates whether the load is relay or team load. \tValid values: true or false. Defaults to false. (CM)" }, { "name": "stops", "kind": "required", "type": "object", "description": "It is the list of stops for the load.", "children": [ { "name": "addressLine1", "kind": "required", "type": "string", "description": "It indicates the first line of the stop's address." }, { "name": "addressLine2", "kind": "optional", "type": "string", "description": "It indicates the second line of the stop's address." }, { "name": "city", "kind": "required", "type": "string", "description": "It indicates the name of the city. \tWhen we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now we have a restriction to pass state name when the stop doesn't have external AddressId and we match the port with only city & country." }, { "name": "country", "kind": "optional", "type": "string", "description": "It indicates the valid country code. It is the 2 digit country code. When we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now, we have a restriction to pass the state name when the stop doesn't have external AddressId and we want to match the port with only city & country." }, { "name": "customer", "kind": "optional", "type": "object", "description": "It indicates the customer information for the stop. (CM)", "children": [ { "name": "id", "kind": "optional", "type": "string", "description": "It is the unique identifier of the shipper's customer. The customer should have been created in FourKites before associating it to a load's stop. (CM)" }, { "name": "poNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of Customer PO Numbers associated with the load's stop. (CM)" }, { "name": "pointOfContact", "kind": "optional", "type": "object", "description": "It indicates the point of contact (POC) information at the stop, capturing name, email, phone number, and whether they should be alerted. You can send up to 5 POCs objects per stop.", "children": [ { "name": "alert", "kind": "optional", "type": "boolean", "description": "It indicates the flag to enable or disable email notifications to the point of contact." }, { "name": "email", "kind": "optional", "type": "string", "description": "It indicates the email address of the point of contact at the stop." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of the point of contact at the stop." }, { "name": "phone", "kind": "optional", "type": "string", "description": "It indicates the phone number of the point of contact at the stop. The ISD code followed by mobile number prepended with \"+\" and no special characters." } ] }, { "name": "customer", "kind": "optional", "type": "string", "description": "Name of the customer to automatically pull in customer record." }, { "name": "customerPoFields", "kind": "optional", "type": "object", "description": "This is a list (array) of objects containing purchase order-related details from the customer.", "children": [ { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Represents the delivery number or identifier associated with the purchase order." }, { "name": "deliveryReference", "kind": "optional", "type": "string", "description": "A reference code or identifier related to the delivery, possibly provided by the customer or logistics team." }, { "name": "orderReference", "kind": "optional", "type": "string", "description": "A unique reference for the order, used to track and manage the purchase order." } ] } ] }, { "name": "earliestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the earliest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the earliestAppointmentTime is sent, then the latestAppointmentTime must also be sent." }, { "name": "earliestWantTime", "kind": "optional", "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)" }, { "name": "externalAddressId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. UNLOCODE is preferred for port stop creation in the FK platform." }, { "name": "latestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the latest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestAppointmentTime is sent, then the earliestAppointmentTime must also be sent. latestAppointmentTime should be greater than or equal to earliestAppointmentTime." }, { "name": "latestWantTime", "kind": "optional", "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. ISO 8601 format. If the latestWantTime is sent, then the earliestWantTime must also be sent. (CM)" }, { "name": "name", "kind": "required", "type": "string", "description": "It is the name of the stop." }, { "name": "loadingType", "kind": "optional", "type": "string", "description": "Indicates whether the load or shipment is Live or Drop. Valid values : \"live\" or \"drop\"" }, { "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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the pallet record." }, { "name": "number", "kind": "optional", "type": "string", "description": "It indicates the pallet number." }, { "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’s part number." }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "It indicates the part's order 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": "It indicates the description given for the material within the pallet." } ] } ] }, { "name": "postalCode", "kind": "optional", "type": "string", "description": "It indicates the valid postal code for the stop." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of stop level reference numbers associated with the stop. These are searchable within the FourKites platform. (CM)" }, { "name": "sequence", "kind": "optional", "type": "string", "description": "It indicates the stop's sequence on a load. The lower value indicates earliest scheduled stop completion. If the stop sequence is present for one stop on a load, it must be present on all stops. It is recommended to start at 1 and increment by 1 for each additional stop. (CM)" }, { "name": "shipTo", "kind": "optional", "type": "string", "description": "It is the ship to location ID associated with the stop. The shipTo values associated with pickup stops can be filtered using the \"Ship From\" filter. (CM)" }, { "name": "state", "kind": "required", "type": "string", "description": "It indicates the 2 character state code for US & Canada and 3 Character state code for Mexico. It is the 2 character State Code for US & Canada and 3 Character State Code for Mexico." }, { "name": "stopReferenceId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the stop from the customer's system. This populates the \"Reference #\" field on the stop and is used to indicate which stop an update is applied to. (CM)" }, { "name": "stopType", "kind": "required", "type": "string", "description": "It defines the function of the stop. Valid values: \"pickup\", \"delivery\", \"transfer\", \"portOfLoading\", \"transshipmentPort\", \"portOfDischarge\". There should be at least one pickup and delivery stop or one transfer (terminal) and one delivery." }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. \tFor ocean loads, use the port's UNLOCODE." }, { "name": "unloadTimeInMinutes", "kind": "optional", "type": "string", "description": "It indicates the dwell time to be used for the stop in ETA calculations (in minutes). When it is not provided, the company level default value will be used, if available or 90 minutes. This value must be sent in minutes." }, { "name": "productLineItems", "kind": "optional", "type": "object", "description": "", "children": [ { "name": "productId", "kind": "required", "type": "string", "description": "Unique identifier for the product. Mandatory if productLineItems object is present" }, { "name": "productName", "kind": "optional", "type": "string", "description": "Display name of the product" }, { "name": "productDescription", "kind": "optional", "type": "string", "description": "Detailed description of the product" }, { "name": "productCategory", "kind": "optional", "type": "string", "description": "Category classification of the product" }, { "name": "quantity", "kind": "optional", "type": "integer", "description": "Number of units in the shipment" }, { "name": "measurementUnitCode", "kind": "optional", "type": "string", "description": "Unit of measurement for quantity (e.g., PCE, KG, LB)" }, { "name": "netWeight", "kind": "optional", "type": "number", "description": "Weight of the product excluding packaging" }, { "name": "weightUnit", "kind": "optional", "type": "string", "description": "Unit of measurement for weight (e.g., KGM, LBM)" }, { "name": "unitCost", "kind": "optional", "type": "number", "description": "Cost per unit of the product" }, { "name": "currencyCode", "kind": "optional", "type": "number", "description": "Currency code for cost fields" }, { "name": "extendedCost", "kind": "optional", "type": "number", "description": "Total cost for all units (unitCost × quantity)" }, { "name": "freightCost", "kind": "optional", "type": "number", "description": "Freight cost allocated to this line item" }, { "name": "bestBeforeDate", "kind": "optional", "type": "string", "description": "Expiration or best before date for the product" }, { "name": "additionalCharges", "kind": "optional", "type": "number", "description": "Any additional charges specific to this line item" }, { "name": "tariffCost", "kind": "optional", "type": "number", "description": "Tariff cost for this specific line item" }, { "name": "fourKitesCalculatedTariffCost", "kind": "optional", "type": "number", "description": "System-calculated tariff cost" }, { "name": "totalLandedCost", "kind": "optional", "type": "number", "description": "Total landed cost for this line item" }, { "name": "countryOfOrigin", "kind": "optional", "type": "string", "description": "Country of origin for this product" }, { "name": "harmonizedSystemCode", "kind": "optional", "type": "string", "description": "International trade classification code\n" }, { "name": "commodityTypeCode", "kind": "optional", "type": "string", "description": "Commodity classification code" }, { "name": "htsusCode", "kind": "optional", "type": "string", "description": "Harmonized Tariff Schedule code for US imports" }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "Purchase order number" }, { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Delivery reference number" }, { "name": "handlingUnitId", "kind": "optional", "type": "string", "description": "Identifier for the handling unit (pallet, box, etc.)" }, { "name": "barcode", "kind": "optional", "type": "string", "description": "Product barcode" }, { "name": "containerType", "kind": "optional", "type": "string", "description": "Type of container (pallet, box, carton, etc.)" }, { "name": "gtin", "kind": "optional", "type": "string", "description": "Global Trade Item Number" }, { "name": "customerPartNumber", "kind": "optional", "type": "string", "description": "Customer's part number for the product" }, { "name": "supplierPartNumber", "kind": "optional", "type": "string", "description": "Supplier's part number for the product" }, { "name": "manufacturerPartNumber", "kind": "optional", "type": "string", "description": "Manufacturer's part number" }, { "name": "itemNumber", "kind": "optional", "type": "string", "description": "Internal item number" }, { "name": "productUpc", "kind": "optional", "type": "string", "description": "Universal Product Code" }, { "name": "deliveryReferences", "kind": "optional", "type": "string", "description": "Array of delivery reference numbers" }, { "name": "orderReferences", "kind": "optional", "type": "string", "description": "Array of order reference numbers" }, { "name": "brandName", "kind": "optional", "type": "string", "description": "Brand name of the product" }, { "name": "minimumTemperature", "kind": "optional", "type": "integer", "description": "Minimum storage/transport temperature" }, { "name": "maximumTemperature", "kind": "optional", "type": "integer", "description": "Maximum storage/transport temperature" }, { "name": "temperatureUnitCode", "kind": "optional", "type": "string", "description": "Temperature unit (cel, fah)\n" }, { "name": "labelIdentifier", "kind": "optional", "type": "string", "description": "Label identifier for tracking" }, { "name": "productTrackingNumber", "kind": "optional", "type": "string", "description": "Unique tracking number for the product" }, { "name": "deviceType", "kind": "optional", "type": "string", "description": "Type of tracking device (RFID_TAG, QR_CODE, etc.)" } ] } ] }, { "name": "tags", "kind": "optional", "type": "array", "description": "It is the list of tags or labels to be assigned to a load. Loads can be filtered in FourKites using tags. It is used for assigning categories for the load. A single tag can't exceed 50 characters. Even though we don’t have restrictions on the number of tags, it is advisable to keep total characters of all tags within the count of 255. (CM)" }, { "name": "trackingInfo", "kind": "optional", "type": "object", "description": "It indicates the information required for tracking the load.", "children": [ { "name": "deviceId", "kind": "optional", "type": "string", "description": "It indicates the ID of the GPS puck attached to the pallet or the trailer." }, { "name": "driverId", "kind": "optional", "type": "string", "description": "It indicates the driver ID used for CarrierLink access for private fleet owners. The driver ID is used by drivers of private fleet owners to log into CarrierLink and see the loads assigned to them. There should be an existing driver user in the platform with the same driver ID." }, { "name": "driverPhone", "kind": "optional", "type": "string", "description": "It indicates a valid mobile number. Example: +13125555555. \tThe ISD code followed by mobile number prepended with \"+\" and no special characters." }, { "name": "mawb", "kind": "optional", "type": "string", "description": "The carrier’s air waybill issued to cover a consolidated shipment tendered by a forwarder or consolidator." }, { "name": "trailerNumber", "kind": "optional", "type": "string", "description": "It indicates the trailer number assigned to the load." }, { "name": "truckNumber", "kind": "optional", "type": "string", "description": "It indicates the tractor or asset number dispatched by the carrier for the load." } ] }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is for parcel tracking only; any tracking number provided by the carrier or other entities." }, { "name": "truckRoutingParams", "kind": "optional", "type": "object", "description": "It indicates the information required for getting truck specific routing. If provided, the routing of the truck and ETA calculations will be done based on these parameters.", "children": [ { "name": "height", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s height in meters. Valid values: Between 0 and 50." }, { "name": "length", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s length in meters. Valid values: Between 0 and 300." }, { "name": "limitedWeight", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight including trailers and shipped goods in tons. Valid values: Between 0 and 1000." }, { "name": "shippedHazardousGoods", "kind": "optional", "type": "string", "description": "It indicates the list of hazaradous materials in the vehicle. Enum [explosive , gas , flammable , organic , combustible , poison , radioActive , corrosive , poisonousInhalation , harmfulToWater , other]. Valid values: \"explosive\", \"gas\", \"flammable\", \"organic\", \"combustible\", \"poison\", \"radioActive\", \"corrosive\", \"poisonousInhalation\", \"harmfulToWater\", \"other\".\n\n" }, { "name": "trailersCount", "kind": "optional", "type": "string", "description": "It specifies the number of trailers pulled by a vehicle. Valid values: 0, 1, 2, 3,4. Defaults to 0." }, { "name": "truckType", "kind": "optional", "type": "string", "description": "It specifies the vehicle type. It defaults to truck. Enum [truck , tractorTruck]. \tValid values: \"truck\" or \"tractorTruck\"." }, { "name": "tunnelCategory", "kind": "optional", "type": "string", "description": "It specifies the tunnel category to restrict certain routes. The route will pass only through tunnels of a less strict category. Enum [B , C , D , E]. \tValid values: \"B\", \"C\", \"D\", \"E\"" }, { "name": "weightPerAxle", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight per axle in tons. Valid values: Between 0 and 1000." }, { "name": "width", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s width in meters. Valid values: Between 0 and 50." } ] }, { "name": "seal", "kind": "optional", "type": "string", "description": "It is the seal number that identifies the seal on the load." }, { "name": "sealStatus", "kind": "optional", "type": "string", "description": "It is the seal status that represents the status of the seal on the load." }, { "name": "simultaneousTrackingSequenceNumber", "kind": "optional", "type": "number", "description": "This parameter will allow Shippers and Carriers to provide the sequence number to order the delivery sequence to calculate better ETAs. \n\nThe earlier logic would consider either the shortest distance or the Appointment time to sequence the stops for ETA calculation.\n\nThe new logic will look like this:\n- If the Simultaneous tracking Sequence number is provided, this will be given the first priority.\n- If not, then use the existing logic." }, { "name": "deliveryNumbers", "kind": "optional", "type": "string", "description": "Array of strings supporting multiple delivery references per shipment (typically comma separated). Same as delivery numbers on deliveries in an order." }, { "name": "masterTrackingNumber", "kind": "optional", "type": "string", "description": "Single string field for shipment relationship tracking. This is primarily to indicate the master tracking number for split parcels." } ], "schema": [ { "name": "carrierPermalink", "kind": "optional", "type": "string", "description": "It is the unique identifier for the carrier in the FK platform." }, { "name": "carrierName", "kind": "optional", "type": "string", "description": "It is the name of the carrier in the FK platform." }, { "name": "carrier", "kind": "required", "type": "string", "description": "It is the 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": "shipperAccountNumber", "kind": "optional", "type": "string", "description": "The shipper's carrier account number, used to identify the shipper account associated with a shipment. Enables carrier integrations to retrieve account-gated data such as proof of delivery documents and signature images. " }, { "name": "haulType", "kind": "required", "type": "array", "description": "It indicates whether the load is an inbound or an outbound load. Valid values: \"inbound_load\", \"outbound_load\", \"short_haul\", \"round_trip\", \"brokered_load\", \"non-brokered_load\", \"inbound_load\", \"outbound_load\", travel_ban_warnings\"" }, { "name": "loadNumber", "kind": "required", "type": "string", "description": "It is the 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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the Ocean load." }, { "name": "bookingNumber", "kind": "optional", "type": "string", "description": "It indicates the shipping line's booking number" }, { "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": "masterSequenceNumber", "kind": "optional", "type": "string", "description": "It is the unique sequence number that represents the leg of the trip used for Consignment Pooling." }, { "name": "masterReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of consignment loads in order to group them. For example, consignmentReferenceNumber: “XAF-BATCH-1”. (Conditional Mandatory)" }, { "name": "simulaneousTrackingReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of simultaneous loads in order to group them. For example, simultaneousTrackingReferenceNumber: “E900018290”" }, { "name": "proNumber", "kind": "optional", "type": "string", "description": "This is a number that is created usually after pickup or at pickup for LTL loads. CM for LTL loads" }, { "name": "products", "kind": "optional", "type": "object", "description": "It indicates the list of temperature tracked products on a load and their temperature tracking information.", "children": [ { "name": "lowerTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the lower bound (in degrees Fahrenheit) of the acceptable temperature range for a product." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of a temperature tracked product." }, { "name": "productId", "kind": "optional", "type": "string", "description": "It indicates the FourKites - internal unique identifier for a temperature tracked product. This is a primary key and duplicates are not allowed. The value must already exist in FourKites®." }, { "name": "setTemperature", "kind": "optional", "type": "string", "description": "It indicates the target temperature at which the product is maintained." }, { "name": "timeToleranceInMinutes", "kind": "optional", "type": "string", "description": "It indicates the acceptable time (in minutes) for a product to maintain a temperature outside the defined temperature range. Exceeding this range for a period of time equal to or greater than this time tolerance will display a critical alert in the Temperature Tracking section of a load." }, { "name": "upperTemperatureThreshold", "kind": "optional", "type": "string", "description": "It indicates the upper bound (in degrees Fahrenheit) of the acceptable temperature range for a product." } ] }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It is the list of load-level reference numbers associated with a load. (CM)" }, { "name": "relayLoad", "kind": "optional", "type": "boolean", "description": "It indicates whether the load is relay or team load. \tValid values: true or false. Defaults to false. (CM)" }, { "name": "stops", "kind": "required", "type": "object", "description": "It is the list of stops for the load.", "children": [ { "name": "addressLine1", "kind": "required", "type": "string", "description": "It indicates the first line of the stop's address." }, { "name": "addressLine2", "kind": "optional", "type": "string", "description": "It indicates the second line of the stop's address." }, { "name": "city", "kind": "required", "type": "string", "description": "It indicates the name of the city. \tWhen we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now we have a restriction to pass state name when the stop doesn't have external AddressId and we match the port with only city & country." }, { "name": "country", "kind": "optional", "type": "string", "description": "It indicates the valid country code. It is the 2 digit country code. When we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now, we have a restriction to pass the state name when the stop doesn't have external AddressId and we want to match the port with only city & country." }, { "name": "customer", "kind": "optional", "type": "object", "description": "It indicates the customer information for the stop. (CM)", "children": [ { "name": "id", "kind": "optional", "type": "string", "description": "It is the unique identifier of the shipper's customer. The customer should have been created in FourKites before associating it to a load's stop. (CM)" }, { "name": "poNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of Customer PO Numbers associated with the load's stop. (CM)" }, { "name": "pointOfContact", "kind": "optional", "type": "object", "description": "It indicates the point of contact (POC) information at the stop, capturing name, email, phone number, and whether they should be alerted. You can send up to 5 POCs objects per stop.", "children": [ { "name": "alert", "kind": "optional", "type": "boolean", "description": "It indicates the flag to enable or disable email notifications to the point of contact." }, { "name": "email", "kind": "optional", "type": "string", "description": "It indicates the email address of the point of contact at the stop." }, { "name": "name", "kind": "optional", "type": "string", "description": "It indicates the name of the point of contact at the stop." }, { "name": "phone", "kind": "optional", "type": "string", "description": "It indicates the phone number of the point of contact at the stop. The ISD code followed by mobile number prepended with \"+\" and no special characters." } ] }, { "name": "customer", "kind": "optional", "type": "string", "description": "Name of the customer to automatically pull in customer record." }, { "name": "customerPoFields", "kind": "optional", "type": "object", "description": "This is a list (array) of objects containing purchase order-related details from the customer.", "children": [ { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Represents the delivery number or identifier associated with the purchase order." }, { "name": "deliveryReference", "kind": "optional", "type": "string", "description": "A reference code or identifier related to the delivery, possibly provided by the customer or logistics team." }, { "name": "orderReference", "kind": "optional", "type": "string", "description": "A unique reference for the order, used to track and manage the purchase order." } ] } ] }, { "name": "earliestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the earliest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the earliestAppointmentTime is sent, then the latestAppointmentTime must also be sent." }, { "name": "earliestWantTime", "kind": "optional", "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)" }, { "name": "externalAddressId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. UNLOCODE is preferred for port stop creation in the FK platform." }, { "name": "latestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the latest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestAppointmentTime is sent, then the earliestAppointmentTime must also be sent. latestAppointmentTime should be greater than or equal to earliestAppointmentTime." }, { "name": "latestWantTime", "kind": "optional", "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. ISO 8601 format. If the latestWantTime is sent, then the earliestWantTime must also be sent. (CM)" }, { "name": "name", "kind": "required", "type": "string", "description": "It is the name of the stop." }, { "name": "loadingType", "kind": "optional", "type": "string", "description": "Indicates whether the load or shipment is Live or Drop. Valid values : \"live\" or \"drop\"" }, { "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": "billOfLading", "kind": "optional", "type": "string", "description": "It indicates the bill of lading associated with the pallet record." }, { "name": "number", "kind": "optional", "type": "string", "description": "It indicates the pallet number." }, { "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’s part number." }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "It indicates the part's order 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": "It indicates the description given for the material within the pallet." } ] } ] }, { "name": "postalCode", "kind": "optional", "type": "string", "description": "It indicates the valid postal code for the stop." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of stop level reference numbers associated with the stop. These are searchable within the FourKites platform. (CM)" }, { "name": "sequence", "kind": "optional", "type": "string", "description": "It indicates the stop's sequence on a load. The lower value indicates earliest scheduled stop completion. If the stop sequence is present for one stop on a load, it must be present on all stops. It is recommended to start at 1 and increment by 1 for each additional stop. (CM)" }, { "name": "shipTo", "kind": "optional", "type": "string", "description": "It is the ship to location ID associated with the stop. The shipTo values associated with pickup stops can be filtered using the \"Ship From\" filter. (CM)" }, { "name": "state", "kind": "required", "type": "string", "description": "It indicates the 2 character state code for US & Canada and 3 Character state code for Mexico. It is the 2 character State Code for US & Canada and 3 Character State Code for Mexico." }, { "name": "stopReferenceId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the stop from the customer's system. This populates the \"Reference #\" field on the stop and is used to indicate which stop an update is applied to. (CM)" }, { "name": "stopType", "kind": "required", "type": "string", "description": "It defines the function of the stop. Valid values: \"pickup\", \"delivery\", \"transfer\", \"portOfLoading\", \"transshipmentPort\", \"portOfDischarge\". There should be at least one pickup and delivery stop or one transfer (terminal) and one delivery." }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is the unique identifier of the address in FourKites. This ID is sent in place of address information. \tFor ocean loads, use the port's UNLOCODE." }, { "name": "unloadTimeInMinutes", "kind": "optional", "type": "string", "description": "It indicates the dwell time to be used for the stop in ETA calculations (in minutes). When it is not provided, the company level default value will be used, if available or 90 minutes. This value must be sent in minutes." }, { "name": "productLineItems", "kind": "optional", "type": "object", "description": "", "children": [ { "name": "productId", "kind": "required", "type": "string", "description": "Unique identifier for the product. Mandatory if productLineItems object is present" }, { "name": "productName", "kind": "optional", "type": "string", "description": "Display name of the product" }, { "name": "productDescription", "kind": "optional", "type": "string", "description": "Detailed description of the product" }, { "name": "productCategory", "kind": "optional", "type": "string", "description": "Category classification of the product" }, { "name": "quantity", "kind": "optional", "type": "integer", "description": "Number of units in the shipment" }, { "name": "measurementUnitCode", "kind": "optional", "type": "string", "description": "Unit of measurement for quantity (e.g., PCE, KG, LB)" }, { "name": "netWeight", "kind": "optional", "type": "number", "description": "Weight of the product excluding packaging" }, { "name": "weightUnit", "kind": "optional", "type": "string", "description": "Unit of measurement for weight (e.g., KGM, LBM)" }, { "name": "unitCost", "kind": "optional", "type": "number", "description": "Cost per unit of the product" }, { "name": "currencyCode", "kind": "optional", "type": "number", "description": "Currency code for cost fields" }, { "name": "extendedCost", "kind": "optional", "type": "number", "description": "Total cost for all units (unitCost × quantity)" }, { "name": "freightCost", "kind": "optional", "type": "number", "description": "Freight cost allocated to this line item" }, { "name": "bestBeforeDate", "kind": "optional", "type": "string", "description": "Expiration or best before date for the product" }, { "name": "additionalCharges", "kind": "optional", "type": "number", "description": "Any additional charges specific to this line item" }, { "name": "tariffCost", "kind": "optional", "type": "number", "description": "Tariff cost for this specific line item" }, { "name": "fourKitesCalculatedTariffCost", "kind": "optional", "type": "number", "description": "System-calculated tariff cost" }, { "name": "totalLandedCost", "kind": "optional", "type": "number", "description": "Total landed cost for this line item" }, { "name": "countryOfOrigin", "kind": "optional", "type": "string", "description": "Country of origin for this product" }, { "name": "harmonizedSystemCode", "kind": "optional", "type": "string", "description": "International trade classification code\n" }, { "name": "commodityTypeCode", "kind": "optional", "type": "string", "description": "Commodity classification code" }, { "name": "htsusCode", "kind": "optional", "type": "string", "description": "Harmonized Tariff Schedule code for US imports" }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "Purchase order number" }, { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Delivery reference number" }, { "name": "handlingUnitId", "kind": "optional", "type": "string", "description": "Identifier for the handling unit (pallet, box, etc.)" }, { "name": "barcode", "kind": "optional", "type": "string", "description": "Product barcode" }, { "name": "containerType", "kind": "optional", "type": "string", "description": "Type of container (pallet, box, carton, etc.)" }, { "name": "gtin", "kind": "optional", "type": "string", "description": "Global Trade Item Number" }, { "name": "customerPartNumber", "kind": "optional", "type": "string", "description": "Customer's part number for the product" }, { "name": "supplierPartNumber", "kind": "optional", "type": "string", "description": "Supplier's part number for the product" }, { "name": "manufacturerPartNumber", "kind": "optional", "type": "string", "description": "Manufacturer's part number" }, { "name": "itemNumber", "kind": "optional", "type": "string", "description": "Internal item number" }, { "name": "productUpc", "kind": "optional", "type": "string", "description": "Universal Product Code" }, { "name": "deliveryReferences", "kind": "optional", "type": "string", "description": "Array of delivery reference numbers" }, { "name": "orderReferences", "kind": "optional", "type": "string", "description": "Array of order reference numbers" }, { "name": "brandName", "kind": "optional", "type": "string", "description": "Brand name of the product" }, { "name": "minimumTemperature", "kind": "optional", "type": "integer", "description": "Minimum storage/transport temperature" }, { "name": "maximumTemperature", "kind": "optional", "type": "integer", "description": "Maximum storage/transport temperature" }, { "name": "temperatureUnitCode", "kind": "optional", "type": "string", "description": "Temperature unit (cel, fah)\n" }, { "name": "labelIdentifier", "kind": "optional", "type": "string", "description": "Label identifier for tracking" }, { "name": "productTrackingNumber", "kind": "optional", "type": "string", "description": "Unique tracking number for the product" }, { "name": "deviceType", "kind": "optional", "type": "string", "description": "Type of tracking device (RFID_TAG, QR_CODE, etc.)" } ] } ] }, { "name": "tags", "kind": "optional", "type": "array", "description": "It is the list of tags or labels to be assigned to a load. Loads can be filtered in FourKites using tags. It is used for assigning categories for the load. A single tag can't exceed 50 characters. Even though we don’t have restrictions on the number of tags, it is advisable to keep total characters of all tags within the count of 255. (CM)" }, { "name": "trackingInfo", "kind": "optional", "type": "object", "description": "It indicates the information required for tracking the load.", "children": [ { "name": "deviceId", "kind": "optional", "type": "string", "description": "It indicates the ID of the GPS puck attached to the pallet or the trailer." }, { "name": "driverId", "kind": "optional", "type": "string", "description": "It indicates the driver ID used for CarrierLink access for private fleet owners. The driver ID is used by drivers of private fleet owners to log into CarrierLink and see the loads assigned to them. There should be an existing driver user in the platform with the same driver ID." }, { "name": "driverPhone", "kind": "optional", "type": "string", "description": "It indicates a valid mobile number. Example: +13125555555. \tThe ISD code followed by mobile number prepended with \"+\" and no special characters." }, { "name": "mawb", "kind": "optional", "type": "string", "description": "The carrier’s air waybill issued to cover a consolidated shipment tendered by a forwarder or consolidator." }, { "name": "trailerNumber", "kind": "optional", "type": "string", "description": "It indicates the trailer number assigned to the load." }, { "name": "truckNumber", "kind": "optional", "type": "string", "description": "It indicates the tractor or asset number dispatched by the carrier for the load." } ] }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It is for parcel tracking only; any tracking number provided by the carrier or other entities." }, { "name": "truckRoutingParams", "kind": "optional", "type": "object", "description": "It indicates the information required for getting truck specific routing. If provided, the routing of the truck and ETA calculations will be done based on these parameters.", "children": [ { "name": "height", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s height in meters. Valid values: Between 0 and 50." }, { "name": "length", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s length in meters. Valid values: Between 0 and 300." }, { "name": "limitedWeight", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight including trailers and shipped goods in tons. Valid values: Between 0 and 1000." }, { "name": "shippedHazardousGoods", "kind": "optional", "type": "string", "description": "It indicates the list of hazaradous materials in the vehicle. Enum [explosive , gas , flammable , organic , combustible , poison , radioActive , corrosive , poisonousInhalation , harmfulToWater , other]. Valid values: \"explosive\", \"gas\", \"flammable\", \"organic\", \"combustible\", \"poison\", \"radioActive\", \"corrosive\", \"poisonousInhalation\", \"harmfulToWater\", \"other\".\n\n" }, { "name": "trailersCount", "kind": "optional", "type": "string", "description": "It specifies the number of trailers pulled by a vehicle. Valid values: 0, 1, 2, 3,4. Defaults to 0." }, { "name": "truckType", "kind": "optional", "type": "string", "description": "It specifies the vehicle type. It defaults to truck. Enum [truck , tractorTruck]. \tValid values: \"truck\" or \"tractorTruck\"." }, { "name": "tunnelCategory", "kind": "optional", "type": "string", "description": "It specifies the tunnel category to restrict certain routes. The route will pass only through tunnels of a less strict category. Enum [B , C , D , E]. \tValid values: \"B\", \"C\", \"D\", \"E\"" }, { "name": "weightPerAxle", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s weight per axle in tons. Valid values: Between 0 and 1000." }, { "name": "width", "kind": "optional", "type": "string", "description": "It indicates the vehicle’s width in meters. Valid values: Between 0 and 50." } ] }, { "name": "seal", "kind": "optional", "type": "string", "description": "It is the seal number that identifies the seal on the load." }, { "name": "sealStatus", "kind": "optional", "type": "string", "description": "It is the seal status that represents the status of the seal on the load." }, { "name": "simultaneousTrackingSequenceNumber", "kind": "optional", "type": "number", "description": "This parameter will allow Shippers and Carriers to provide the sequence number to order the delivery sequence to calculate better ETAs. \n\nThe earlier logic would consider either the shortest distance or the Appointment time to sequence the stops for ETA calculation.\n\nThe new logic will look like this:\n- If the Simultaneous tracking Sequence number is provided, this will be given the first priority.\n- If not, then use the existing logic." }, { "name": "deliveryNumbers", "kind": "optional", "type": "string", "description": "Array of strings supporting multiple delivery references per shipment (typically comma separated). Same as delivery numbers on deliveries in an order." }, { "name": "masterTrackingNumber", "kind": "optional", "type": "string", "description": "Single string field for shipment relationship tracking. This is primarily to indicate the master tracking number for split parcels." } ] } ], "formDataParameters": [] }, "results": { "languages": [ { "id": "vJmaUlHjeNh6wzQ_MfCsY", "code": "{\n \"loadId\": 1000,\n \"message\": \"Load created successfully\",\n \"statusCode\": 200\n}", "language": "200", "customLabel": "" } ], "selectedLanguageId": "vJmaUlHjeNh6wzQ_MfCsY" }, "examples": { "languages": [ { "id": "sa6A_WxCAcH7ovUgPbe2U", "language": "curl", "code": "curl --location 'https://api-staging.ng.fourkites.com/api/v1/tracking' \\\n--header 'Content-Type: application/json' \\\n--header 'apikey: REPLACE_KEY_VALUE' \\\n--data-raw '{\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410.00,\n \"extendedCost\": 1200.00,\n \"freightCost\": 45.50,\n \"additionalCost\": 23.20,\n \"tariffCost\": 85.00,\n \"landedCost\": 1353.70,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": null\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"additionalCharges\": 50.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450.00,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250.00,\n \"freightCost\": 75.00,\n \"totalLandedCost\": 11325.00,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n}'", "customLabel": "" }, { "id": "VRLMi8z6qihm0hVjDQgma", "language": "java", "code": "OkHttpClient client = new OkHttpClient().newBuilder()\n .build();\nMediaType mediaType = MediaType.parse(\"application/json\");\nRequestBody body = RequestBody.create(mediaType, \"{\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"TL\\\",\\n \\\"carrierModes\\\": \\\"\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrierPermalink\\\": \\\"insights-carrier-6870\\\",\\n \\\"carrierName\\\": \\\"Insights Carrier\\\",\\n \\\"carrier\\\": \\\"IC68\\\",\\n \\\"shipperAccountNumber\\\": \\\"tXXXXX234\\\",\\n \\\"haulType\\\": [\\n \\\"inbound_load\\\"\\n ],\\n \\\"loadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"displayLoadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"billOfLading\\\": \\\"billOfLading\\\",\\n \\\"bookingNumber\\\": \\\"bookingNumber\\\",\\n \\\"priority\\\": \\\"high\\\",\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"proNumber\\\": \\\"991\\\",\\n \\\"cost\\\": {\\n \\\"productCost\\\": 410.00,\\n \\\"extendedCost\\\": 1200.00,\\n \\\"freightCost\\\": 45.50,\\n \\\"additionalCost\\\": 23.20,\\n \\\"tariffCost\\\": 85.00,\\n \\\"landedCost\\\": 1353.70,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fourkitesCalculatedTariffCost\\\": null\\n },\\n \\\"products\\\": [\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n },\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Electronic Control Module\\\",\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n }\\n ],\\n \\\"referenceNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"DN-789012\\\",\\n \\\"PO-2025-5678\\\",\\n \\\"DN-345678\\\"\\n ],\\n \\\"deliveryNumbers\\\": \\\"DN-789012, DN-345678\\\",\\n \\\"masterTrackingNumber\\\": \\\"MASTER01\\\",\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"stopId\\\": \\\"1529659839\\\",\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Floor 33\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-001\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"earliestWantTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"externalAddressId\\\": \\\"100\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"latestWantTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"loadingType\\\": \\\"drop\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"bestBeforeDate\\\": \\\"2025-07-15T08:10:00Z\\\",\\n \\\"additionalCharges\\\": 500.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 1951.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"shipTo\\\": \\\"1234\\\",\\n \\\"state\\\": \\\"IL\\\",\\n \\\"stopReferenceId\\\": \\\"1529659839\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"trackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"unloadTimeInMinutes\\\": 120\\n },\\n {\\n \\\"stopId\\\": \\\"1529659852\\\",\\n \\\"addressLine1\\\": \\\"1001 E 17th Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Bloomington\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"PO-2025-5678\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-002\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-20T05:00:00\\\",\\n \\\"externalAddressId\\\": \\\"200\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-20T06:00:00\\\",\\n \\\"name\\\": \\\"Assembly Hall\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"PROD-1234512\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"additionalCharges\\\": 50.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 195.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n },\\n {\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"productName\\\": \\\"Electronic Control Module\\\",\\n \\\"productDescription\\\": \\\"Advanced electronic control unit for automotive applications\\\",\\n \\\"productCategory\\\": \\\"Electronics\\\",\\n \\\"quantity\\\": 25,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 12.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 450.00,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 11250.00,\\n \\\"freightCost\\\": 75.00,\\n \\\"totalLandedCost\\\": 11325.00,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8537109900\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-5678\\\",\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"handlingUnitId\\\": \\\"BOX-002345\\\",\\n \\\"barcode\\\": \\\"234567890123\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"09876543210987\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-ECM-002\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-ECM-890\\\",\\n \\\"brandName\\\": \\\"TechControl\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-ECM-002345\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"47408\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\",\\n \\\"TRK-890123456\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"IN\\\",\\n \\\"stopReferenceId\\\": \\\"1529659852\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"trackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"unloadTimeInMinutes\\\": 150,\\n \\\"wantTime\\\": \\\"2026-07-21T13:00:00Z\\\"\\n }\\n ],\\n \\\"tags\\\": [\\n \\\"Tag1\\\",\\n \\\"Tag2\\\",\\n \\\"Tag3\\\"\\n ],\\n \\\"trackingInfo\\\": {\\n \\\"deviceId\\\": \\\"12356\\\",\\n \\\"driverId\\\": \\\"999\\\",\\n \\\"driverPhone\\\": \\\"+19999999999\\\",\\n \\\"mawb\\\": \\\"17233144555\\\",\\n \\\"trailerNumber\\\": \\\"123\\\",\\n \\\"truckNumber\\\": \\\"456\\\"\\n },\\n \\\"trackingNumber\\\": \\\"123456789\\\",\\n \\\"truckRoutingParams\\\": {\\n \\\"height\\\": \\\"4.145\\\",\\n \\\"length\\\": \\\"14.63\\\",\\n \\\"limitedWeight\\\": \\\"996\\\",\\n \\\"shippedHazardousGoods\\\": \\\"flammable\\\",\\n \\\"trailersCount\\\": 0,\\n \\\"truckType\\\": \\\"truck\\\",\\n \\\"tunnelCategory\\\": \\\"C\\\",\\n \\\"weightPerAxle\\\": \\\"498\\\",\\n \\\"width\\\": \\\"2.438\\\"\\n },\\n \\\"seal\\\": \\\"XYZ123\\\",\\n \\\"sealStatus\\\": \\\"XYZ123\\\"\\n }\\n}\");\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": "y0P2cjJPDcugW4iYQlOsy", "language": "javascript", "code": "var settings = {\n \"url\": \"https://api-staging.ng.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 \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410,\n \"extendedCost\": 1200,\n \"freightCost\": 45.5,\n \"additionalCost\": 23.2,\n \"tariffCost\": 85,\n \"landedCost\": 1353.7,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": null\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"additionalCharges\": 50,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250,\n \"freightCost\": 75,\n \"totalLandedCost\": 11325,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n }),\n};\n\n$.ajax(settings).done(function (response) {\n console.log(response);\n});", "customLabel": "" }, { "id": "cKuiD8kkjyiesLasUeiQ2", "language": "swift", "code": "let parameters = \"{\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"TL\\\",\\n \\\"carrierModes\\\": \\\"\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrierPermalink\\\": \\\"insights-carrier-6870\\\",\\n \\\"carrierName\\\": \\\"Insights Carrier\\\",\\n \\\"carrier\\\": \\\"IC68\\\",\\n \\\"shipperAccountNumber\\\": \\\"tXXXXX234\\\",\\n \\\"haulType\\\": [\\n \\\"inbound_load\\\"\\n ],\\n \\\"loadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"displayLoadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"billOfLading\\\": \\\"billOfLading\\\",\\n \\\"bookingNumber\\\": \\\"bookingNumber\\\",\\n \\\"priority\\\": \\\"high\\\",\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"proNumber\\\": \\\"991\\\",\\n \\\"cost\\\": {\\n \\\"productCost\\\": 410.00,\\n \\\"extendedCost\\\": 1200.00,\\n \\\"freightCost\\\": 45.50,\\n \\\"additionalCost\\\": 23.20,\\n \\\"tariffCost\\\": 85.00,\\n \\\"landedCost\\\": 1353.70,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fourkitesCalculatedTariffCost\\\": null\\n },\\n \\\"products\\\": [\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n },\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Electronic Control Module\\\",\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n }\\n ],\\n \\\"referenceNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"DN-789012\\\",\\n \\\"PO-2025-5678\\\",\\n \\\"DN-345678\\\"\\n ],\\n \\\"deliveryNumbers\\\": \\\"DN-789012, DN-345678\\\",\\n \\\"masterTrackingNumber\\\": \\\"MASTER01\\\",\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"stopId\\\": \\\"1529659839\\\",\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Floor 33\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-001\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"earliestWantTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"externalAddressId\\\": \\\"100\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"latestWantTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"loadingType\\\": \\\"drop\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"bestBeforeDate\\\": \\\"2025-07-15T08:10:00Z\\\",\\n \\\"additionalCharges\\\": 500.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 1951.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"shipTo\\\": \\\"1234\\\",\\n \\\"state\\\": \\\"IL\\\",\\n \\\"stopReferenceId\\\": \\\"1529659839\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"trackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"unloadTimeInMinutes\\\": 120\\n },\\n {\\n \\\"stopId\\\": \\\"1529659852\\\",\\n \\\"addressLine1\\\": \\\"1001 E 17th Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Bloomington\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"PO-2025-5678\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-002\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-20T05:00:00\\\",\\n \\\"externalAddressId\\\": \\\"200\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-20T06:00:00\\\",\\n \\\"name\\\": \\\"Assembly Hall\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"PROD-1234512\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"additionalCharges\\\": 50.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 195.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n },\\n {\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"productName\\\": \\\"Electronic Control Module\\\",\\n \\\"productDescription\\\": \\\"Advanced electronic control unit for automotive applications\\\",\\n \\\"productCategory\\\": \\\"Electronics\\\",\\n \\\"quantity\\\": 25,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 12.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 450.00,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 11250.00,\\n \\\"freightCost\\\": 75.00,\\n \\\"totalLandedCost\\\": 11325.00,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8537109900\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-5678\\\",\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"handlingUnitId\\\": \\\"BOX-002345\\\",\\n \\\"barcode\\\": \\\"234567890123\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"09876543210987\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-ECM-002\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-ECM-890\\\",\\n \\\"brandName\\\": \\\"TechControl\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-ECM-002345\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"47408\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\",\\n \\\"TRK-890123456\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"IN\\\",\\n \\\"stopReferenceId\\\": \\\"1529659852\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"trackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"unloadTimeInMinutes\\\": 150,\\n \\\"wantTime\\\": \\\"2026-07-21T13:00:00Z\\\"\\n }\\n ],\\n \\\"tags\\\": [\\n \\\"Tag1\\\",\\n \\\"Tag2\\\",\\n \\\"Tag3\\\"\\n ],\\n \\\"trackingInfo\\\": {\\n \\\"deviceId\\\": \\\"12356\\\",\\n \\\"driverId\\\": \\\"999\\\",\\n \\\"driverPhone\\\": \\\"+19999999999\\\",\\n \\\"mawb\\\": \\\"17233144555\\\",\\n \\\"trailerNumber\\\": \\\"123\\\",\\n \\\"truckNumber\\\": \\\"456\\\"\\n },\\n \\\"trackingNumber\\\": \\\"123456789\\\",\\n \\\"truckRoutingParams\\\": {\\n \\\"height\\\": \\\"4.145\\\",\\n \\\"length\\\": \\\"14.63\\\",\\n \\\"limitedWeight\\\": \\\"996\\\",\\n \\\"shippedHazardousGoods\\\": \\\"flammable\\\",\\n \\\"trailersCount\\\": 0,\\n \\\"truckType\\\": \\\"truck\\\",\\n \\\"tunnelCategory\\\": \\\"C\\\",\\n \\\"weightPerAxle\\\": \\\"498\\\",\\n \\\"width\\\": \\\"2.438\\\"\\n },\\n \\\"seal\\\": \\\"XYZ123\\\",\\n \\\"sealStatus\\\": \\\"XYZ123\\\"\\n }\\n}\"\nlet postData = parameters.data(using: .utf8)\n\nvar request = URLRequest(url: URL(string: \"https://api-staging.ng.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 return\n }\n print(String(data: data, encoding: .utf8)!)\n}\n\ntask.resume()\n", "customLabel": "" }, { "id": "5dJrjshFeSBU8y2rBAs-E", "language": "csharp", "code": "var client = new HttpClient();\nvar request = new HttpRequestMessage(HttpMethod.Post, \"https://api.fourkites.com/api/v1/tracking\");\nrequest.Headers.Add(\"apikey\", \"REPLACE_KEY_VALUE\");\nvar content = new StringContent(\"{\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"TL\\\",\\n \\\"carrierModes\\\": \\\"\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrierPermalink\\\": \\\"insights-carrier-6870\\\",\\n \\\"carrierName\\\": \\\"Insights Carrier\\\",\\n \\\"carrier\\\": \\\"IC68\\\",\\n \\\"shipperAccountNumber\\\": \\\"tXXXXX234\\\",\\n \\\"haulType\\\": [\\n \\\"inbound_load\\\"\\n ],\\n \\\"loadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"displayLoadNumber\\\": \\\"KDPKDLTEST09\\\",\\n \\\"billOfLading\\\": \\\"billOfLading\\\",\\n \\\"bookingNumber\\\": \\\"bookingNumber\\\",\\n \\\"priority\\\": \\\"high\\\",\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"proNumber\\\": \\\"991\\\",\\n \\\"cost\\\": {\\n \\\"productCost\\\": 410.00,\\n \\\"extendedCost\\\": 1200.00,\\n \\\"freightCost\\\": 45.50,\\n \\\"additionalCost\\\": 23.20,\\n \\\"tariffCost\\\": 85.00,\\n \\\"landedCost\\\": 1353.70,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"currency\\\": \\\"USD\\\",\\n \\\"fourkitesCalculatedTariffCost\\\": null\\n },\\n \\\"products\\\": [\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n },\\n {\\n \\\"lowerTemperatureThreshold\\\": \\\"-10\\\",\\n \\\"name\\\": \\\"Electronic Control Module\\\",\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"setTemperature\\\": \\\"25\\\",\\n \\\"timeToleranceInMinutes\\\": \\\"30\\\",\\n \\\"upperTemperatureThreshold\\\": \\\"60\\\",\\n \\\"temperatureUnitCode\\\": \\\"cel\\\"\\n }\\n ],\\n \\\"referenceNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"DN-789012\\\",\\n \\\"PO-2025-5678\\\",\\n \\\"DN-345678\\\"\\n ],\\n \\\"deliveryNumbers\\\": \\\"DN-789012, DN-345678\\\",\\n \\\"masterTrackingNumber\\\": \\\"MASTER01\\\",\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"stopId\\\": \\\"1529659839\\\",\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Floor 33\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-001\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"earliestWantTime\\\": \\\"2026-07-19T01:00:00\\\",\\n \\\"externalAddressId\\\": \\\"100\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"latestWantTime\\\": \\\"2026-07-19T02:00:00\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"loadingType\\\": \\\"drop\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"rohit-123/78^*\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"bestBeforeDate\\\": \\\"2025-07-15T08:10:00Z\\\",\\n \\\"additionalCharges\\\": 500.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 1951.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"shipTo\\\": \\\"1234\\\",\\n \\\"state\\\": \\\"IL\\\",\\n \\\"stopReferenceId\\\": \\\"1529659839\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"trackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"unloadTimeInMinutes\\\": 120\\n },\\n {\\n \\\"stopId\\\": \\\"1529659852\\\",\\n \\\"addressLine1\\\": \\\"1001 E 17th Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Bloomington\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": \\\"789789\\\",\\n \\\"name\\\": \\\"sample name 12\\\",\\n \\\"poNumbers\\\": [\\n \\\"PO-2025-4567\\\",\\n \\\"PO-2025-5678\\\"\\n ],\\n \\\"customerPoFields\\\": [\\n {\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"deliveryReference\\\": \\\"DEL-REF-002\\\",\\n \\\"orderReference\\\": \\\"ORD-REF-001\\\"\\n }\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"alert\\\": false,\\n \\\"email\\\": \\\"poc@test.com\\\",\\n \\\"name\\\": \\\"John Doe\\\",\\n \\\"phone\\\": \\\"+19999999999\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2026-07-20T05:00:00\\\",\\n \\\"externalAddressId\\\": \\\"200\\\",\\n \\\"latestAppointmentTime\\\": \\\"2026-07-20T06:00:00\\\",\\n \\\"name\\\": \\\"Assembly Hall\\\",\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"PROD-1234512\\\",\\n \\\"productName\\\": \\\"Premium Auto Parts Kit\\\",\\n \\\"productDescription\\\": \\\"Complete automotive parts assembly kit including filters, belts, and gaskets\\\",\\n \\\"productCategory\\\": \\\"Automotive Parts\\\",\\n \\\"quantity\\\": 100,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 250.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 85.50,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 8550.00,\\n \\\"freightCost\\\": 125.00,\\n \\\"additionalCharges\\\": 50.00,\\n \\\"tariffCost\\\": 200.00,\\n \\\"fourKitesCalculatedTariffCost\\\": 195.75,\\n \\\"totalLandedCost\\\": 8925.00,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8708293000\\\",\\n \\\"commodityTypeCode\\\": \\\"AUTO_PARTS\\\",\\n \\\"htsusCode\\\": \\\"8708293000\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-4567\\\",\\n \\\"deliveryNumber\\\": \\\"DN-789012\\\",\\n \\\"handlingUnitId\\\": \\\"PLT-001234\\\",\\n \\\"barcode\\\": \\\"123456789012\\\",\\n \\\"containerType\\\": \\\"pallet\\\",\\n \\\"gtin\\\": \\\"01234567890123\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-AP-001\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-KIT-789\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-APK-456\\\",\\n \\\"itemNumber\\\": \\\"ITM-001234\\\",\\n \\\"productUpc\\\": \\\"123456789012\\\",\\n \\\"deliveryReferences\\\": [\\\"DEL-REF-001\\\", \\\"DEL-REF-002\\\"],\\n \\\"orderReferences\\\": [\\\"ORD-REF-001\\\"],\\n \\\"brandName\\\": \\\"AutoPro\\\",\\n \\\"minimumTemperature\\\": -10,\\n \\\"maximumTemperature\\\": 60,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-AP-001234\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-789456123\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n },\\n {\\n \\\"productId\\\": \\\"PROD-56789\\\",\\n \\\"productName\\\": \\\"Electronic Control Module\\\",\\n \\\"productDescription\\\": \\\"Advanced electronic control unit for automotive applications\\\",\\n \\\"productCategory\\\": \\\"Electronics\\\",\\n \\\"quantity\\\": 25,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 12.5,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 450.00,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 11250.00,\\n \\\"freightCost\\\": 75.00,\\n \\\"totalLandedCost\\\": 11325.00,\\n \\\"countryOfOrigin\\\": \\\"CN\\\",\\n \\\"harmonizedSystemCode\\\": \\\"8537109900\\\",\\n \\\"orderNumber\\\": \\\"PO-2025-5678\\\",\\n \\\"deliveryNumber\\\": \\\"DN-345678\\\",\\n \\\"handlingUnitId\\\": \\\"BOX-002345\\\",\\n \\\"barcode\\\": \\\"234567890123\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"09876543210987\\\",\\n \\\"customerPartNumber\\\": \\\"CUST-ECM-002\\\",\\n \\\"supplierPartNumber\\\": \\\"SUPP-ECM-890\\\",\\n \\\"brandName\\\": \\\"TechControl\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-ECM-002345\\\",\\n \\\"productTrackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ],\\n \\\"postalCode\\\": \\\"47408\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"DEL-REF-001\\\",\\n \\\"DEL-REF-002\\\",\\n \\\"TRK-789456123\\\",\\n \\\"TRK-890123456\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"IN\\\",\\n \\\"stopReferenceId\\\": \\\"1529659852\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"trackingNumber\\\": \\\"TRK-890123456\\\",\\n \\\"unloadTimeInMinutes\\\": 150,\\n \\\"wantTime\\\": \\\"2026-07-21T13:00:00Z\\\"\\n }\\n ],\\n \\\"tags\\\": [\\n \\\"Tag1\\\",\\n \\\"Tag2\\\",\\n \\\"Tag3\\\"\\n ],\\n \\\"trackingInfo\\\": {\\n \\\"deviceId\\\": \\\"12356\\\",\\n \\\"driverId\\\": \\\"999\\\",\\n \\\"driverPhone\\\": \\\"+19999999999\\\",\\n \\\"mawb\\\": \\\"17233144555\\\",\\n \\\"trailerNumber\\\": \\\"123\\\",\\n \\\"truckNumber\\\": \\\"456\\\"\\n },\\n \\\"trackingNumber\\\": \\\"123456789\\\",\\n \\\"truckRoutingParams\\\": {\\n \\\"height\\\": \\\"4.145\\\",\\n \\\"length\\\": \\\"14.63\\\",\\n \\\"limitedWeight\\\": \\\"996\\\",\\n \\\"shippedHazardousGoods\\\": \\\"flammable\\\",\\n \\\"trailersCount\\\": 0,\\n \\\"truckType\\\": \\\"truck\\\",\\n \\\"tunnelCategory\\\": \\\"C\\\",\\n \\\"weightPerAxle\\\": \\\"498\\\",\\n \\\"width\\\": \\\"2.438\\\"\\n },\\n \\\"seal\\\": \\\"XYZ123\\\",\\n \\\"sealStatus\\\": \\\"XYZ123\\\"\\n }\\n}\", null, \"application/json\");\nrequest.Content = content;\nvar response = await client.SendAsync(request);\nresponse.EnsureSuccessStatusCode();\nConsole.WriteLine(await response.Content.ReadAsStringAsync());\n", "customLabel": "" }, { "id": "fh2kyGCeGBoH8iok802FY", "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.ng.fourkites.com/api/v1/tracking\"\n method := \"POST\"\n\n payload := strings.NewReader(`{\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410.00,\n \"extendedCost\": 1200.00,\n \"freightCost\": 45.50,\n \"additionalCost\": 23.20,\n \"tariffCost\": 85.00,\n \"landedCost\": 1353.70,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": null\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.50,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550.00,\n \"freightCost\": 125.00,\n \"additionalCharges\": 50.00,\n \"tariffCost\": 200.00,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925.00,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\"DEL-REF-001\", \"DEL-REF-002\"],\n \"orderReferences\": [\"ORD-REF-001\"],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450.00,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250.00,\n \"freightCost\": 75.00,\n \"totalLandedCost\": 11325.00,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n}`)\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": "g62VzmM0ca7QqYHmE8JPV", "language": "ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api-staging.ng.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 \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410,\n \"extendedCost\": 1200,\n \"freightCost\": 45.5,\n \"additionalCost\": 23.2,\n \"tariffCost\": 85,\n \"landedCost\": 1353.7,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": nil\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": false,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": false,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"additionalCharges\": 50,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250,\n \"freightCost\": 75,\n \"totalLandedCost\": 11325,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n})\n\nresponse = https.request(request)\nputs response.read_body\n", "customLabel": "" }, { "id": "2QDWbLPC4OWpgov8hWxjZ", "language": "python", "code": "import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api-staging.ng.fourkites.com\")\npayload = json.dumps({\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"TL\",\n \"carrierModes\": \"\"\n }\n },\n \"load\": {\n \"carrierPermalink\": \"insights-carrier-6870\",\n \"carrierName\": \"Insights Carrier\",\n \"carrier\": \"IC68\",\n \"shipperAccountNumber\": \"tXXXXX234\",\n \"haulType\": [\n \"inbound_load\"\n ],\n \"loadNumber\": \"KDPKDLTEST09\",\n \"displayLoadNumber\": \"KDPKDLTEST09\",\n \"billOfLading\": \"billOfLading\",\n \"bookingNumber\": \"bookingNumber\",\n \"priority\": \"high\",\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"simultaneousTrackingSequenceNumber\": 1,\n \"proNumber\": \"991\",\n \"cost\": {\n \"productCost\": 410,\n \"extendedCost\": 1200,\n \"freightCost\": 45.5,\n \"additionalCost\": 23.2,\n \"tariffCost\": 85,\n \"landedCost\": 1353.7,\n \"countryOfOrigin\": \"CN\",\n \"currency\": \"USD\",\n \"fourkitesCalculatedTariffCost\": None\n },\n \"products\": [\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Premium Auto Parts Kit\",\n \"productId\": \"rohit-123/78^*\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n },\n {\n \"lowerTemperatureThreshold\": \"-10\",\n \"name\": \"Electronic Control Module\",\n \"productId\": \"PROD-56789\",\n \"setTemperature\": \"25\",\n \"timeToleranceInMinutes\": \"30\",\n \"upperTemperatureThreshold\": \"60\",\n \"temperatureUnitCode\": \"cel\"\n }\n ],\n \"referenceNumbers\": [\n \"PO-2025-4567\",\n \"DN-789012\",\n \"PO-2025-5678\",\n \"DN-345678\"\n ],\n \"deliveryNumbers\": \"DN-789012, DN-345678\",\n \"masterTrackingNumber\": \"MASTER01\",\n \"relayLoad\": False,\n \"stops\": [\n {\n \"stopId\": \"1529659839\",\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Floor 33\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-789012\",\n \"deliveryReference\": \"DEL-REF-001\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": False,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-19T01:00:00\",\n \"earliestWantTime\": \"2026-07-19T01:00:00\",\n \"externalAddressId\": \"100\",\n \"latestAppointmentTime\": \"2026-07-19T02:00:00\",\n \"latestWantTime\": \"2026-07-19T02:00:00\",\n \"name\": \"FourKites HQ\",\n \"loadingType\": \"drop\",\n \"productLineItems\": [\n {\n \"productId\": \"rohit-123/78^*\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"bestBeforeDate\": \"2025-07-15T08:10:00Z\",\n \"additionalCharges\": 500,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 1951.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n }\n ],\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\"\n ],\n \"sequence\": 1,\n \"shipTo\": \"1234\",\n \"state\": \"IL\",\n \"stopReferenceId\": \"1529659839\",\n \"stopType\": \"pickup\",\n \"trackingNumber\": \"TRK-789456123\",\n \"unloadTimeInMinutes\": 120\n },\n {\n \"stopId\": \"1529659852\",\n \"addressLine1\": \"1001 E 17th Street\",\n \"addressLine2\": \"\",\n \"city\": \"Bloomington\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": \"789789\",\n \"name\": \"sample name 12\",\n \"poNumbers\": [\n \"PO-2025-4567\",\n \"PO-2025-5678\"\n ],\n \"customerPoFields\": [\n {\n \"deliveryNumber\": \"DN-345678\",\n \"deliveryReference\": \"DEL-REF-002\",\n \"orderReference\": \"ORD-REF-001\"\n }\n ],\n \"pointOfContact\": {\n \"alert\": False,\n \"email\": \"poc@test.com\",\n \"name\": \"John Doe\",\n \"phone\": \"+19999999999\"\n }\n },\n \"earliestAppointmentTime\": \"2026-07-20T05:00:00\",\n \"externalAddressId\": \"200\",\n \"latestAppointmentTime\": \"2026-07-20T06:00:00\",\n \"name\": \"Assembly Hall\",\n \"productLineItems\": [\n {\n \"productId\": \"PROD-1234512\",\n \"productName\": \"Premium Auto Parts Kit\",\n \"productDescription\": \"Complete automotive parts assembly kit including filters, belts, and gaskets\",\n \"productCategory\": \"Automotive Parts\",\n \"quantity\": 100,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 250.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 85.5,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 8550,\n \"freightCost\": 125,\n \"additionalCharges\": 50,\n \"tariffCost\": 200,\n \"fourKitesCalculatedTariffCost\": 195.75,\n \"totalLandedCost\": 8925,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"8708293000\",\n \"commodityTypeCode\": \"AUTO_PARTS\",\n \"htsusCode\": \"8708293000\",\n \"orderNumber\": \"PO-2025-4567\",\n \"deliveryNumber\": \"DN-789012\",\n \"handlingUnitId\": \"PLT-001234\",\n \"barcode\": \"123456789012\",\n \"containerType\": \"pallet\",\n \"gtin\": \"01234567890123\",\n \"customerPartNumber\": \"CUST-AP-001\",\n \"supplierPartNumber\": \"SUPP-KIT-789\",\n \"manufacturerPartNumber\": \"MFG-APK-456\",\n \"itemNumber\": \"ITM-001234\",\n \"productUpc\": \"123456789012\",\n \"deliveryReferences\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\"\n ],\n \"orderReferences\": [\n \"ORD-REF-001\"\n ],\n \"brandName\": \"AutoPro\",\n \"minimumTemperature\": -10,\n \"maximumTemperature\": 60,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-AP-001234\",\n \"productTrackingNumber\": \"TRK-789456123\",\n \"deviceType\": \"RFID_TAG\"\n },\n {\n \"productId\": \"PROD-56789\",\n \"productName\": \"Electronic Control Module\",\n \"productDescription\": \"Advanced electronic control unit for automotive applications\",\n \"productCategory\": \"Electronics\",\n \"quantity\": 25,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 12.5,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 450,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 11250,\n \"freightCost\": 75,\n \"totalLandedCost\": 11325,\n \"countryOfOrigin\": \"CN\",\n \"harmonizedSystemCode\": \"8537109900\",\n \"orderNumber\": \"PO-2025-5678\",\n \"deliveryNumber\": \"DN-345678\",\n \"handlingUnitId\": \"BOX-002345\",\n \"barcode\": \"234567890123\",\n \"containerType\": \"box\",\n \"gtin\": \"09876543210987\",\n \"customerPartNumber\": \"CUST-ECM-002\",\n \"supplierPartNumber\": \"SUPP-ECM-890\",\n \"brandName\": \"TechControl\",\n \"labelIdentifier\": \"LBL-ECM-002345\",\n \"productTrackingNumber\": \"TRK-890123456\",\n \"deviceType\": \"QR_CODE\"\n }\n ],\n \"postalCode\": \"47408\",\n \"referenceNumbers\": [\n \"DEL-REF-001\",\n \"DEL-REF-002\",\n \"TRK-789456123\",\n \"TRK-890123456\"\n ],\n \"sequence\": 2,\n \"state\": \"IN\",\n \"stopReferenceId\": \"1529659852\",\n \"stopType\": \"delivery\",\n \"trackingNumber\": \"TRK-890123456\",\n \"unloadTimeInMinutes\": 150,\n \"wantTime\": \"2026-07-21T13:00:00Z\"\n }\n ],\n \"tags\": [\n \"Tag1\",\n \"Tag2\",\n \"Tag3\"\n ],\n \"trackingInfo\": {\n \"deviceId\": \"12356\",\n \"driverId\": \"999\",\n \"driverPhone\": \"+19999999999\",\n \"mawb\": \"17233144555\",\n \"trailerNumber\": \"123\",\n \"truckNumber\": \"456\"\n },\n \"trackingNumber\": \"123456789\",\n \"truckRoutingParams\": {\n \"height\": \"4.145\",\n \"length\": \"14.63\",\n \"limitedWeight\": \"996\",\n \"shippedHazardousGoods\": \"flammable\",\n \"trailersCount\": 0,\n \"truckType\": \"truck\",\n \"tunnelCategory\": \"C\",\n \"weightPerAxle\": \"498\",\n \"width\": \"2.438\"\n },\n \"seal\": \"XYZ123\",\n \"sealStatus\": \"XYZ123\"\n }\n})\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": "sa6A_WxCAcH7ovUgPbe2U" }, "description": "\n", "currentNewParameter": { "label": "Body Parameter", "value": "bodyDataParameters" }, "hasTryItOut": false, "autoGeneratedAnchorSlug": "azure-staging", "legacyHash": "tRKMgYK5JCCE68LRgIhDY" } ``` ::: ## Product Line Items Schema | **Field Name** | **Data Type** | **Constraints** | **Description** | | ------------------------------- | ------------- | ----------------------------------------------- | ---------------------------------------------------- | | `productId` | VARCHAR | Mandatory if productLineItems object is present | Unique identifier for the product | | `productName` | VARCHAR(255) | Not Null | Display name of the product | | `productDescription` | TEXT | Optional | Detailed description of the product | | `productCategory` | VARCHAR(100) | Optional | Category classification of the product | | `quantity` | INTEGER | Not Null, >= 0 | Number of units in the shipment | | `measurementUnitCode` | VARCHAR(10) | Not Null | Unit of measurement for quantity (e.g., PCE, KG, LB) | | `netWeight` | DECIMAL(10,3) | Optional | Weight of the product excluding packaging | | `weightUnit` | VARCHAR(10) | Optional | Unit of measurement for weight (e.g., KGM, LBM) | | `unitCost` | DECIMAL(14,2) | Optional | Cost per unit of the product | | `currencyCode` | CHAR(3) | ISO 4217 | Currency code for cost fields | | `extendedCost` | DECIMAL(14,2) | Optional | Total cost for all units (unitCost × quantity) | | `freightCost` | DECIMAL(14,2) | Optional | Freight cost allocated to this line item | | `bestBeforeDate` | TIMESTAMP | Optional | Expiration or best before date for the product | | `additionalCharges` | DECIMAL(14,2) | Optional | Any additional charges specific to this line item | | `tariffCost` | DECIMAL(14,2) | Optional | Tariff cost for this specific line item | | `fourKitesCalculatedTariffCost` | DECIMAL(14,2) | Optional | System-calculated tariff cost | | `totalLandedCost` | DECIMAL(14,2) | Optional | Total landed cost for this line item | | `countryOfOrigin` | CHAR(2) | ISO 3166-1 | Country of origin for this product | | `harmonizedSystemCode` | VARCHAR(12) | Optional | International trade classification code | | `commodityTypeCode` | VARCHAR(50) | Optional | Commodity classification code | | `htsusCode` | VARCHAR(12) | Optional | Harmonized Tariff Schedule code for US imports | | `orderNumber` | VARCHAR(50) | Optional | Purchase order number | | `deliveryNumber` | VARCHAR(50) | Optional | Delivery reference number | | `handlingUnitId` | VARCHAR(50) | Optional | Identifier for the handling unit (pallet, box, etc.) | | `barcode` | VARCHAR(50) | GS1-compliant | Product barcode | | `containerType` | VARCHAR(20) | Optional | Type of container (pallet, box, carton, etc.) | | `gtin` | VARCHAR(14) | Optional | Global Trade Item Number | | `customerPartNumber` | VARCHAR(100) | Optional | Customer's part number for the product | | `supplierPartNumber` | VARCHAR(100) | Optional | Supplier's part number for the product | | `manufacturerPartNumber` | VARCHAR(100) | Optional | Manufacturer's part number | | `itemNumber` | VARCHAR(50) | Optional | Internal item number | | `productUpc` | VARCHAR(15) | Optional | Universal Product Code | | `deliveryReferences` | JSONB | Optional | Array of delivery reference numbers | | `orderReferences` | JSONB | Optional | Array of order reference numbers | | `brandName` | VARCHAR(100) | Optional | Brand name of the product | | `minimumTemperature` | INTEGER | Optional | Minimum storage/transport temperature | | `maximumTemperature` | INTEGER | Optional | Maximum storage/transport temperature | | `temperatureUnitCode` | VARCHAR(10) | Optional | Temperature unit (cel, fah) | | `labelIdentifier` | VARCHAR(100) | Optional | Label identifier for tracking | | `productTrackingNumber` | VARCHAR(100) | Optional | Unique tracking number for the product | | `deviceType` | VARCHAR(50) | Optional | Type of tracking device (RFID\_TAG, QR\_CODE, etc.) | ## Shipment Costs Schema | **Field Name** | **Data Type** | **Constraints** | **Description** | | ------------------------------- | ------------- | --------------- | ------------------------------------------------------ | | `productCost` | DECIMAL(14,2) | Optional | Base cost of the product before any additional charges | | `extendedCost` | DECIMAL(14,2) | Optional | Extended cost calculated from unit cost × quantity | | `freightCost` | DECIMAL(14,2) | Optional | Transportation/shipping cost for the shipment | | `additionalCost` | DECIMAL(14,2) | Optional | Any additional miscellaneous costs | | `tariffCost` | DECIMAL(14,2) | Optional | Import/export tariff costs | | `landedCost` | DECIMAL(14,2) | Optional | Total cost including all fees and charges | | `countryOfOrigin` | CHAR(2) | ISO 3166-1 | Country code where the product originated | | `currency` | CHAR(3) | ISO 4217 | Currency code for all cost fields | | `fourkitesCalculatedTariffCost` | DECIMAL(14,2) | Nullable | System-calculated tariff cost, can be null | :::hint{type="info"} 1. It is possible to create multiple loads with the same Load Number (Bill Of Lading). Though multiple loads can have the same Load Number, their Load ID will be unique. 2. It is recommended to provide the latitude & longitude of the stop for accurate geofencing. If not provided, they will be geocoded from stop address. 3. The only accepted format of lat/long by FourKites® is the "Decimal Degrees" format. For example: 41.8781 (lat), -87.6298 (long). 4. If geofencePoints for polygon geofence are provided, it will be used for geofencing logic. If geofencePoints are not provided, circular geofence with the radius specified in stop's geofenceRadius will be used. In the absence of both geofencePoints & geofenceRadius, FourKites® will use circular geofence with its internal default radius. 5. Tracking Info can be updated by the carrier or shipper after the load is created. 6. Driver Phone is required if CarrierLink mobile app for Android & iPhone is used for tracking. 7. Driver ID is used by drivers of private fleet owners to log into CarrierLink and see the loads assigned to them. There should be an existing driver user in the platform with the same driver ID. 8. earliestAppointmentTime and latestAppointmentTime - One cannot be provided without the other and latestAppointmentTime should be greater than or equal to earliestAppointmentTime. 9. Appointment time validation is applied to the **most recent appointment time** across all stops on the load. The system identifies the stop with the maximum (latest) appointment time and validates that this time is not more than 4 days in the past from the current time. **Individual stops are not validated separately** if a load has multiple stops with appointment times older than 4 days, but the most recent appointment is within 4 days, the validation passes. This approach enables tracking for loads with at least one valid recent stop. ***Note: The system does not enforce chronological order between pickup and delivery appointment times. It is the customer's responsibility to ensure appointment times are logically sequenced.*** 10. Appointment times cannot be more than 4 days in the past from the current time, and should be provided in the stop's local timezone. 11. If a stop has to be created as a terminal, please provide the following: "stopType" : "transfer" 12. Setting the 'Priority' as 'Hot' will mark the load as 'Hot' load. 13. Pass the displayLoadNumber parameter to show a number other than the loadNumber on the load card. 14. For Air Loads, you must provide either IATA or ICAO airport codes for the externalAddressId parameter and the departingFlightNumber parameter should contain a different flight number for every airport stop. 15. If a stop has to be created as an Origin Airport, Hub Aiport, & Destination Airport, please provide the following: "stopType": "originAirport" / "hubAirport" / "destinationAirport". 16. By default, FourKites will ingest the value given in the "**Weight**" field in Pounds(lbs) and not Kilograms(Kgs). Hence, the value for the "**Weight**" field under the pallet section at the stop level should be converted from Kilograms (**Kgs**) to Pounds (**lbs**) while creating the load. Also, if you add units like "**Kgs**" and "**lbs**" as part of the "**Weight**" field, it will be displayed on the load card as well. ::: ### Load Mode Detection ```json "additionalData": { "modeDetails":{ "shipperModes": "", "carrierModes": "" } }, ``` Now, Shippers, 3PLs and Carriers have the ability to set the Load Mode (TL, LTL, Rail, Ocean or Parcel) of a load. The load creators can specify the load mode using the Load Create and Load Update API and carriers can specify the load mode using Truck Assignment API, Dispatcher update API, Locations API and Batch Locations API. However, if both the load creator and carrier sends different load modes, we can define a rank order of which source is the most trustworthy. For example, let's consider the priority is set as Carrier > Shipper > FourKites. Carrier sends mode as “TL” while shipper sends it as “LTL” and FK detects it as “LTL”. In this case the load will track as TL only. :::hint{type="info"} - *By default, we will track the load mode detected by FourKites but to set a ranking order, please speak to your CSM at FourKites.* - *The master sequence number and the master reference number parameters are applicable only for the users creating a consignment load.* - *masterSequenceNumber is the Consignment Sequence Number which corresponds to the leg for each load.* - *masterReferenceNumber is the Consignment Reference Number which is the identifier for all the loads that are a part of a consignment group.* - *Please reach out to your FourKites® Customer Success Manager if you would like to learn more about Consignment Pooling.* ::: ## Create/Update Errors It is possible that you hit an error due to various reasons when trying to create or update a load. The following table is directed towards making your life simpler by providing the list of possible errors you will encounter and the steps to resolve them. | Error Code | Error Message | Resolution | | ---------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 400 | State 'ABCD' is not valid | Provide a valid 2 character state code for US and Canada and a 3 character state code for Mexico.Example: CA, NY, ON, BCN, CAM. | | 400 | Postal 'EFGH' is not a valid US postal code | Provide a valid US postal code.Example: 87901 | | 400 | Postal 'EFGH' is not a valid Canada postal code | Provide a valid Canada postal code.Example: V3J | | 400 | Postal 'EFGH' is not a valid Mexico postal code | Provide a valid Mexico postal code.Example: 46958 | | 400 | Stops should contain at least one pickup and one delivery | Ensure that you create a load with at least one pickup and one delivery stop. | | 400 | Stops stop Earliest Appointment Time should not be greater than Latest Appointment Time | Ensure that the stop's earliest appointment time is not greater than the latest appointment time. | | 400 | Stops cannot have appointment time earlier than 4 days | Ensure that the stop's appointment time is not earlier than 4 days from the current time. | | 400 | Address should contain Address line 1 or city, state and country or Latitude and Longitude | While creating a load, ensure that stop address contains at least one of the following\:Address Line 1, City, State, Country,Latitude/Longitude. This helps in geocoding the stop address. | | 400 | Load information is empty | Ensure that the "load" object is included in your API request: \{"load": \{ ... ... }} | | 400 | Carrier is not specified | Specify the SCAC of the Carrier. | | 400 | Stops stop should contain both earliest and latest want times | If you want to create a load with want time as time ranges (earliest and latest want time), ensure that you provide the values for both these fields. | | 400 | Stops stop Earliest Want Time should not be greater than Latest Want Time | Ensure that the stop's earliest want time is not greater than the latest want time. | | 400 | Products temperature unit is invalid | If you create a temperature-tracked load, ensure that you provide the correct temperature unit. The Valid values are: C (Celsius), F (Fahrenheit) | | 400 | Products temperature parameters need to be valid | If you create a temperature-tracked load with setTemperature and timeToleranceInMinutes, ensure that you provide values for both fields. That is, this error will be posted when you try to create a temperature-tracked load by sending values only for setTemperature and not for timeToleranceInMinutes or vice-versa. | | 400 | Address Should contain Address line 1 or city, state and country or Latitude and Longitude. | If you're sending only Latitude & Longitude co-ordinates for an address, check if the **Process Lat/Long From API** flag is enabled for your company. Reach out to your customer success manager at Fourkites. | | 409 | API call limit exceeded | This occurs when a user has made multiple API calls for the same request. | | 403 | Invalid Session, please login | The session may have timed out. Log in again. | | 401 | User not authorized for this resource | Check if the user is a FourKites user and has the necessary permissions to perform the action. | | 500 | Internal Server Error | Service may be down. Try again later. Note: 5XX error means that our server is unable to establish a connection. In case of a 5XX error, we suggest applying a procedure to retry the API call after an hour. |