---
title: "Cancel a Transfer"
method: PUT
path: "/transfers/{uid}/cancel"
tags: ["Transfers"]
---

# Cancel a Transfer

`PUT /transfers/{uid}/cancel`

Transfers must be canceled by the originating Customer (or Authorized Representative).

Transfers can only enter the canceled state if Newline receives a request while the Transfer is in `queued` or `pending states`.

A cancellation request during the `pending` state is not guaranteed, as this state may include payment execution. At that stage, a cancel request will result in an error.

## Request body

- object
  - `authorized_representative_name` string — Name of the authorized representative who wants to cancel the transfer. Max 35 characters.
  - `cancellation_reason` string — Reason for cancellation. Max 135 characters.

## Response `200`

The updated Transfer resource is returned

- Schema — unresolved $ref

## Other responses

- `400` — The transfer is not eligible for cancellation
- `422` — The transfer could not be canceled

---

[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)