---
title: Cancelled
slug: fourkites-api-reference/cancelled
description: Learn about the request parameters and field descriptions needed to trigger an Appointment cancelled callback in the Appointment Manager. This document provides comprehensive information on key details such as appointment time, facility name, load number,
createdAt: 2023-10-20T14:19:01.000Z
---

Whenever an Appointment is cancelled in the Appointment Manager, an Appointment cancelled callback has to be triggered with the specific information.

### Request Parameter

```json
{
	"AppointmentTimeEnd": "2023-10-13T16:00:00.000Z",
	"AppointmentTimeStart": "2023-10-13T15:00:00.000Z",
	"Carrier": null,
	"CheckInAt": "0001-01-01T00:00:00.000Z",
	"CheckOutAt": "0001-01-01T00:00:00.000Z",
	"FacilityName": "124 W Polk St",
	"LoadNumber": "today01",
	"MessageType": "APPOINTMENT_CANCELLED",
	"PONumber": null,
	"PlannedTime": "0001-01-01T00:00:00.000Z",
	"ReasonCode": "Heavy rain",
	"ReferenceNumber": null,
	"Scac": null,
	"Shipper": "dytest",
	"ShippingType": "Drop-hook",
	"StopName": null,
	"StopSequence": null,
	"StopType": "Delivery",
	"Timestamp": "2023-10-13T08:15:53-05:00",
	"UserName": "sowmya-g"
}
```

### Field Description

| **Field Name**         | **Description**                                                                                                                   | **Key Always Present?**   | **Value Always Present?** | **Data Type**             | **Max Length** | **Default Value**            | **Default Value Max Length** |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | ------------------------- | ------------------------- | -------------- | ---------------------------- | ---------------------------- |
| `LoadNumber`           | Unique shipment identifier from shipper's system                                                                                  | Yes                       | Yes                       | String                    | No max         | Null                         | Null                         |
| `PONumber`             | Shipments PO#                                                                                                                     | Yes                       | No                        | Array of string           | No max         | Null                         | Null                         |
| `ReferenceNumber`      | List of additional reference numbers associated with the load (empty list when no reference numbers are associated with the load) | Yes                       | Yes                       | Array of string           | No max         | Null                         | Null                         |
| `StopName`             | Name of the stop provided during load creation.                                                                                   | Yes                       | Yes                       | String                    | No max         | Null                         | Null                         |
| `ShippingType`         | Shipping type - Live                                                                                                              | Yes                       | Yes                       | String                    | No max         | ShippingType                 | String                       |
| `Shipper`              | Unique shipper ID from FourKites                                                                                                  | Yes                       | Yes                       | String                    | No max         | ShipperName                  | String                       |
| `Carrier`              | Unique Carrier ID from FourKites                                                                                                  | Yes                       | Yes                       | String                    | No max         | Null                         | Null                         |
| `Scac`                 | SCAC of the Carrier                                                                                                               | Yes                       | Yes                       | String                    | No max         | Null                         | Null                         |
| `PlannedTime`          | Wanted time provided by the Shipper                                                                                               | Yes                       | Yes                       | String in DateTime format |                | Baseline time representation | Null                         |
| `AppointmentTimeStart` | Start Time from the Appointment Window                                                                                            | Yes                       | Yes                       | String in DateTime format |                | Always present               |                              |
| `AppointmentTimeEnd`   | End Time from the Appointment Window                                                                                              | Yes                       | Yes                       | String in DateTime format |                | Always present               |                              |
| `StopSequence`         | Sequence of the stop on the load that the truck departed from                                                                     | Yes                       | Yes                       | int64                     | No max         | Null                         | Null                         |
| `ReasonCode`           | Configured by facilities within Appointement Manager                                                                              | Yes                       | Yes                       | String                    | No max         | Null                         | Null                         |
| `CheckInAt`            | Check-in date and time in hh\:mm                                                                                                  | Yes                       | Yes                       | String in DateTime format |                | Baseline time representation |                              |
| `CheckOutAt`           | Check-out date and time in hh\:mm                                                                                                 | Yes                       | Yes                       | String in DateTime format |                | Baseline time representation |                              |
| `UserName`             | User who auto scheduled                                                                                                           | Yes                       | Yes                       | String                    | No max         | UserName                     | String                       |
| `FacilityName`         | Name of the Facility                                                                                                              | Yes                       | Yes                       | String                    | No max         | FaciltyName                  | String                       |
| `Timestamp`            | Time when the truck arrived at the stop in stop's local time (in ISO 8601 format with local time offset to UTC)                   | Yes                       | Yes                       | String in DateTime format |                |                              |                              |
| `StopType`             | Stop type - pickup, terminal, delivery, portOfLoading, transshipmentPort, portOf Discharge.                                       | May or may not be present | Yes                       | String                    | No max         | AppointmentType/SlotType     | String                       |