> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bluerails.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Account

> Retrieves detailed information about a specific account.

Returns the complete account object including its current status, classification,
purpose, and any associated metadata. Use this to verify account details before
initiating transactions or to check account status.



## OpenAPI

````yaml GET /v1/accounts/{account_id}
openapi: 3.1.0
info:
  title: Payment Platform API
  version: 0.0.0
servers: []
security: []
tags:
  - name: Accounts
  - name: Payouts
  - name: Payments
paths:
  /v1/accounts/{account_id}:
    get:
      tags:
        - Accounts
      summary: Get Account
      description: >-
        Retrieves detailed information about a specific account.


        Returns the complete account object including its current status,
        classification,

        purpose, and any associated metadata. Use this to verify account details
        before

        initiating transactions or to check account status.
      operationId: Accounts_getAccount
      parameters:
        - $ref: '#/components/parameters/AccountId'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Account'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  parameters:
    AccountId:
      name: account_id
      in: path
      required: true
      description: The unique identifier of the account to update, starts with acct_
      schema:
        type: string
  schemas:
    Account:
      type: object
      required:
        - accountId
        - name
        - purpose
        - classification
        - status
        - updatedAt
        - createdAt
      properties:
        accountId:
          type: string
          description: Unique identifier for the account
          readOnly: true
        name:
          type: string
          description: Display name for the account
        description:
          type: string
          description: Detailed description of the account's purpose
        purpose:
          allOf:
            - $ref: '#/components/schemas/AccountPurpose'
          description: The purpose of the account
        classification:
          allOf:
            - $ref: '#/components/schemas/AccountClassification'
          description: >-
            Classification that determines the account's priority and usage
            patterns
        status:
          allOf:
            - $ref: '#/components/schemas/AccountStatus'
          description: Current operational status of the account
          readOnly: true
        metadata:
          type: object
          unevaluatedProperties:
            type: string
          description: Additional custom data associated with the account
        updatedAt:
          type: string
          format: date-time
          description: Timestamp when the account was created
          readOnly: true
        createdAt:
          type: string
          format: date-time
          description: Timestamp when the account was last updated
          readOnly: true
      description: |-
        Represents a financial account in the system
        Accounts are used to track balances and process transactions
      examples:
        - accountId: acc_12345
          name: Primary Business Account
          description: Main account for business operations
          purpose: OPERATING
          classification: PRIMARY
          status: ACTIVE
          metadata:
            department: finance
            costCenter: HQ
          updatedAt: '2025-04-29T13:29:15.064Z'
          createdAt: '2025-04-29T13:29:15.064Z'
    ApiError:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
        message:
          type: string
        target:
          type: string
      description: Standard error structure
    AccountPurpose:
      type: string
      enum:
        - OPERATING
        - WALLET
        - REVENUE
        - TAX
        - RESERVE
        - OTHER
      description: >-
        Defines the primary purpose or category assigned by an SME to an
        account,

        facilitating the organization and management of funds within their
        treasury operations.

        From the perspective of Bluerails (the treasury solution provider), all
        these accounts

        represent liabilities.
    AccountClassification:
      type: string
      enum:
        - PRIMARY
        - SECONDARY
      description: |-
        Allowed classifications for an account
        Determines the account's priority and usage patterns
    AccountStatus:
      type: string
      enum:
        - ACTIVE
        - INACTIVE
      description: |-
        The status of the account
        Indicates whether the account can be used for transactions

````