---
title: "Update External Transfer Status"
method: PATCH
path: "/external-transfers/{externalTransferId}/status"
tags: ["External Transfers"]
---

# Update External Transfer Status

`PATCH /external-transfers/{externalTransferId}/status`

## Request

- Base URL: `https://partner-api.getpliant.com/api`
- URL: `https://partner-api.getpliant.com/api/external-transfers/{externalTransferId}/status`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/getpliant/apis/pliant-customer-api/docs/external-transfers/:externalTransferId/status/patch.ts> (a function with typed inputs; its response is checked against the schema)

Update the status of an existing external transfer. This endpoint allows you to change the transfer status, for example to approve, reject, or mark as paid.

The available status transitions depend on the current status of the transfer and your organization's configuration.

## Path parameters

- `externalTransferId` string, uuid, required

## Request body

- object
  - `status` 'DRAFT' | 'NEEDS_APPROVAL' | 'APPROVED' | 'COMPLIANCE_CHECK' | 'COMPLIANCE_PASSED' | 'COMPLIANCE_REVIEW' | 'PAYMENT_IN_PROGRESS' | 'PAID' | 'FAILED', required: The new status for the external transfer. It can be one of the following values: - `DRAFT`: Transfer is in draft state and can be modified - `NEEDS_APPROVAL`: Transfer requires approval before processing - `APPROVED`: Transfer has been approved and is ready for processing - `COMPLIANCE_CHECK`: Transfer is undergoing compliance checks - `COMPLIANCE_PASSED`: Transfer has passed compliance checks - `COMPLIANCE_REVIEW`: Transfer is under compliance review - `PAYMENT_IN_PROGRESS`: Transfer is currently being processed - `PAID`: Transfer has been successfully completed - `FAILED`: Transfer has failed

## Response `200`

Ok

- Schema (unresolved $ref)

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `403` (unresolved $ref)
- `404` (unresolved $ref)
- `409` (unresolved $ref)
- `429` (unresolved $ref)
- `500` (unresolved $ref)

## Changes

- **2026-11-03** `a4fbf7d068b4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getpliant/apis/pliant-customer-api/changes/external-transfers/:externalTransferId/status/patch.md)

---

[API](https://skmtc.dev/getpliant/apis/pliant-customer-api.md) - [All operations](https://skmtc.dev/getpliant/apis/pliant-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getpliant/apis/pliant-customer-api/revisions/a4fbf7d068b4?raw)