---
title: "List FedNow Payments"
method: GET
path: "/fednow"
tags: ["FedNow"]
---

# List FedNow Payments

`GET /fednow`

## Query parameters

- `account_id` string
- `bank_id` string
- `external_account_number` string
- `external_status` string
- `org_id` string
- `payment_id` string
- `status` string
- `page_cursor` string
- `page_size` integer
- `from_date` string
- `to_date` string

## Response `200`

A dictionary with a `data` property that contains a list of up to `page_size` fednow elements, starting after the fednow described by `page_cursor`. If no more fednows are available, the resulting list will be empty.

- object
  - `data` object[]
    - `account_id` string — ID of the account. Filterable.
    - `amount` string — Amount of the payment
    - `bank_id` string — ID of the bank. Filterable.
    - `created_at` string — When this object was created
    - `currency` string — Currency of the payment
    - `description` string — Optional description of the payment
    - `error` string — Error message describing why the payment failed
    - `external_account_number` string — External account number. Filterable.
    - `external_name` string — External account name
    - `external_reject_reason` object — Rejection reason information for rejected payments. Only present for payments rejected by FedNow or counterparty.
      - `reason_code` string — ISO 20022 or FedNow proprietary reason code for rejected payments.
      - `reason_description` string — Description of the rejection reason code.
    - `external_routing_number` string — External routing number
    - `external_status` string — Status of originated payment at the external account. Only populated for sent payments. One of `pending`, `processing`, `done`, `rejected`, `blocked`, or `error`. Filterable.
    - `fed_settlement_date` string — Settlement date from FedNow
    - `id` string — Unique identifier for object
    - `memo` string — Optional memo for the payment
    - `org_id` string — ID of the organization. Filterable.
    - `originator_name` string — Optional sender name for the payment
    - `payment_id` string — FedNow payment ID. Filterable.
    - `payment_type` string — One of `credit` or `debit`
    - `related_fednow_ids` string[] — An array of IDs for related FedNow payments
    - `security_context` object — Context for this submission
      - `device_id` string — Unique identifier for the device
      - `ip_address` string — IP address of the user
      - `user_agent` string — User agent string of the client
    - `status` string — One of `pending`, `processing`, `sent`, `done`, or `error`. The available values for status are driven by payment type. Successful credits (incoming) terminate in `done`. Debits (outgoing) terminate in `sent`. Filterable.
    - `updated_at` string — When this object was last updated

---

[API](https://skmtc.net/treasuryprime/apis/account.md) · [All operations](https://skmtc.net/treasuryprime/apis/account/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasuryprime/account/versions/95a3c69c14e8/schema)