# Retrieve transactions linked to a settlement

Returns a list of transactions that are linked to a specific settlement by its unique identifier.

Endpoint: GET /settlements/{id}/transactions
Version: 1.0.0
Security: JWT

## Security:

  - `JWT` (unknown)
    http bearer JWT

## Path parameters:

  - `id` (string, required)
    The unique identifier of the settlement. Starts with `setl_` followed by letters and digits. An ID of any other shape is rejected with `400` and a message saying it must start with `setl_`; a well-formed ID that doesn't match a settlement on your account returns `404`.

## Query parameters:

  - `before` (string)
    Return only resources created at or before this time. Send an [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp with an offset, such as `2025-02-18T12:03:44Z` or `2025-02-18T17:33:44+05:30`. A timestamp without an offset is read as UTC. A bare date (`YYYY-MM-DD`) means the end of that day in UTC (`23:59:59.999999Z`). An invalid value returns `400 Bad Request`. Use this to avoid page drift. See [Pagination parameters](/platform/pagination#parameters) for more details.

  - `after` (string)
    Return only resources created at or after this time. Send an [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp with an offset, such as `2025-01-18T12:03:44Z` or `2025-01-18T17:33:44+05:30`. A timestamp without an offset is read as UTC. A bare date (`YYYY-MM-DD`) means the start of that day in UTC (`00:00:00Z`). An invalid value returns `400 Bad Request`. Use this to avoid page drift. See [Pagination parameters](/platform/pagination#parameters) for more details.

  - `per_page` (integer)
    Number of resources per page. Should be between 1 and 100.

  - `page` (integer)
    Page number for pagination. Starts from 1. Get the next page number from the `next` field in the response.

## Response 200:

  - `200` (unknown)
    List of Transactions matching the filters

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string)
    The unique identifier for the transaction.
    Example: txn_687f1f8ePcIYg

  - `data.source_id` (string)
    The unique identifier of the source for the transaction.
    Example: payt_687f1f833Hdgx

  - `data.source_type` (string)
    The type of the source for the transaction.
    Example: payment

  - `data.transaction_type` (string)
    The direction of the transaction. A credit adds to your balance. A debit takes from it.
    Enum: "credit", "debit"

  - `data.credit` (object)
    The credit details for the transaction, with `amount` in the smallest unit of `currency`.

  - `data.credit.amount` (number)
    The amount credited, in the smallest unit of `currency` (cents for USD). `1000` is $10.00 when `currency` is USD.
    Example: 1000

  - `data.credit.currency` (string)
    The currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, USD.
    Example: USD

  - `data.debit` (object)
    The debit details for the transaction, with `amount` in the smallest unit of `currency`.

  - `data.debit.amount` (number)
    The amount debited, in the smallest unit of `currency` (cents for USD). `1000` is $10.00 when `currency` is USD.
    Example: 0

  - `data.debit.currency` (string)
    The currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, USD.
    Example: USD

  - `data.fees` (object)
    The fees associated with the transaction.

  - `data.fees.fx_fee` (object)
    The foreign-exchange fee charged for the transaction in cents.

  - `data.fees.fx_fee.amount` (number)
    The foreign exchange fee, in the smallest unit of this fee's `currency` (cents for USD). `10` is $0.10 when that currency is USD.
    Example: 10

  - `data.fees.fx_fee.currency` (string)
    The currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, USD.
    Example: USD

  - `data.fees.txn_fee` (object)
    The transaction fee charged for the transaction in cents.

  - `data.fees.txn_fee.amount` (number)
    The transaction fee, in the smallest unit of this fee's `currency` (cents for USD). `10` is $0.10 when that currency is USD.
    Example: 10

  - `data.fees.txn_fee.currency` (string)
    The currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, USD.
    Example: USD

  - `data.settled_amount` (object)
    The details of the amount settled in this transaction, with `amount` in the smallest unit of `currency`.

  - `data.settled_amount.amount` (number)
    The amount settled, in the smallest unit of `currency` (cents for USD). `980` is $9.80 when `currency` is USD.
    Example: 980

  - `data.settled_amount.currency` (string)
    The currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, USD.
    Example: USD

  - `data.processed_at` (string)
    When the transaction was processed, as an ISO 8601 date-time in UTC.
    Example: 2024-12-06T11:38:37.130Z

  - `data.created_at` (string)
    When the transaction was created, as an ISO 8601 date-time in UTC.
    Example: 2024-12-06T11:38:37.130Z

  - `data.updated_at` (string)
    When the transaction was last updated, as an ISO 8601 date-time in UTC.
    Example: 2024-12-06T11:38:37.130Z

  - `page_meta` (object)

  - `page_meta.current` (integer)
    The current page number.
    Example: 2

  - `page_meta.previous` (integer | null)
    The previous page number.
    Example: 1

  - `page_meta.next` (integer | null)
    The next page number.
    Example: 3

  - `page_meta.per_page` (integer)
    The number of items per page.
    Example: 20

  - `page_meta.pages` (integer)
    The total number of pages.
    Example: 10

  - `page_meta.count` (integer)
    The total number of items.
    Example: 200

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 400 fields (application/json):

  - `error` (string)
    Enum: "Bad Request"

  - `message` (string)
    Error message indicating which parameter was invalid

## Response 404:

  - `404` (unknown)
    Settlement not found

## Response 404 fields (application/json):

  - `error` (string)
    Enum: "Not found"

  - `message` (string)
    Entity not found
    Enum: "Entity not found"