---
title: "Delete Settlement Transfers"
method: DELETE
path: "/settlements/{settlement_id}/transfers"
tags: ["Settlements"]
---

# Delete Settlement Transfers

`DELETE /settlements/{settlement_id}/transfers`

> ##### <u>This endpoint is deprecated</u>.<br/>
> Use [Delete Settlement Entries](/api/settlements/removeSettlementEntries) instead.
---

Remove one or more `Transfer` objects that make up a `Settlement`.

As long as the `Settlement` has not been funded, you can remove the `Transfer` or an array of `Transfers`, along with its corresponding `Fee` from the encompassing `Settlement`.

Funding `transfers` cannot be deleted.

The response body is empty after sending a successful delete request.

## Headers

- `Finix-Version` string

## Request body

- DeleteSettlementTransfers
  - `transfers` string[] — The ID of `Transfer` resource.

## Response `204`

No Content. The settlement `Transfer` was successfully removed.

## Other responses

- `401` — Unauthorized. Authentication is required and has failed or has not been provided.
- `403` — Forbidden. The client is authenticated but does not have permission to access the resource.
- `404` — Not Found. The requested resource could not be found on the server.
- `406` — Not Acceptable. The server could not accept the submitted request. Confirm how the request was formatted and submitted.

---

[API](https://skmtc.net/finix/apis/finix-api-reference.md) · [All operations](https://skmtc.net/finix/apis/finix-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finix/finix-api-reference/versions/5426f6f99c52/schema)
