# Settlements

A `Settlement` is a logical construct representing a collection (i.e. batch) of Settlement Entries that will get paid out to a specific [`Merchant`](#Merchants). A Settlement Entry can represent [`Transfers`](#Transfers) or [`Split Transfers`](#Split-Transfers) <br/><br/> Related Guides: [Payouts](/guides/payouts)


## List All Settlements

 - [GET /settlements](https://docs.finix.com/api/settlements/listsettlements.md): Retrieve a list of .

For details on how to query endpoints using the available parameters, see Query Parameters.

## Fetch a Settlement

 - [GET /settlements/{settlement_id}](https://docs.finix.com/api/settlements/getsettlement.md): Retrieve the details of a .

## Close a Settlement

 - [PUT /settlements/{settlement_id}](https://docs.finix.com/api/settlements/closesettlements.md): Close an accruing .

Finix, by default, creates accruing  then closes them based on your payout configurations. Use this endpoint to manually close a specific .

The closed  will not accrue any further transactions and gets immediately submitted for approval.
- This endpoint is only available to Finix Core customers. If you have any questions, please contact the Finix Support Team.
- Any refunded  get included in  as a deduction. 
-   don't get included in .
- The  minus the  equals the . The  is the amount in cents that gets deposited into the seller's bank account.

## List all Entries in a Settlement

 - [GET /settlements/{settlement_id}/entries](https://docs.finix.com/api/settlements/listsettlemententries.md): Retrieve a list of every  in a . A settlement entry is an object that describes the item inside of a settlement. Transfers, Split Transfers and Custom fees can all be represented by a Settlement Entry. 

For details on how to query endpoints using the available parameters, see Query Parameters.      

## Delete Settlement Entries

 - [DELETE /settlements/{settlement_id}/entries](https://docs.finix.com/api/settlements/removesettlemententries.md): Remove a  that makes up a .

As long as the  hasn't been funded, you can remove the  or an array of , along with its corresponding fee entry from the encompassing .

> Per the JSON API for deleting a resource, our API doesn't have a response body when removing a  from a .

## List Settlement Funding Transfers

 - [GET /settlements/{settlement_id}/funding_transfers](https://docs.finix.com/api/settlements/listsettlementfundingtransfers.md): List the funding  that were created when a  was approved that have   or .

For details on how to query endpoints using the available parameters, see Query Parameters.

## Delete Settlement Transfers

 - [DELETE /settlements/{settlement_id}/transfers](https://docs.finix.com/api/settlements/removesettlementtransfers.md): Remove one or more  objects that make up a .

As long as the  has not been funded, you can remove the  or an array of , along with its corresponding  from the encompassing .
- Funding  can't be deleted.


> Per the JSON API for deleting a resource, our API doesn't have a response body when removing a  from a .

## List all Transfers in a Settlement

 - [GET /settlements/{settlement_id}/transfers](https://docs.finix.com/api/settlements/listsettlementtransfers.md): . Use "List all Entries in a Settlement" instead.

Retrieve a list of every  in a  that has   or . This is not an exhaustive list of everything that comprises a settlement. We recommend using  List Settlement Entries.

For details on how to query endpoints using the available parameters, see Query Parameters.      

## List Settlement Funding Transfer Attempts

 - [GET /settlements/{settlement_id}/funding_transfer_attempts](https://docs.finix.com/api/settlements/listsettlementfundingtransferattempts.md): Lists all funding transfer attempts associated for the settlement. A Funding Transfer Attempt resource is created when requesting an instant payout of funds for the settlement.

## Create Settlement Funding Transfer Attempt

 - [POST /settlements/{settlement_id}/funding_transfer_attempts](https://docs.finix.com/api/settlements/createsettlementfundingtransferattempt.md): Create a funding transfer attempt for this settlement. Funding transfer attempts are used to submit funds for instant payout.