# Confirm Return

Allows store staff to confirm the status of an order return — whether the order was fully returned, partially returned, or not returned at all. Optionally triggers a customer notification via email and/or SMS on confirmation.

***

## Endpoint

```
PATCH {{domain}}/{{tenant_id}}/deliveries/{{delivery_id_or_reference}}/confirm-return
```

**Authentication:** Bearer token required via the `Authorization` header.

***

## Path Parameters

| Parameter                  | Description                                                                         |
| -------------------------- | ----------------------------------------------------------------------------------- |
| `delivery_id_or_reference` | The Rendr `id` or your own `reference` of the delivery being confirmed as returned. |

***

## Request Payload

```json title="PATCH /{{tenant_id}}/deliveries/{{delivery_id_or_reference}}/confirm-return"
{
    "note": "all_return",
    "notification_channels": [
        "email",
        "sms"
    ]
}
```

## Request Fields

| Field                   | Type   | Required | Description                                                                                               |
| ----------------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------- |
| `note`                  | String | Yes      | The return outcome. Accepted values: `all_return`, `partial_return`, `no_return`.                         |
| `notification_channels` | Array  | No       | Notification channels to use when confirming the return to the customer. Accepted values: `email`, `sms`. |