---
title: Single batch - with all event level key-value (cloned)
slug: fourkites-api-reference/single-batch-with-all-event-level-key-value-cloned
createdAt: 2024-02-05T08:13:55.000Z
---

:::ApiMethodV2
```json
{
  "name": "",
  "method": "POST",
  "url": "https://api.fourkites.com/load/update/dispatcher-api/async",
  "description": "",
  "tab": "examples",
  "examples": {
    "languages": [
      {
        "id": "A7Tsvgnmw7rglHtFt1mgt",
        "language": "curl",
        "code": "curl --location 'https://api.fourkites.com/load/update/dispatcher-api/async' \\\n--header 'Content-Type: application/json' \\\n--header 'apikey: testkey' \\\n--data '{\n    \"updates\": [\n        {\n            \"timeZone\": \"UTC\",\n            \"billToCode\": \"Shipper unique id\",\n            \"identifierKeys\": [\n                {\n                    \"identifier\": \"Load reference #1\",\n                    \"rawIdentifier\": \"Carrier format - Load reference #1\",\n                    \"identifierType\": \"Load reference identifier type in FourKites or Carrier company\" //If FourKites standard used, then only reference would be searched using given identifierType otherwise skipped\n                },\n                {\n                    \"identifier\": \"Load reference #2\",\n                    \"rawIdentifier\": \"Carrier format - Load reference #2\",\n                    \"identifierType\": \"Load reference identifier type in FourKites or Carrier company\"\n                },\n                {\n                    \"identifier\": \"Load reference #3\",\n                    \"rawIdentifier\": \"Carrier format - Load reference #3\",\n                    \"identifierType\": \"Load reference identifier type in FourKites or Carrier company\"\n                },\n                {\n                    \"identifier\": \"Load reference #4\",\n                    \"rawIdentifier\": \"Carrier format - Load reference #4\",\n                    \"identifierType\": \"Load reference identifier type in FourKites or Carrier company\"\n                }\n            ],\n            \"loadUpdate\": [\n                {\n                    \"eventUpdate\": {\n                        \"modeType\": [\n                            \"ftl\"\n                        ],\n                        \"statusCode\": \"statusCodeevent\",\n                        \"statusDescription\": \"statusDescriptionevent\",\n                        \"statusReasonCode\": \"statusReasonCodeevent\",\n                        \"eventTimeStamp\": \"YYYY-MM-DDTHH:MM:SSZ\",\n                        \"ecta\": {\n                            \"ecta\": \"ecta\"\n                        },\n                        \"city\": \"Event City Code\",\n                        \"state\": \"Event state code\",\n                        \"country\": \"Event Country code\",\n                        \"pickupTime\": \"YYYY-MM-DDTHH:MM:SSZ\",\n                        \"deliveryTime\": \"YYYY-MM-DDTHH:MM:SSZ\",\n                        \"delivered\": false,\n                        \"deliveredAt\": \"YYYY-MM-DDTHH:MM:SSZ\",\n                        \"oceanDataHash\": {\n                            \"city\": \"City\",\n                            \"state\": \"State code\",\n                            \"country\": \"Country Code\",\n                            \"event_timezone\": \"UTC\",\n                            \"event_source\": \"dispatcher_async\",\n                            \"event_date_time\": \"YYYY-MM-DDTHH:MM:SSZ\",\n                            \"ocean_container_number\": \"ocean_container_number\",\n                            \"update_action\": \"update_action\"\n                        },\n                        \"vesselLocation\": \"vesselLocation\",\n                        \"railEventCode\": \"railEventCode\",\n                        \"shipmentStatusIndicator\": \"shipmentStatusIndicator\",\n                        \"shipmentStatus\": \"shipmentStatus\",\n                        \"failedLoads\": \"failedLoads\",\n                        \"airDataHash\": {\n                            \"quantity\": \"1\"\n                        }\n                    },\n                    \"additionalData\": {\n                        \"simultaneousTrackingReferenceNumber\": \"simultaneousTrackingReferenceNumberadditional\"\n                    }\n                }\n            ]\n        }\n    ]\n}'",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "A7Tsvgnmw7rglHtFt1mgt"
  },
  "results": {
    "languages": [
      {
        "id": "WddmdrqmVG0OooSGjBrDt",
        "language": "202",
        "customLabel": "",
        "code": "{\n  \"requestId\": \"1ceaf2c0-e168-4bfe-8ce4-7d15a4f8819a\",\n  \"status\": \"202\",\n  \"message\": \"API Request Accepted\",\n  \"timestamp\": \"2023-09-29T14:02:18.090162\"\n}"
      }
    ],
    "selectedLanguageId": "WddmdrqmVG0OooSGjBrDt"
  },
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "autoGeneratedAnchorSlug": "qRPQDrR60Lmm3VNE6U7Hi",
  "legacyHash": "qRPQDrR60Lmm3VNE6U7Hi"
}
```
:::

## Header

***

| **Content-Type** | application/json |
| ---------------- | ---------------- |
| **apikey**       | testkey          |

## Body

***

```json
{
    "updates": [
        {
            "timeZone": "UTC",
            "billToCode": "Shipper unique id",
            "identifierKeys": [
                {
                    "identifier": "Load reference #1",
                    "rawIdentifier": "Carrier format - Load reference #1",
                    "identifierType": "Load reference identifier type in FourKites or Carrier company" //If FourKites standard used, then only reference would be searched using given identifierType otherwise skipped
                },
                {
                    "identifier": "Load reference #2",
                    "rawIdentifier": "Carrier format - Load reference #2",
                    "identifierType": "Load reference identifier type in FourKites or Carrier company"
                },
                {
                    "identifier": "Load reference #3",
                    "rawIdentifier": "Carrier format - Load reference #3",
                    "identifierType": "Load reference identifier type in FourKites or Carrier company"
                },
                {
                    "identifier": "Load reference #4",
                    "rawIdentifier": "Carrier format - Load reference #4",
                    "identifierType": "Load reference identifier type in FourKites or Carrier company"
                }
            ],
            "loadUpdate": [
                {
                    "eventUpdate": {
                        "modeType": [
                            "ftl"
                        ],
                        "statusCode": "statusCodeevent",
                        "statusDescription": "statusDescriptionevent",
                        "statusReasonCode": "statusReasonCodeevent",
                        "eventTimeStamp": "YYYY-MM-DDTHH:MM:SSZ",
                        "ecta": {
                            "ecta": "ecta"
                        },
                        "city": "Event City Code",
                        "state": "Event state code",
                        "country": "Event Country code",
                        "pickupTime": "YYYY-MM-DDTHH:MM:SSZ",
                        "deliveryTime": "YYYY-MM-DDTHH:MM:SSZ",
                        "delivered": false,
                        "deliveredAt": "YYYY-MM-DDTHH:MM:SSZ",
                        "oceanDataHash": {
                            "city": "City",
                            "state": "State code",
                            "country": "Country Code",
                            "event_timezone": "UTC",
                            "event_source": "dispatcher_async",
                            "event_date_time": "YYYY-MM-DDTHH:MM:SSZ",
                            "ocean_container_number": "ocean_container_number",
                            "update_action": "update_action"
                        },
                        "vesselLocation": "vesselLocation",
                        "railEventCode": "railEventCode",
                        "shipmentStatusIndicator": "shipmentStatusIndicator",
                        "shipmentStatus": "shipmentStatus",
                        "failedLoads": "failedLoads",
                        "airDataHash": {
                            "quantity": "1"
                        }
                    },
                    "additionalData": {
                        "simultaneousTrackingReferenceNumber": "simultaneousTrackingReferenceNumberadditional"
                    }
                }
            ]
        }
    ]
}
```