---
title: Mark Shipment Hot
slug: fourkites-api-reference/mark-shipment-hot
description: Learn how to mark existing loads as "Hot" and change their priority with this comprehensive document. Gain insights on code examples, possible responses, and the transition from "Emergency" to "Hot" terminology. Find all the success and error codes with c
icon: {"apiMethod":"POST"}
createdAt: 2023-04-14T05:41:23.000Z
---

Allows authorized users to mark existing load(s) as Hot by changing the priority on the load. Please note, you will need to use the FourKites’ Internal Tracking ID, “loadId”, that was returned in the response from the Load Create API request.

:::hint{type="success"}
In the Request, include the Tracking IDs of the loads that you would like to set the priority on, as 'Hot', separated by a comma. Note that the Tracking ID is the internal load ID of the load that was returned in the response from the Load Create API request.
:::

:::hint{type="info"}
### Rate Limit

**1 request per second**
:::

:::hint{type="info"}
### Format Supported

**JSON**
:::

:::hint{type="info"}
### Authentication

**Basic Authentication **(Admin username & password)
:::

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": " https://tracking-api.fourkites.com/api/v1/tracking/mark_loads_as_hot",
  "name": "Production",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [
      {
        "name": "trackingIds",
        "kind": "required",
        "type": "string",
        "description": "Unique load identifiers from FourKites system if the load was successfully created ",
        "": "required"
      }
    ],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "VW8MU6zfgbwUd2QQ2MjUv",
        "code": "{\n    \"statusCode\": 200,\n    \"message\": \"Tracking records marked as hot\",\n    \"updatedTrackingIds\": [\n        427208796\n    ]\n}\n",
        "language": "200",
        "customLabel": ""
      },
      {
        "id": "7SItXc_mlcYNCKkGtMj6Q",
        "code": "{\n    \"errors\": [\n        \"array of error messages\"\n    ],\n    \"statusCode\": 400\n}",
        "language": "400",
        "customLabel": ""
      },
      {
        "id": "bF93L6ukZXvrc6MozKmAu",
        "code": "{\n    \"statusCode\": 403,\n    \"error\": \"Invalid Session, please login\",\n    \"requestId\": \"6d29acaa-1c17-45e9-9ce3-d6cdccf9979e\"\n}",
        "language": "403",
        "customLabel": ""
      },
      {
        "id": "Ic-XLQZKZBh-6PsdyuZA_",
        "code": "{\n    \"message\": \"User not authorized for this resource\",\n    \"statusCode\": 401\n}\n",
        "language": "401",
        "customLabel": ""
      },
      {
        "id": "eH_nfpmTaz5b46q-cAR_A",
        "language": "500",
        "code": "\n{\n    \"message\": \"An Internal Error Has Occurred\",\n    \"statusCode\": 500\n}",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "VW8MU6zfgbwUd2QQ2MjUv"
  },
  "examples": {
    "languages": [
      {
        "id": "mzFQmeCNTXm1PzcpAmyiK",
        "code": "{\n  \"trackingIds\": [427208796, 91190]\n}\n",
        "language": "json",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "mzFQmeCNTXm1PzcpAmyiK"
  },
  "description": "",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "hasTryItOut": false,
  "autoGeneratedAnchorSlug": "production",
  "legacyHash": "9VGpOVkjdG_zBe5UhCDCv"
}
```
:::

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://tracking-api-staging.fourkites.com/api/v1/tracking/mark_loads_as_hot",
  "name": "Staging",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [
      {
        "name": "trackingIds",
        "kind": "required",
        "type": "string",
        "description": "Unique load identifiers from FourKites system if the load was successfully created ",
        "": "required"
      }
    ],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "VW8MU6zfgbwUd2QQ2MjUv",
        "code": "{\n    \"message\": \"Tracking records marked as hot\",\n    \"statusCode\":200,\n    \"updatedTrackingIds\":[92325]\n}\n",
        "language": "200",
        "customLabel": ""
      },
      {
        "id": "7SItXc_mlcYNCKkGtMj6Q",
        "code": "{\n    \"errors\": [\n        \"array of error messages\"\n    ],\n    \"statusCode\": 400\n}",
        "language": "400",
        "customLabel": ""
      },
      {
        "id": "bF93L6ukZXvrc6MozKmAu",
        "code": "{\n    \"message\": \"Invalid Session, please login\",\n    \"statusCode\": 403\n} ",
        "language": "403",
        "customLabel": ""
      },
      {
        "id": "Ic-XLQZKZBh-6PsdyuZA_",
        "code": "{\n    \"message\": \"User not authorized for this resource\",\n    \"statusCode\": 401\n}\n",
        "language": "401",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "7SItXc_mlcYNCKkGtMj6Q"
  },
  "examples": {
    "languages": [
      {
        "id": "mzFQmeCNTXm1PzcpAmyiK",
        "code": "{\n  \"trackingIds\": [91189, 91190]\n}\n",
        "language": "json",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "mzFQmeCNTXm1PzcpAmyiK"
  },
  "description": "",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "hasTryItOut": false,
  "autoGeneratedAnchorSlug": "staging",
  "legacyHash": "OjDee3O9liZjJUwdjSDOG"
}
```
:::

:::hint{type="info"}
**Note:** We previously had a label to set the priority on loads as '**Emergency**', and to align with the business terminology, we’ve now changed the label to '**Hot**'. And as part of backfilling, all the loads that were tagged as '**Emergency**' will now have the label '**Hot**'. 
:::