---
title: "Retrieve a payout method by Id"
method: GET
path: "/accounts/{id}/payout-methods/{payoutMethodId}"
tags: ["Payout Methods"]
---

# Retrieve a payout method by Id

`GET /accounts/{id}/payout-methods/{payoutMethodId}`

This is used to fetch a payout method by its unique Id for one of your sub accounts

## Path parameters

- `id` string, required
- `payoutMethodId` string, required

## Response `200`

Successfully retrieved the given payout method

- PayoutMethod
  - `id` string — The id of the payout method
  - `type` 'BankAccount'
  - `displayName` string, nullable — A friendly name for the payout method, for display only
  - `status` 'Invalid' | 'Valid'
  - `invalidReason` string, nullable — The reason why the payout method has been marked as 'Invalid'
  - `currency` string — The three-character ISO 4217 currency code of the payout method
  - `countryCode` string — The two-character ISO 3166 country code of the payout method
  - `bankAccount` BankAccount
    - `bankIdType` 'RoutingNumber' | 'SwiftCode' | 'SortCode' | 'BSBCode' | 'BankCode', nullable
    - `bankId` string, nullable — The id of the bank that the bank account is with, e.g. sort code / routing number (see `bankIdType`)
    - `branchIdType` 'TransitNumber', nullable — The types of branch ID for bank accounts.
    - `branchId` string, nullable — The id of the branch that the bank account is with, see BranchIdType for types.
    - `bankName` string, nullable — The name of the bank that the bank account is with
    - `swiftCode` string, nullable — The Swift code / BIC of the bank
    - `accountNumberType` 'Iban' | 'UnitedKingdom' | 'Domestic'
    - `last4` string — The last 4 digits of the account number for the bank account. This is the account number or IBAN of the bank account, depending on the currency + country of the payout method
    - `address` object, nullable — The address of the bank account holder
      - `lineOne` string, nullable — First line of the address. It must satisfy the following regex pattern: ^[A-Za-z0-9 !&'()+,-./:;]*$
      - `lineTwo` string, nullable — Second line of the address. It must satisfy the following regex pattern: ^[A-Za-z0-9 !&'()+,-./:;]*$
      - `city` string, nullable — The address city/town It must satisfy the following regex pattern: ^[A-Za-z0-9 !&'()+,-./:;]*$
      - `country` string — The two-character ISO country code
      - `postalCode` string, nullable — The postal/zip code of the address. It must satisfy the following regex pattern: ^[A-Za-z0-9 -]*$
      - `region` string, nullable — The state/county/province/region Required if the address is in the US/Canada and must be a 2-character ISO state/province code Otherwise it must satisfy the following regex pattern: ^[A-Za-z0-9 !&'()+,-./:;]*$
  - `createdTimestamp` integer — The epoch timestamp (seconds) when the payout method was created
  - `lastUpdatedTimestamp` integer — The epoch timestamp (seconds) when the payout method was last updated

## Other responses

- `404` — The given resource could not be found
- `500` — An unexpected error occurred when executing this request

---

[API](https://skmtc.net/ryftpay/apis/ryft-payment-api.md) · [All operations](https://skmtc.net/ryftpay/apis/ryft-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ryftpay/ryft-payment-api/versions/a042f64d4305/schema)