---
title: Order Cancelled
slug: fourkites-api-reference/order-cancelled
createdAt: 2024-06-18T15:04:29.000Z
---

This callback will be triggered when your order gets cancelled.

## Request Parameter

```json
{
  "CompanyPermalink": "po-XXXX-shipper",
  "FourKitesOrderId": "6f8ae127-cefb-4ec9-95e1-22d7796cf3ef",
  "MessageType": "ORDER_CANCELLED",
  "OrderActualDeliveryDate": "null",
  "OrderActualShipDate": "null",
  "OrderDestination": "Test Order Company",
  "OrderDestinationETA": "null",
  "OrderETA": "null",
  "OrderETAStatus": null,
  "OrderEURL": "<https://app-qat.fourkites.com/inventory/orders/eurl/uSexT/9S1HE0vOEMD0H6wkg1gRTQwqdQajZpephfPZebu2fwgOsvUJ8YqBlQu2%2B4B2vZR7QwbYjA4sb54mq2FfeQBzElPb2fedthvOmXiC1FNtxxcV9yqHFNUQHawuKR>",
  "OrderMustShipByDate": "2023-05-26T21:20Z",
  "OrderNumber": "ORDER-ramesh-test-june-7-mixed-multileg-latest-1",
  "OrderPaymentType": null,
  "OrderPickupETA": "null",
  "OrderReferenceNumbers": [
    "RO-98277927281"
  ],
  "OrderRequiredDeliveryDate": "2023-06-04T18:06:57.419840Z",
  "OrderStatus": "open_updated",
  "OrderStatusTime": "2024-06-07T11:26:08.207844971Z[GMT]",
  "OrderType": null,
  "createdAt": "2024-06-07T11:26:08.287803151Z[GMT]",
  "orderTransportType": "domestic"
}
```

## Field Definitions

| **Field Name**              | **Description**                                                                       | **Key Always Present?** | **Value Always Present?** | **Data Type**   | **Max Length**                  |
| --------------------------- | ------------------------------------------------------------------------------------- | ----------------------- | ------------------------- | --------------- | ------------------------------- |
| `CompanyPermalink`          | The unique identifier for the company in the FourKites system.                        | Yes                     | No                        | string          | no max                          |
| `FourKitesOrderId`          | The unique identifier for the order in the FourKites system.                          | Yes                     | No                        | UUID            | 36                              |
| `MessageType`               | The type of event or message (e.g., ORDER\_CREATED, GATE\_OUT, SHIPMENT\_PICKED\_UP). | Yes                     | Yes                       | string          | Realistically no longer than 50 |
| `OrderActualDeliveryDate`   | The actual delivery date of the order, if available.                                  | Yes                     | No                        | string          | 34                              |
| `OrderActualShipDate`       | The actual ship date of the order, if available.                                      | Yes                     | No                        | string          | 34                              |
| `OrderDestination`          | The final destination of the order.                                                   | Yes                     | No                        | string          | no max                          |
| `OrderDestinationETA`       | The estimated time of arrival at the order's destination.                             | Yes                     | No                        | string          | 34                              |
| `OrderETA`                  | The estimated time of arrival of the order.                                           | Yes                     | No                        | string          | 34                              |
| `OrderETAStatus`            | The status of the estimated time of arrival (e.g., on-time, late).                    | Yes                     | No                        | string          | 9                               |
| `OrderEURL`                 | The URL link to view the order details in the FourKites application.                  | Yes                     | No                        | string          | no max                          |
| `OrderMustShipByDate`       | The date by which the order must be shipped.                                          | Yes                     | No                        | string          | 34                              |
| `OrderNumber`               | The unique identifier for the order.                                                  | Yes                     | Yes                       | string          | no max                          |
| `OrderPaymentType`          | The method of payment for the order.                                                  | Yes                     | No                        | string          | no max                          |
| `OrderPickupETA`            | The estimated time of arrival for the order pickup.                                   | Yes                     | No                        | string          | 34                              |
| `OrderReferenceNumbers`     | A list of reference numbers associated with the order.                                | Yes                     | No                        | Array of String | no max                          |
| `OrderRequiredDeliveryDate` | The required delivery date for the order.                                             | Yes                     | No                        | string          | 34                              |
| `OrderStatus`               | The current status of the order (e.g., open\_updated, fully\_delivered).              | Yes                     | No                        | string          | no max                          |
| `OrderStatusTime`           | The timestamp of the current status of the order.                                     | Yes                     | No                        | string          | 34                              |
| `OrderType`                 | The type of order (e.g., PO for Purchase Order).                                      | Yes                     | No                        | string          | 3                               |
| `createdAt`                 | The timestamp when the event was created.                                             | Yes                     | Yes                       | string          | 34                              |
| `orderTransportType`        | The type of transport used for the order (e.g., domestic).                            | Yes                     | No                        | string          | 13                              |
