# Get account by ID

Retrieves the details of a specific account by its ID.

Endpoint: GET /v1/collections/accounts/{account_id}
Version: 1.0.0
Security: Bearer

## Path parameters:

  - `account_id` (string, required)
    Unique identifier of the account to retrieve
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier for the account
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `account_owner_id` (string, required)
    Unique identifier of the account owner can be customer or partner
    Example: "291ecf34-a01d-466a-b0fd-662a88b7a1bb"

  - `beneficiary` (object)
    The beneficiary this account belongs to, including their name so you don't need a separate lookup to display it

  - `beneficiary.id` (string)
    Unique identifier of the beneficiary
    Example: "291ecf34-a01d-466a-b0fd-662a88b7a1bb"

  - `beneficiary.name` (string)
    Name of the beneficiary
    Example: "Hong Kong Exports Ltd."

  - `beneficiary.email` (string)
    Email address of the beneficiary, if available
    Example: "hongkong@exports.com"

  - `customer_id` (string)
    The customer this account belongs to
    Example: "87a6b830-1bbe-409c-9bff-9cf12bed774f"

  - `currency` (string, required)
    Currency for the account
    Example: "USD"

  - `type` (string, required)
    Type of account
    Enum: "CRYPTO", "FIAT"

  - `rails` (array, required)
    Available payment rail types for this account
    Enum: "BLOCKCHAIN", "FEDWIRE", "ACH", "RTP", "PIX"

  - `balances` (object, required)
    Account balance information

  - `balances.account_id` (string)
    Identifier of the account these balances belong to
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `balances.available` (object, required)
    Available balance that can be withdrawn or used

  - `balances.available.amount` (string, required)
    Available balance amount as a string to preserve precision
    Example: "1250.50"

  - `balances.pending` (object, required)
    Pending balance information

  - `balances.pending.inbound` (object, required)
    Pending inbound balance

  - `balances.pending.inbound.amount` (string, required)
    Pending inbound amount as a string to preserve precision
    Example: "50.00"

  - `balances.pending.outbound` (object, required)
    Pending outbound balance

  - `balances.pending.outbound.amount` (string, required)
    Pending outbound amount as a string to preserve precision
    Example: "25.00"

  - `balances.updated_at` (string)
    ISO 8601 timestamp when these balances were last updated
    Example: "2025-09-18T22:54:00.542Z"

  - `ownership_level` (string, required)
    Indicates whether this account is owned at the partner or customer level
    Enum: "PARTNER", "CUSTOMER"

  - `status` (string, required)
    Status of the account
    Enum: "PENDING", "ACTIVE", "INACTIVE", "SUSPENDED", "CLOSED"

  - `created_at` (string, required)
    ISO 8601 timestamp when the account was created
    Example: "2025-09-18T22:54:00.542Z"

  - `updated_at` (string, required)
    ISO 8601 timestamp when the account was last updated
    Example: "2025-09-18T22:54:00.542Z"

## Response 400 fields (application/json):

  - `code` (string, required)
    Error code identifying the type of error

  - `reason` (string, required)
    Human-readable error message