---
title: "Fail a Delivery"
method: POST
path: "/v3/deliveries/{deliveryId}/fail"
tags: ["Delivery"]
---

# Fail a Delivery

`POST /v3/deliveries/{deliveryId}/fail`

Fails the specified Delivery. This link is included when a Transaction is retrieved from a <a href="https://docs.orderful.com/reference/pollingcontroller_list" target="_blank">Poller Bucket</a> or via an <a href="https://docs.orderful.com/docs/inbound-http" target="_blank">Inbound HTTP Communication Channel</a>. 

If this Delivery is the most recent one associated with a Transaction, this will update the Transaction's `deliveryStatus` to `FAILED`.

If this Delivery is associated with one or more Transactions in a Poller Bucket, this will also remove the Transactions from that Bucket.

## Path parameters

- `deliveryId` string, required

## Request body

- FailDeliveryRequestDto
  - `note` string

## Response `200`

---

[API](https://skmtc.dev/orderful/apis/orderful-api.md) · [All operations](https://skmtc.dev/orderful/apis/orderful-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orderful/orderful-api/revisions/c2e12b39b4e1/schema)