---
updatedAt: 2026-07-20T16:18:44.000Z
agentTools:
  projectIndex: https://developers.deliverect.com/v3.0-ordering-experience/llms.txt
---

# Cancel Delivery Job

## Purpose

This endpoint allows a way of receiving notification from our partners that a job they have previously accepted is no longer possible to be dispatched by their system.

## Reason Tags

Cancelations shoud be tagged accordingly using one of the below;

| reasonTag                     | Meaning                                                                                                  |
| :---------------------------- | :------------------------------------------------------------------------------------------------------- |
| `COURIER_NO_LONGER_AVAILABLE` | There is no longer an available courier for the delivery                                                 |
| `COURIER_TRANSPORT_FAILURE`   | Courier attempted to deliver but could not because of a transport failure (e.g., a flat tire)            |
| `FOOD_ITEMS_ARE_NOT_READY`    | The order was not ready within the agreed time after pick up (between the dispatch partner and merchant) |
| `DROP_OFF_LOCATION_NOT_FOUND` | The courier could not find the delivery location                                                         |
| `CUSTOMER_UNRESPONSIVE`       | The customer did not pick up the phone nor open the door.                                                |
| `PACKAGE_SIZE_TOO_LARGE`      | The package size is too large to be delivered                                                            |

<br />

<HTMLBlock>{`
<div style="
  background-color: #f0f9f0;
  border: 1px solid #c8e6c9;
  border-radius: 12px;
  padding: 20px 24px;
  margin: 16px 0;
  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
">
  <p style="
    margin: 0 0 8px 0;
    color: #1b5e20;
    font-weight: 700;
    font-size: 16px;
    display: flex;
    align-items: center;
    gap: 8px;
  ">
    <span style="font-size: 18px;">ℹ️</span>
    Cancellation Cut-off Time
  </p>
  <p style="
    margin: 0;
    color: #2e5934;
    font-size: 15px;
    line-height: 1.6;
  ">
    You can cancel a delivery job with a valid <code>reasonTag</code> at any point before its status changes to <code>Delivered</code>.
  </p>
</div>
`}</HTMLBlock>

<br />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Dispatch  API",
    "description": " We team up with the best global third-party delivery apps, seamlessly consolidating all your channels into one simple system.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.staging.deliverect.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Endpoints",
      "description": "(Deliverect Endpoints)"
    }
  ],
  "paths": {
    "/fulfillment/cancel": {
      "post": {
        "tags": [
          "Endpoints"
        ],
        "summary": "Cancel Delivery Job",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "deliveryJobId": {
                    "type": "string"
                  },
                  "reasonTag": {
                    "type": "string",
                    "enum": [
                      "COURIER_NO_LONGER_AVAILABLE",
                      "COURIER_TRANSPORT_FAILURE",
                      "FOOD_ITEMS_ARE_NOT_READY",
                      "DROP_OFF_LOCATION_NOT_FOUND",
                      "CUSTOMER_UNRESPONSIVE",
                      "PACKAGE_SIZE_TOO_LARGE"
                    ]
                  },
                  "deliveryFeeCharged": {
                    "type": "integer"
                  },
                  "extraDescription": {
                    "type": "string"
                  }
                }
              },
              "examples": {
                "Cancel Example": {
                  "summary": "Cancel Example",
                  "value": {
                    "deliveryJobId": "648******************874",
                    "reasonTag": "CUSTOMER_UNRESPONSIVE",
                    "deliveryFeeCharged": 4500,
                    "extraDescription": "Tried many times"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Ok",
            "content": {
              "application/json": {
                "examples": {
                  "OK": {
                    "summary": "OK",
                    "value": ""
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {}
                },
                "examples": {
                  "Bad Request": {
                    "summary": "Bad Request",
                    "value": "{}"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```