---
title: "List Payment Instruments for a Client"
method: GET
path: "/v1/payment_instruments"
tags: ["Payment Instruments"]
---

# List Payment Instruments for a Client

`GET /v1/payment_instruments`

> 📘
>
> You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.

> 🚧
>
> Payment Instruments are required for Real-Time (FedNow, RTP) and T+0 Same Day ACH payment flows. Please reach out to your Astra Integration Specialist for more information.

> 🚧
>
> There may be up to a 5 minute delay in calculating the true available balance of a payment instrument.

Retrieves all Payment Instruments for a Client.

## Response `200`

Successful response

- object
  - `payment_instruments` object[]
    - `id` string — The unique ID of the Payment Instrument
    - `name` string — The Payment Instrument name
    - `account_number` string — The account number (Note - Astra-internal operational account numbers will be redacted)
    - `mask` string — The account mask
    - `routing_number` string — The routing number (Note - Astra-internal operational routing numbers will be redacted)
    - `available_balance` object — The available balance of the account
      - `amount` integer — The amount in cents
      - `currency` 'USD' — The currency type
      - `updated_at` string, date-time — The date and time when the balance was last updated (UTC)
    - `current_balance` object — The current balance of the account
      - `amount` integer — The amount in cents
      - `currency` 'USD' — The currency type
      - `updated_at` string, date-time — The date and time when the balance was last updated (UTC)
    - `created_at` string, date-time — The date and time when the Payment Instrument was created (UTC)
    - `principal` object — The principal of the account
      - `first_name` string — The first name of the principal
      - `last_name` string — The last name of the principal
      - `type` 'individual' | 'business' | 'other' — The principal type
    - `program_role` 'fee' | 'program' | 'settlement' | 'suspense' | 'reserve' — The program role
    - `status` 'approved' | 'created' | 'closed' | 'inactive' | 'pending_review' | 'rejected' | 'suspended' — The status of the Payment Instrument
    - `type` 'depository' — The account type
    - `sub_type` 'checking' | 'savings' — The account subtype
    - `updated_at` string, date-time — The date and time the Payment Instrument was last updated (UTC)

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/astra/apis/astra-developer-api.md) · [All operations](https://skmtc.net/astra/apis/astra-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astra/astra-developer-api/revisions/09f0430e5d33/schema)