# Retrieves payout methods in sorted (by epoch) order

Retrieves a list of the payout methods you've created for one of your sub accounts They are returned in sorted (by epoch) order (default is newest first)

Endpoint: GET /accounts/{id}/payout-methods
Version: 1.1.0
Security: secretApiKeyAuth

## Path parameters:

  - `id` (string, required)
    the account id of one of your sub accounts
    Example: "ac_b83f2653-06d7-44a9-a548-5825e8186004"

## Query parameters:

  - `ascending` (boolean)
    Control the order (newest or oldest) in which the payout methods are returned. false will arrange the results with newest first whereas true shows oldest first

  - `limit` (integer)
    Control how many items are return in a given page The max limit we allow is 25. The default is 10.
    Example: 10

  - `startsAfter` (string)
    A token to identify where to resume a subsequent paginated query. The value of the paginationToken field from that response should be supplied here, to retrieve the next page of results.
    Example: "pm_01FCTS1XMKH9FF43CAFA4CXT3P"

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string)
    The id of the payout method
    Example: "pm_01G0EYVFR02KBBVE2YWQ8AKMGJ"

  - `items.type` (string)
    Enum: "BankAccount"

  - `items.displayName` (string,null)
    A friendly name for the payout method, for display only
    Example: "Primary GBP Account"

  - `items.status` (string)
    Enum: "Pending", "Invalid", "Valid"

  - `items.invalidReason` (string,null)
    The reason why the payout method has been marked as 'Invalid'

  - `items.currency` (string)
    The three-character ISO 4217 currency code of the payout method
    Example: "GBP"

  - `items.countryCode` (string)
    The two-character ISO 3166 country code of the payout method
    Example: "GB"

  - `items.bankAccount` (object)

  - `items.bankAccount.bankIdType` (string,null)
    Enum: "RoutingNumber", "SwiftCode", "SortCode"

  - `items.bankAccount.bankId` (string,null)
    The id of the bank that the bank account is with, e.g. sort code / routing number (see bankIdType)
    Example: "0123"

  - `items.bankAccount.bankName` (string,null)
    The name of the bank that the bank account is with
    Example: "Ryft Bank Ltd"

  - `items.bankAccount.accountNumberType` (string)
    Enum: "Iban", "UnitedKingdom", "UnitedStates"

  - `items.bankAccount.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
    Example: "0001"

  - `items.bankAccount.address` (object,null)
    The address of the bank account holder

  - `items.createdTimestamp` (integer)
    The epoch timestamp (seconds) when the payout method was created
    Example: 1470989538

  - `items.lastUpdatedTimestamp` (integer)
    The epoch timestamp (seconds) when the payout method was last updated
    Example: 1470989538

## Response 400 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"

## Response 500 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"