# 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

## Security:

  - `Bearer` (unknown)
    http bearer JWT

## Path parameters:

  - `account_id` (string, required)
    Unique identifier of the account to retrieve

## Response 200:

  - `200` (unknown)
    Successful response

## 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

  - `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:

  - `400` (unknown)
    Bad Request - Invalid input parameters

## Response 400 fields (application/json):

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

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

## Response 401:

  - `401` (unknown)
    Unauthorized - Invalid or missing authentication

## Response 401 fields (application/json):

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

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

## Response 404:

  - `404` (unknown)
    Account not found

## Response 404 fields (application/json):

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

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

## Response 500:

  - `500` (unknown)
    Internal server error

## Response 500 fields (application/json):

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

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