---
title: Single batch - with all Stop level only key-value
slug: fourkites-api-reference/single-batch-with-all-stop-level-only-key-value
createdAt: 2024-02-05T08:04:48.000Z
---

:::ApiMethodV2
```json
{
  "name": "Single batch",
  "method": "POST",
  "url": "https://api.fourkites.com/load/update/dispatcher-api/async",
  "description": "",
  "tab": "examples",
  "examples": {
    "languages": [
      {
        "id": "oLvosGmzkQ3bvszwQDwDh",
        "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            \"stopUpdate\": {\n                \"appointmentTime\": \"YYYY-MM-DDTHH:MM:SSZ\",\n                \"earliestAppointmentTime\": \"YYYY-MM-DDTHH:MM:SSZ\",\n                \"latestAppointmentTime\": \"YYYY-MM-DDTHH:MM:SSZ\",\n                \"stopType\": \"pickup\",\n                \"stopSequence\": 1,\n                \"stopReferenceId\": \"stopReferenceId\",\n                \"postalCode\": \"postalCode\",\n                \"statusCode\": \"statusCodestop\",\n                \"statusDescription\": \"statusDescriptionstop\",\n                \"statusReasonCode\": \"statusReasonCodestop\",\n                \"eventTimeStamp\": \"YYYY-MM-DDTHH:MM:SSZ\",\n                \"earliestAppointmentDateOnly\": \"YYYY-MM-DD\",\n                \"earliestAppointmentTimeOnly\": \"HH:MM:SS\",\n                \"latestAppointmentDateOnly\": \"YYYY-MM-DD\",\n                \"latestAppointmentTimeOnly\": \"HH:MM:SS\"\n            }\n        }\n    ]\n}'",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "oLvosGmzkQ3bvszwQDwDh"
  },
  "results": {
    "languages": [
      {
        "id": "HWyoTVAKKbJAvU0fzLvlW",
        "language": "202",
        "customLabel": "",
        "code": "{\n  \"requestId\": \"01dd5e35-5222-474e-8b3b-b630969b1142\",\n  \"status\": \"202\",\n  \"message\": \"API Request Accepted\",\n  \"timestamp\": \"2023-09-29T14:00:25.520773\"\n}"
      }
    ],
    "selectedLanguageId": "HWyoTVAKKbJAvU0fzLvlW"
  },
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "autoGeneratedAnchorSlug": "single-batch",
  "legacyHash": "ItfWHC6dMjn9qghH6tT0w"
}
```
:::

## Header

***

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

## 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"
                }
            ],
            "stopUpdate": {
                "appointmentTime": "YYYY-MM-DDTHH:MM:SSZ",
                "earliestAppointmentTime": "YYYY-MM-DDTHH:MM:SSZ",
                "latestAppointmentTime": "YYYY-MM-DDTHH:MM:SSZ",
                "stopType": "pickup",
                "stopSequence": 1,
                "stopReferenceId": "stopReferenceId",
                "postalCode": "postalCode",
                "statusCode": "statusCodestop",
                "statusDescription": "statusDescriptionstop",
                "statusReasonCode": "statusReasonCodestop",
                "eventTimeStamp": "YYYY-MM-DDTHH:MM:SSZ",
                "earliestAppointmentDateOnly": "YYYY-MM-DD",
                "earliestAppointmentTimeOnly": "HH:MM:SS",
                "latestAppointmentDateOnly": "YYYY-MM-DD",
                "latestAppointmentTimeOnly": "HH:MM:SS"
            }
        }
    ]
}
```