---
title: "List payout destinations"
method: GET
path: "/v1/customers/{customerId}/linked_accounts"
tags: ["Linked Accounts"]
---

# List payout destinations

`GET /v1/customers/{customerId}/linked_accounts`

## Request

- Base URL: `https://api.sandbox.alfredpay.io`
- URL: `https://api.sandbox.alfredpay.io/v1/customers/{customerId}/linked_accounts`
- Auth: one of:
  - HTTP bearer
  - API key in header `api-key` and API key in header `api-secret`

Returns the customer's registered destinations. Filter on status: a destination that isn't `VERIFIED` will be refused at payout.

## Query parameters

- `destinationType` 'BANK_ACCOUNT' | 'WALLET': What kind of thing the money lands in. Kept separate from the rail (how it gets there) and from the provider (who carries it).
- `country` 'MEX' | 'ARG' | 'BRA' | 'COL' | 'CHL' | 'PER' | 'DOM' | 'USA' | 'CHN' | 'HKG' | 'BOL' | 'PRY': ISO 3166-1 alpha-3, the only form Alfred stores, filters on, reports or emits. Compatibility rule for integrations that can only send alpha-2: any inbound `country` value in alpha-2 (path, query or body) is normalized to alpha-3 at the boundary before validation, storage or routing. Unrecognized in either form → `422 validation_error`.
- `rail` 'ACH' | 'WIRE' | 'SPEI' | 'PIX' | 'COELSA' | 'FPS' | 'CHATS' | 'WALLET': The scheme family a payment moves on. Never a country, provider or account identifier. `ACH` is any domestic batch bank transfer (US ACH, and the local clearing houses of COL, CHL, PER, BOL, PRY, DOM, CHN); `WIRE` is RTGS/SWIFT/Fedwire; `SPEI`, `PIX`, `COELSA`, `FPS` and `CHATS` are named instant schemes with their own semantics (COELSA is Argentina's instant transfer, deliberately not folded into ACH); `WALLET` is a stablecoin destination. Cash pickup is not in this release and has no rail value yet. Which rails a destination supports is derived by Alfred and returned as `supportedRails[]`; which `(country, currency, rail)` combinations are live is published by `GET /v1/countries/{country}`.
- `status` 'PENDING' | 'VERIFIED' | 'REJECTED' | 'EXPIRED' | 'REVOKED'
- `limit` integer
- `cursor` string

## Response `200`

OK

- object
  - `has_more` boolean
  - `next_cursor` string, nullable
  - `data` LinkedAccount[]
    - `id` string
    - `customerId` string
    - `destinationType` 'BANK_ACCOUNT' | 'WALLET': What kind of thing the money lands in. Kept separate from the rail (how it gets there) and from the provider (who carries it).
    - `country` 'MEX' | 'ARG' | 'BRA' | 'COL' | 'CHL' | 'PER' | 'DOM' | 'USA' | 'CHN' | 'HKG' | 'BOL' | 'PRY': ISO 3166-1 alpha-3, the only form Alfred stores, filters on, reports or emits. Compatibility rule for integrations that can only send alpha-2: any inbound `country` value in alpha-2 (path, query or body) is normalized to alpha-3 at the boundary before validation, storage or routing. Unrecognized in either form → `422 validation_error`.
    - `currency` 'USD' | 'HKD' | 'CNY' | 'MXN' | 'DOP' | 'COP' | 'BRL' | 'ARS' | 'CLP' | 'PEN' | 'BOB' | 'PYG' | 'USDC' | 'USDT': Fourteen members, reconciled to the countries a customer can be onboarded in. USDC and USDT are stablecoins and require `chain`.
    - `supportedRails` Rail[]: Derived by Alfred at registration from country and identifier type. A payout or quote must use one of these.
    - `identifierType` string, nullable
    - `identifierMasked` string, nullable: Last four characters only.
    - `holderName` string
    - `relationship` Relationship
      - `relationship_type` 'BANK_ACCOUNT_OWNERSHIP' | 'WALLET_OWNERSHIP' | 'THIRD_PARTY_BENEFICIARY': Derived by Alfred from the registered holder, never declared.
      - `relationship_status` 'PENDING' | 'VERIFIED' | 'REJECTED' | 'EXPIRED' | 'REVOKED'
      - `allowed_use_cases` string[]
      - `restrictions` string[]
      - `evidence_reference` string[]
      - `start_date` string, date-time
      - `end_date` string, date-time, nullable
    - `createdAt` string, date-time

## Changes

- **2026-11-03** `20fef4fd2ab3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation/changes/v1/customers/:customerId/linked_accounts/get.md)

---

[API](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation.md) - [All operations](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation/revisions/20fef4fd2ab3?raw)