---
title: "List Inbound FedNow Transfers"
method: GET
path: "/inbound_fednow_transfers"
---

# List Inbound FedNow Transfers

`GET /inbound_fednow_transfers`

## Query parameters

- `cursor` string — Return the page of entries after this one.
- `limit` integer — Limit the size of the list that is returned. The default (and maximum) is 100 objects.
- `account_id` string — Filter Inbound FedNow Transfers to those belonging to the specified Account.
- `account_number_id` string — Filter Inbound FedNow Transfers to ones belonging to the specified Account Number.
- `created_at.after` string, date-time — Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.before` string, date-time — Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_after` string, date-time — Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_before` string, date-time — Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.

## Response `200`

Inbound FedNow Transfer List

- InboundFednowTransferList — A list of Inbound FedNow Transfer objects.
  - `data` InboundFednowTransfer[], required — The contents of the list.
    - `account_id` string, required — The Account to which the transfer was sent.
    - `account_number_id` string, required — The identifier of the Account Number to which this transfer was sent.
    - `amount` integer, required — The amount in USD cents.
    - `confirmation` object, nullable, required — If your transfer is confirmed, this will contain details of the confirmation.
      - `transfer_id` string, required — The identifier of the FedNow Transfer that led to this Transaction.
    - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was created.
    - `creditor_name` string, required — The name the sender of the transfer specified as the recipient of the transfer.
    - `currency` 'USD', required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code of the transfer's currency. This will always be "USD" for a FedNow transfer.
    - `debtor_account_number` string, required — The account number of the account that sent the transfer.
    - `debtor_name` string, required — The name provided by the sender of the transfer.
    - `debtor_routing_number` string, required — The routing number of the account that sent the transfer.
    - `decline` object, nullable, required — If your transfer is declined, this will contain details of the decline.
      - `reason` 'account_number_canceled' | 'account_number_disabled' | 'account_restricted' | 'group_locked' | 'entity_not_active' | 'fednow_not_enabled', required — Why the transfer was declined.
      - `transfer_id` string, required — The identifier of the FedNow Transfer that led to this declined transaction.
    - `id` string, required — The inbound FedNow transfer's identifier.
    - `status` 'pending_confirming' | 'timed_out' | 'confirmed' | 'declined' | 'requires_attention', required — The lifecycle status of the transfer.
    - `transaction_id` string, nullable, required — The identifier of the Transaction object created when the transfer was confirmed.
    - `type` 'inbound_fednow_transfer', required — A constant representing the object's type. For this resource it will always be `inbound_fednow_transfer`.
    - `unique_end_to_end_transaction_reference` string, nullable, required — The Unique End-to-end Transaction Reference ([UETR](https://www.swift.com/payments/what-unique-end-end-transaction-reference-uetr)) of the transfer.
    - `unstructured_remittance_information` string, nullable, required — Additional information included with the transfer.
  - `next_cursor` string, nullable, required — A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/increase/apis/increase-api-2.md) · [All operations](https://skmtc.net/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api-2/versions/e968bcd4dcf9/schema)