---
title: "List Settlement Funding Transfer Attempts"
method: GET
path: "/settlements/{settlement_id}/funding_transfer_attempts"
tags: ["Settlements"]
---

# List Settlement Funding Transfer Attempts

`GET /settlements/{settlement_id}/funding_transfer_attempts`

Lists all settlement `Funding Transfer Attempt` resources associated for the `Settlement`. A `Funding Transfer Attempt` resource is created when [requesting an instant payout of funds](/api/settlements/createsettlementfundingtransferattempt) for the `Settlement`.

## Query parameters

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

## Headers

- `Finix-Version` string

## Response `200`

List of `Funding Transfer Attempts` associated with a `Settlement`

- 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
    - `funding_transfer_attempts` SettlementFundingTransferAttempt[]
      - `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` integer — The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).
      - `application` string — ID of the `Application` the resource was created under.
      - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code.
      - `funding_transfer_id` string — The ID of the `Transfer` used to track the payout.
      - `instrument_id` string, nullable — The ID of the `Payment Instrument` to use for the instant payout.
      - `merchant_id` string — The ID of the `Merchant` resource for the `Funding Transfer Attempt`.
      - `failure_code` 'BALANCE_ACCOUNT_NOT_FOUND' | 'BALANCE_VALIDATION_FAILED' | 'INSUFFICIENT_BALANCE' | 'INVALID_BALANCE_ACCOUNT' | 'VELOCITY_LIMIT_EXCEEDED' | 'VELOCITY_RULE_NOT_FOUND' | 'VELOCITY_VALIDATION_FAILED', nullable — The error code when the `Funding Transfer Attempt` fails.
      - `failure_message` string, nullable — A human-readable message describing why the `Funding Transfer Attempt` failed. Corresponds to `failure_code`: - `BALANCE_ACCOUNT_NOT_FOUND`: Balance Account not found. Please contact support if you have questions. - `BALANCE_VALIDATION_FAILED`: Balance Validation failed. - `INSUFFICIENT_BALANCE`: Your account balance is insufficient for this operation. Please contact support if you have any questions. - `INVALID_BALANCE_ACCOUNT`: Balance Account is invalid. - `VELOCITY_LIMIT_EXCEEDED`: Dynamically generated based on the violated rule. Examples: `Daily volume limit exceeded for APPLICATION`, `Monthly count limit exceeded for RECIPIENT`, `Maximum amount exceeded for SENDER`. - `VELOCITY_RULE_NOT_FOUND`: Velocity Rule not found. Please contact support if you have any questions. - `VELOCITY_VALIDATION_FAILED`: Velocity Validation failed. Please contact support if you have any questions.
      - `state` 'PENDING' | 'FAILED' | 'SUCCEEDED' — The status of the `Funding Transfer Attempt`.
      - `settlement_id` unknown
      - `_links` object — For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.
        - `self` object — Link to the resource that was used in the request.
          - `href` string
  - `_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)