---
title: "Get payment instrument by its ID"
method: GET
path: "/v2/payment-instruments/{id}"
tags: ["Payments instruments"]
---

# Get payment instrument by its ID

`GET /v2/payment-instruments/{id}`

## Request

- Base URL: `https://api.sandbox.payall.com`
- URL: `https://api.sandbox.payall.com/v2/payment-instruments/{id}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/v2/oauth/token`

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- union
  - MobileWallet: Abstract class. Use it's implementations instead.
    - `id` string, uuid
    - `category` 'BankAccount' | 'MobileWallet' | 'CashPickup' | 'Card', required
    - `currency` string
    - `mobile_number` string, required
    - `phone_operator` string
  - BankAccount: Abstract class. Use it's implementations instead.
    - `id` string, uuid
    - `category` 'BankAccount' | 'MobileWallet' | 'CashPickup' | 'Card', required
    - `currency` string
    - `routing_number` string
    - `swift_bic_code` string
    - `bank_domestic_code` string
    - `iban` string
    - `swift_intermediary` string
    - `routing_number_intermediary` string
    - `iban_intermediary` string
    - `account_id` string
    - `bank_name` string
    - `bank_branch_name` string
    - `bank_branch_code` string
    - `bank_country` string
    - `bank_address` string
    - `account_number` string
    - `sub_account_number` string
    - `account_type` string
    - `account_name` string
    - `urgency_flag_preference` string
  - CashPickup: Abstract class. Use it's implementations instead.
    - `id` string, uuid
    - `category` 'BankAccount' | 'MobileWallet' | 'CashPickup' | 'Card', required
    - `currency` string
    - `service_provider_name` string
    - `first_name` string
    - `last_name` string
  - Card: Abstract class. Use it's implementations instead.
    - `id` string, uuid
    - `category` 'BankAccount' | 'MobileWallet' | 'CashPickup' | 'Card', required
    - `currency` string
    - `token` string, uuid, required: Card token can be generated using Payall Vault iframe or API. Unencrypted card data should never be sent to this API directly.
    - `masked_number` string

## Other responses

- `404`: Payment instrument not found

---

[API](https://skmtc.dev/payall/apis/payall-m2m-authentication-api.md) - [All operations](https://skmtc.dev/payall/apis/payall-m2m-authentication-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payall/apis/payall-m2m-authentication-api/revisions/5f561eccd6ce?raw)