---
title: Load Expired
slug: fourkites-api-reference/load-expired
description: Learn about the crucial details of load expiration updates, including load ID, number, distance, shipper ID, carrier identifier, status, timestamp, timezone, shortname, and offset. Find out if each key and value is consistently available in the update mes
createdAt: 2023-04-14T06:11:50.000Z
---

The update is triggered when any load expires.

```json
{
 "MessageType" : "LOAD_EXPIRED",
 "FourKitesLoadId" : 1234,
 "LoadNumber" : "BOL12345",
 "TotalDistance" : "None",
 "Shipper" : "test-shipper",
 "Carrier" : "test-carrier",
 "Status" : "expired",
 "Timestamp" : "2015-10-01T16:00:00-05:00",
 "Timezone" : "America/New_York",
 "TimezoneShortName" : "UTC",
 "TerminationTime" : "2015-10-01T16:00:00-05:00",
 "TimezoneOffset" : 0
}
```

| **Field Name**      | **Description**                                                                                                                                                         | **Key Always Present?**          | **Data Type**             | **Max Length**                                            |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------- | --------------------------------------------------------- |
| `FourKitesLoadId`   | Unique load identifier from FourKites system                                                                                                                            | Yes                              | Number                    | 20                                                        |
| `LoadNumber`        | Unique shipment identifier from shipper's system                                                                                                                        | Yes                              | String                    | 65535                                                     |
| `TotalDistance`     | The total distance (in meters) from the initial pickup stop to the final delivery stop. This is calculated after all the stops on the load are geocoded.                | Yes                              |                           |                                                           |
| `Shipper`           | Unique shipper ID from FourKites                                                                                                                                        | Yes                              | String                    | No max, but realistically, not longer than 200 characters |
| `Carrier`           | Unique carrier identifier from FourKites system                                                                                                                         | Yes                              | String                    | 1024                                                      |
| `Status`            | The status of load corresponding to the tracking update done. For example, "Expired".                                                                                   | Yes                              | String                    | 100 max                                                   |
| `Timestamp`         | The time (ISO 8601 format) when the Geofence was updated in UTC.                                                                                                        | Yes                              | String in DateTime format | 30                                                        |
| `Timezone`          | The timezone in UTC.                                                                                                                                                    | Yes                              | String                    | 50                                                        |
| `TimezoneShortName` | Will be hard coded to "UTC"                                                                                                                                             | Yes                              | String                    | 5                                                         |
| `TimezoneOffset`    | Number of seconds the time zone is ahead of UTC time. For western hemisphere, time zones will be represented in negative values indicating that the time is behind UTC. | Yes                              | \[+/-]Digits              | 10                                                        |
| `CreatedBy`         | This applies only for FourKites X loads.                                                                                                                                | Yes, if it's a FourKites X load. | String                    | 1024                                                      |

###