---
title: "Create a new Return"
method: POST
path: "/returns"
tags: ["Returns"]
---

# Create a new Return

`POST /returns`

Initiates a Return of an ACH or wire payment.
A full ACH addenda is not available for ACH returns because an addenda record is used for the return itself; the `addenda_info` field contains the remaining available space.
For wire returns, the `wire_instruction` field is limited to 70 characters because Newline prefixes the instructions with the original wire transaction identifier (e.g., IMAD).

## Request body

- object
  - `external_uid` string — Client supplied unique identifier. It must be unique within the customer. If the same value is given, no new resource will be created.
  - `original_transaction_uid` string, required — The transaction to be returned.
  - `requesting_customer_uid` Schema, required — unresolved $ref
  - `requestor_type` Schema, required — unresolved $ref
  - `return_reason` string, required — Freeform text (up to 140 characters) documenting the reason for return. For wire returns, this value will be sent to the other bank.
  - `ach` object
    - `ach_return_code` 'R01' | 'R02' | 'R03' | 'R04' | 'R06' | 'R09' | 'R10' | 'R16' | 'R17' | 'R20' | 'R23' | 'R29' | 'R31' — The reason an ACH payment is being returned. Required if returning an RDFI transaction. Optional if reversing an ODFI transaction.
    - `addenda_info` string — Freeform text (up to 44 characters) to attach a memo to return.
  - `wire` object
    - `wire_instructions` string — DEPRECATED. Use `return_reason` instead. Wire information for the return transaction (up to 140 characters).

## Other responses

- `400` — Creation Error
- `403` — Denied access to Returns
- `422` — Creation Error

---

[API](https://skmtc.net/newline53/apis/newline-platform-api.md) · [All operations](https://skmtc.net/newline53/apis/newline-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/newline53/newline-platform-api/revisions/54f4fe726d8f/schema)