> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usedora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Delivery Status

### 📝 Summary

This endpoint allows updating the status of a specific delivery. The status can reflect various stages of the delivery process, such as pending, in transit, completed, or failed. This is typically used when there is a change in the delivery’s current state, helping to track its progress.

***

### Requests

##### Example

<Expandable>
  ```json theme={null}
  delivery_uuid: "{{delivery_uuid}}"
  status: in_transit
  pickup_otp: "097857"
  dropoff_otp: "098798"
  note: Reason for cancellation

  ```
</Expandable>

##### Params

<Expandable>
  **Description:**

  | Name            | Location | Type   | Required | Description                       |             |           |           |
  | --------------- | -------- | ------ | -------- | --------------------------------- | ----------- | --------- | --------- |
  | `body`          | body     | object | no       | none                              |             |           |           |
  | `delivery_uuid` | body     | string | yes      | none                              |             |           |           |
  | `status`        | body     | string | yes      | accepted                          | in\_transit | delivered | cancelled |
  | `pickup_otp`    | body     | string | no       | required if status is in\_transit |             |           |           |
  | `dropoff_otp`   | body     | string | no       | required if status is delivered   |             |           |           |
  | `note`          | body     | string | no       | Reason for cancellation           |             |           |           |
</Expandable>

### Responses

| HTTP Status Code                 | Meaning                                                          | Description | Data schema |
| -------------------------------- | ---------------------------------------------------------------- | ----------- | ----------- |
| <Badge color="green">200</Badge> | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)          | none        | Inline      |
| <Badge color="red">422</Badge>   | [Bad Request](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none        | Inline      |

<ResponseExample>
  ```json sample response theme={null}
  {
  "status": "success",
  "data": {
  "uuid": "e85616da-906c-4984-8980-069e7f3b2cd9",
  "order_number": "664481112612",
  "status": "Order Accepted",
  "delivery_type": "intra_state",
  "sender_longitude": "7.4724033",
  "sender_latitude": "9.0820999",
  "customer_longitude": "7.4974495",
  "customer_latitude": "9.0339358",
  "created_at": "2023-10-30T18:45:33.000000Z",
  "customer_detail": {
    "id": "8670aeb6-8299-4f0f-8915-31c7db66a7c0",
    "customer_name": "TundeNasri",
    "customer_email": "sinoma@gmail.com",
    "customer_state_id": 304,
    "customer_phone_number": "08065302534",
    "customer_phone_code": "234",
    "customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
    "created_at": "2023-10-30T18:45:33.000000Z"
  },
  "delivery_detail": {
    "uuid": "dc09555f-42ac-426b-963c-7d301ea4deb3",
    "sender_name": "Ac Nice",
    "sender_phone": "08087168391",
    "sender_phonecode": "234",
    "sender_address": "T-pumpy estate, phase 20 lugbe, Abuja",
    "delivery_total_order_value": "10000.00",
    "delivery_number_of_parcels": 1,
    "delivery_unit_weight": "10.00",
    "created_at": "2023-10-30T18:45:33.000000Z",
    "updated_at": "2023-10-30T18:45:33.000000Z"
  },
  "items": [
    {
      "uuid": "aee2ca50-bed0-40b3-90da-534097c39f91",
      "item_description": "Freshfish",
      "item_quantity": 1,
      "item_weight": "10.00",
      "item_value": "10000.00",
      "created_at": "2023-10-30T18:45:33.000000Z"
    }
  ],
  "organization_detail": {
    "uuid": "355c96cd-aa77-459e-9107-1223bea38f9b",
    "business_address": "Aso Housing Estate, Airport road, Abuja",
    "country_id": 161,
    "state_id": 303,
    "city": "Abuja",
    "logo": "https://usedora-bucket-dev.s3.amazonaws.com/provider-logos/mwFmcQ7ppveoNULRwL3AEyKtwoHT2KViXte8AYJA.jpg",
    "created_at": "2023-10-15T10:57:05.000000Z",
    "updated_at": "2023-10-28T16:40:21.000000Z"
  }
  },
  "message": "Delivery status updated"
  }
  ```
</ResponseExample>