---
title: Violation
slug: fourkites-api-reference/violation
description: Learn how to effectively track temperature readings using FourKites system with this document. Discover how callbacks are triggered when the temperature exceeds a set threshold, and explore the sample JSON payload with data fields like location, sensor de
createdAt: 2023-04-14T06:25:36.000Z
---

This callback is triggered when the temperature reading on loads go beyond the set threshold for more than the time tolerance configured.

If You Are A Customer Interested In Temperature Tracking, Please Reach Out To Your Customer Success Manager.

```json
{
  "City": "Chicago",
  "Country": "US",
  "FourKitesLoadId": 6564345,
  "Latitude": "42.0",
  "LoadNumber": "Sample_Load#",
  "Location": "Test_Location",
  "Longitude": "-74.0",
  "MaxTemperature": "100.0",
  "MessageType": "TEMPERATURE_VIOLATION",
  "MinTemperature": "10.0",
  "OdometerReading": Null,
  "ProNumber": "PRO9965767",
  "ReferenceNumbers": [
    "Carrier Point Of Contact :John Doe",
    "Carrier Phone :980-275-XXXX",
    "EQUIPMENT_TYPE:Van",
  ],
  "Sensor": "Sensor1",
  "Shipper": "Fknwshipper",
  "State": "IL",
  "Tags": [
    "Specificloadtags"
  ],
  "TemperatureReading": "200.0",
  "TemperatureUnit": "F",
  "Timestamp": "2020-08-07T03:40:27-04:00",
  "Timezone": "Eastern Time (US & Canada)",
  "TimezoneShortName": "EST",
  "TimezoneOffset": -14400,
  "TimezoneShortName": "EDT"
}
```

## Field Definitions

| **Field Name**       | **Description**                                                                                                                                                       | **Key Always Present?** | **Value Always Present?** | **Data Type**             | **Max Length**                                            |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ------------------------- | ------------------------- | --------------------------------------------------------- |
| `LoadNumber`         | Unique shipment identifier from shipper's system                                                                                                                      | Yes                     | Yes                       | String                    | 65535                                                     |
| `Location`           | Street address, city, state, and country of latest temperature update, concatenated                                                                                   | Yes                     | Yes                       | String                    | 1024                                                      |
| `Latitude`           | Latitude where latest temperature update was received                                                                                                                 | Yes                     | Yes                       | String / Decimal          | 18 if String                                              |
| `Longitude`          | Longitude where latest temperature update was received                                                                                                                | Yes                     | Yes                       | String / Decimal          | 18 if String                                              |
| `Timezone`           | e.g., Eastern                                                                                                                                                         | Yes                     | Yes                       | String                    | 50                                                        |
| `TemperatureReading` | Latest temperature reading                                                                                                                                            | Yes                     | Yes                       | String                    | 1024                                                      |
| `Sensor`             | Compartment or sensor unit number that sent the latest temperature update                                                                                             | Yes                     | Yes                       | String                    | 1024                                                      |
| `FourKitesLoadId`    | Unique load identifier from FourKites system if the load was successfully created (IsSuccess = true). The field will be null if the load creation failed in FourKites | Yes                     | Yes                       | Number                    | 20                                                        |
| `ProNumber`          | Shipment's PRO #                                                                                                                                                      | Yes                     | No                        | Number                    | 10                                                        |
| `Shipper`            | Unique shipper ID (permalink) from FourKites                                                                                                                          | Yes                     | Yes                       | String                    | No max, but realistically, not longer than 200 characters |
| `Tags`               | List of tags associated with the load (empty list when tags are not present)                                                                                          | Yes                     | No                        | Array of string           | 50 for each tag                                           |
| `ReferenceNumbers`   | List of additional reference numbers associated with the load (empty list when no reference numbers are associated with the load)                                     | Yes                     | No                        | Array of string           | No max                                                    |
| `City`               | City where latest temperature update was received                                                                                                                     | Yes                     | Yes                       | String                    | 1024                                                      |
| `State`              | State where latest temperature update was received                                                                                                                    | Yes                     | Yes                       | String                    | 1024                                                      |
| `Country`            | Country where latest temperature update was received                                                                                                                  | Yes                     | Yes                       | String                    |                                                           |
| `TemperatureUnit`    | Unit of measurement; Shorthand for Fahrenheit or Celsius (F or C)                                                                                                     | Yes                     | Yes                       | String                    | 1024                                                      |
| `OdometerReading`    | Odometer reading associated with the temperature update (provided only for loads moved by dedicated carriers)                                                         | Yes                     | No                        |                           |                                                           |
| `Timestamp`          | Time when the latest location update was received (in ISO 8601 format)                                                                                                | Yes                     | Yes                       | String in DateTime format | 30                                                        |
| `TimezoneShortName`  | e.g., EST                                                                                                                                                             | Yes                     | Yes                       | String                    | 5                                                         |
| `TimezoneOffset`     | Offset in seconds from UTC. Western Hemisphere timezones will display a negative value.                                                                               | Yes                     | Yes                       | \[+/-]Digits              | 10                                                        |
| `MinTemperature`     | Minimum temperature threshold set                                                                                                                                     | Yes                     | Yes                       | String                    |                                                           |
| `MaxTemperature`     | Maximum temperature threshold set                                                                                                                                     | Yes                     | Yes                       | String                    |                                                           |