Skip to main content
GET
/
fednow
List FedNow Payments
curl --request GET \
  --url https://api.treasuryprime.com/fednow \
  --header 'Authorization: Basic <encoded-value>'
{
  "data": [
    {
      "account_id": "acct_11kpbg3r130zjwr",
      "amount": "100.00",
      "bank_id": "bank_acme",
      "created_at": "2024-01-01T00:00:00Z",
      "currency": "USD",
      "description": "FedNow transfer 202503243211779688172026683739635",
      "error": null,
      "external_account_number": "123456789",
      "external_name": "John Doe",
      "external_routing_number": "987654321",
      "external_status": "pending",
      "fed_settlement_date": "2024-01-01",
      "id": "fednow_11ky35224fez5zb",
      "memo": "Cherry trees",
      "org_id": "org_acme",
      "originator_name": "Jane Doe",
      "payment_id": "202503243211779688172026683739635",
      "payment_type": "debit",
      "related_fednow_ids": [
        "202503243211779688172026683739633",
        "202503243211779688172026683739634"
      ],
      "security_context": {
        "device_id": "a1b2c3d4e5f6",
        "ip_address": "192.168.1.1",
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
      },
      "status": "pending",
      "updated_at": "2024-01-01T00:00:00Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

​
account_id
string

ID of the account. Filterable.

​
bank_id
string

ID of the bank. Filterable.

​
external_account_number
string

External account number. Filterable.

​
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.

​
org_id
string

ID of the organization. Filterable.

​
payment_id
string

FedNow payment ID. Filterable.

​
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.

​
page_cursor
string

Pagination cursor, value is the object ID.

​
page_size
integer
default:100

Limits the number of objects in the returned list, value must be a number greater than or equal to 1. Defaults to 100.

Required range: x >= 1
​
from_date
string

Lists the objects created on the date provided and onwards. Date must be in ISO 8601 format (“YYYY-MM-DD”).

​
to_date
string

Lists the objects created before the date provided. Date must be in ISO 8601 format (“YYYY-MM-DD”).

Response

200 - application/json

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.

​
data
object[]