---
title: "List all external accounts"
method: GET
path: "/v2/users/{userId}/external-accounts"
tags: ["External Account"]
---

# List all external accounts

`GET /v2/users/{userId}/external-accounts`

## Request

- Base URL: `https://production.hifibridge.com`
- URL: `https://production.hifibridge.com/v2/users/{userId}/external-accounts`
- Auth: HTTP bearer

List all external accounts associated with a user. Supports cursor-based pagination.

## Path parameters

- `userId` string, required

## Query parameters

- `limit` string
- `createdBefore` string, date
- `createdAfter` string, date

## Response `200`

Success

- ExternalAccountListObject
  - `accounts` ExternalAccountObject[]
    - `id` string, uuid: Unique identifier for the external account
    - `userId` string, uuid: User ID associated with this account
    - `requestId` string, uuid: Request ID used for deduplication
    - `direction` 'payin' | 'payout': Direction of transfers
    - `status` 'active' | 'inactive' | 'pending': Current status of the account
    - `country` string: ISO 3166-1 alpha-3 country code
    - `currency` string: Currency code
    - `rail` 'ach' | 'wire' | 'swift' | 'sepa' | 'pix' | 'spei' | 'momo': Payment rail
    - `accountHolder` ExternalAccountHolder: Account holder information
      - `type` 'individual' | 'business', required: Type of account holder
      - `name` string, required: Full name of account holder
      - `email` string, email: Email address
      - `phone` string: Phone number in E.164 format
      - `address` ExternalAccountAddress: Address information
        - `addressLine1` string, required: Primary address line
        - `addressLine2` string: Secondary address line (apartment, suite, etc.)
        - `city` string, required: City name
        - `stateProvinceRegion` string, required: State, province, or region
        - `postalCode` string, required: Postal or ZIP code
        - `country` string, required: ISO 3166-1 alpha-3 country code
    - `accountDetails` object: Bank details (fields vary by rail)
    - `createdAt` string, date-time: Timestamp when the account was created
    - `updatedAt` string, date-time: Timestamp when the account was last updated
  - `count` integer: Number of accounts returned
  - `nextCursor` string, nullable: Cursor for the next page of results (null if no more results)

## Other responses

- `401`: Unauthorized
- `500`: Internal Server Error

## Changes

- **2026-11-03** `319fa6bd5bc6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hifi/apis/hifi-api/changes/v2/users/:userId/external-accounts/get.md)

---

[API](https://skmtc.dev/hifi/apis/hifi-api.md) - [All operations](https://skmtc.dev/hifi/apis/hifi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hifi/apis/hifi-api/revisions/319fa6bd5bc6?raw)