---
title: "Get Payment Instrument by an ID"
method: GET
path: "/v1/payment_instruments/{id}"
tags: ["Payment Instruments"]
---

# Get Payment Instrument by an ID

`GET /v1/payment_instruments/{id}`

> 📘
>
> 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 a specific Payment Instrument for a Client.

## Path parameters

- `id` string, required

## Response `200`

Successful response

- 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
- `404` — Not Found

---

[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)