---
title: "List all Entries in a Settlement"
method: GET
path: "/settlements/{settlement_id}/entries"
tags: ["Settlements"]
---

# List all Entries in a Settlement

`GET /settlements/{settlement_id}/entries`

Retrieve a list of every `Settlement Entry` in a `Settlement`. A `Settlement Entry` is an object that describes the item inside of a `Settlement`.

A `Settlement Entry` can represent a [Transfer](/api/transfers), custom [Fee](/api/fees), or [Split Transfer](/api/split-transfers).

## Query parameters

- `after_cursor` string
- `before_cursor` string
- `created_at.gte` string, date-time
- `created_at.lte` string, date-time
- `limit` integer
- `updated_at.gte` string, date-time
- `updated_at.lte` string, date-time

## Headers

- `Finix-Version` string

## Response `200`

List of `Settlement Entry` resources

- object
  - `page` Page — Details the page that's returned.
    - `limit` integer — The number of entries to return.
    - `next_cursor` string, nullable — The cursor to use for the next page of results.
  - `_embedded` object
    - `settlement_entries` SettlementEntry[]
      - `id` string — The ID of the resource.
      - `created_at` string, date-time — Timestamp of when the object was created.
      - `updated_at` string, date-time — Timestamp of when the object was last updated.
      - `amount` number, double — The amount of the `Settlement Entry`.
      - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code.
      - `entity_id` string — The ID of the related entity.
      - `entity_details` object — An object containing additional details about the entity.
        - `fee_category` 'PROCESSOR' | 'INTERCHANGE' | 'DUES_AND_ASSESSMENTS' | 'THIRD_PARTY_SERVICE_PROVIDER', nullable — The category of the fee.
      - `entity_type` 'TRANSFER' | 'CUSTOM_FEE' | 'SPLIT_TRANSFER' | 'FEE' — The type of the related entity.
      - `parent_entity_id` string — The ID of the original parent resource where the transaction occurred. This is only populated when `sub_type` is `FEE`.
      - `parent_entity_type` 'TRANSFER' — The type of the original parent resource where the transaction occurred. This is only populated when `sub_type` is `FEE`.
      - `subtype` 'DEBIT' | 'CREDIT' | 'FEE' | 'REVERSAL' | 'ADJUSTMENT' | 'DISPUTE' | 'DISPUTE_MERCHANT_DEBIT' | 'DISPUTE_MERCHANT_CREDIT' | 'CUSTOM' — The subtype of the `Settlement Entry`. - `DISPUTE_MERCHANT_DEBIT`: A `Settlement Entry` for a [Split Transfer](/api/split-transfers) created when a [Dispute](/api/disputes) pulls funds from a merchant proportionally. Only applies when `entity_type` is `SPLIT_TRANSFER`. - `DISPUTE_MERCHANT_CREDIT`: A `Settlement Entry` for a `Split Transfer` created when a `Dispute` is ruled in favor of the [Merchant](/api/merchants) and funds are returned proportionally. Only applies when `entity_type` is `SPLIT_TRANSFER`.
      - `ready_to_settle_at` string, date-time, nullable — The timestamp of when the `Settlement Entry` is ready to be settled.
      - `should_fund` boolean — Indicates whether funds should be moved for this `Settlement Entry`.
  - `_links` object
    - `self` Self — Link to the resource that was used in the request.
      - `href` string
    - `next` Next — Link to the next page of entries.
      - `href` string

## 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.
- `422` — Unprocessable Entity. One or more query parameters were syntactically valid but could not be processed.

---

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