List Instruments
List payment instruments across all beneficiaries in your merchant scope.
Use the beneficiary_id filter to narrow to a single beneficiary (or call
GET /v1/beneficiaries/{id}/instruments, which returns the same result).
Authorizations
Per-request DPoP proof JWT (RFC 9449). MUST accompany the Authorization: DPoP <access_token> header on every protected operation. The proof is signed by the merchant's private DPoP key and carries htm, htu, iat, jti, and ath claims.
Query Parameters
Items per page. Maximum 100.
1 <= x <= 100Opaque cursor returned by a previous list response. Omit for the first page.
^ben_[a-zA-Z0-9]+$Credential format of a payment instrument — named by what data is stored, not by the rail that delivers the funds. One credential type can route to multiple rails (e.g. an IBAN can go via SEPA, SEPA Instant, TARGET2, SWIFT, or CHAPS — the rail is selected at payout time).
Query GET /v1/payment-methods for the full country-specific catalog
including per-method credential schemas.
iban, uk_bank, us_bank, ca_bank, au_bank, nz_bank, jp_bank, in_bank, za_bank, ng_bank, ph_bank, cl_bank, co_bank, swift, clabe, cbu, cci, pix, upi, interac, paynow, fps_hk, promptpay, card, crypto, mobile_money ISO 4217 three-letter currency code.
^[A-Z]{3}$"USD"
ISO 3166-1 alpha-2 country code.
^[A-Z]{2}$"US"
active, disabled Substring match on the instrument's display fields (label, masked account, bank).