---
title: "List settlement details"
method: GET
path: "/v1/reports/settlement/details/{report_date}"
tags: ["Settlement Report"]
---

# List settlement details

`GET /v1/reports/settlement/details/{report_date}`

List details.

## Path parameters

- `report_date` string, date, required

## Query parameters

- `ending_before` string
- `page_size` integer
- `starting_after` string

## Response `200`

OK

- object
  - `data` SettlementDetail[], required
    - `account_token` string, uuid, nullable, required — Globally unique identifier denoting the account that the associated transaction occurred on.
    - `card_program_token` string, uuid, nullable, required — Globally unique identifier denoting the card program that the associated transaction occurred on.
    - `card_token` string, uuid, nullable, required — Globally unique identifier denoting the card that the associated transaction occurred on.
    - `created` string, date-time, required — Date and time when the transaction first occurred. UTC time zone.
    - `currency` string, required — Three-character alphabetic ISO 4217 code.
    - `disputes_gross_amount` integer, required — The total gross amount of disputes settlements.
    - `event_tokens` string[], required — Array of globally unique identifiers for the financial events that comprise this settlement. Use these tokens to access detailed event-level information.
    - `fee_description` string — Network's description of a fee, only present on records with type `FEE`.
    - `institution` string, required — The most granular ID the network settles with (e.g., ICA for Mastercard, FTSRE for Visa).
    - `interchange_fee_extended_precision` integer, required — The total amount of interchange in six-digit extended precision.
    - `interchange_gross_amount` integer, required — The total amount of interchange.
    - `network` 'AMEX' | 'INTERLINK' | 'MAESTRO' | 'MASTERCARD' | 'UNKNOWN' | 'VISA', required — Card network where the transaction took place.
    - `other_fees_details` object, required — The total gross amount of other fees by type.
      - `ISA` integer
    - `other_fees_gross_amount` integer, required — Total amount of gross other fees outside of interchange.
    - `report_date` string, required — Date of when the report was first generated.
    - `settlement_date` string, required — Date of when money movement is triggered for the transaction. One exception applies - for Mastercard dual message settlement, this is the settlement advisement date, which is distinct from the date of money movement.
    - `token` string, uuid, required — Globally unique identifier denoting the Settlement Detail.
    - `transaction_token` string, uuid, nullable, required — Globally unique identifier denoting the associated transaction. For settlement records with type `CLEARING`, `FINANCIAL`, or `NON_FINANCIAL`, this references a card transaction token. For settlement records with type `CHARGEBACK`, `REPRESENTMENT`, `PREARBITRATION`, `ARBITRATION`, or `COLLABORATION`, this references the dispute transaction token. May be null for certain settlement types.
    - `transactions_gross_amount` integer, required — The total amount of settlement impacting transactions (excluding interchange, fees, and disputes).
    - `type` 'ADJUSTMENT' | 'ARBITRATION' | 'CHARGEBACK' | 'CLEARING' | 'COLLABORATION' | 'FEE' | 'FINANCIAL' | 'NON_FINANCIAL' | 'PREARBITRATION' | 'REPRESENTMENT', required — The type of settlement record.
    - `updated` string, date-time, required — Date and time when the transaction first occurred. UTC time zone.
  - `has_more` boolean, required — More data exists.

## Other responses

- `400` — A parameter in the query given in the request does not match the valid queries for the endpoint.
- `401` — | | | |---|---| | User has not been authenticated | Invalid or missing API key | | API key is not active | The API key used is no longer active | | Could not find API key | The API key provided is not associated with any user | | Please provide API key in Authorization header | The Authorization header is not in the request | | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly | | Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](https://lithic.com/contact) | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege | Reach out at [lithic.com/contact](https://lithic.com/contact) |
- `422` — Unprocessable entity.
- `429` — Client has exceeded the number of allowed requests in a given time period. | | | |---|---| | Rate limited, too many requests per second | User has exceeded their per second rate limit | | Rate limited, reached daily limit | User has exceeded their daily rate limit | | Rate limited, too many keys tried | One IP has queried too many different API keys |

## Changes

- **2026-05-22** `fac001c63373` — 4 breaking, 1 warning, 1 info
  - the response property `data/items/account_token` became nullable for the status `200`
  - the response property `data/items/card_program_token` became nullable for the status `200`
  - the response property `data/items/card_token` became nullable for the status `200`
  - the response property `data/items/transaction_token` became nullable for the status `200`
  - …2 more
- **2026-04-24** `ab626b78e088` — 1 warning
  - added the new `AMEX` enum value to the `data/items/network` response property for the response status `200`

[Change history](https://skmtc.dev/lithic-com/apis/lithic-developer-api/changes/v1/reports/settlement/details/:report_date/get.md)

---

[API](https://skmtc.dev/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.dev/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)