---
title: "Approve, receive, refund or reject a return"
method: POST
path: "/v1/returns/{id}/status"
---

# Approve, receive, refund or reject a return

`POST /v1/returns/{id}/status`

## Request

- Base URL: `https://api.octapi.app`
- URL: `https://api.octapi.app/v1/returns/{id}/status`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `status` 'requested' | 'approved' | 'received' | 'refunded' | 'rejected', required
  - `refund_cents` integer, nullable
  - `note` string, nullable

## Response `200`

Default Response

- unknown

---

[API](https://skmtc.dev/octapi/apis/octapi-api.md) · [All operations](https://skmtc.dev/octapi/apis/octapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/octapi/apis/octapi-api/revisions/580afda787d2?raw)