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

# Get Account Details

> Returns detailed information about a specified bank account.



## OpenAPI

````yaml GET /accounts/{account_id}
openapi: 3.1.0
info:
  title: Meow API
  description: >
    ## Overview


    The Meow API provides financial services and billing capabilities for your
    business.


    ### Core Features


    - **Financial data access**: access account information, transactions,
    balances, and payment networks.

    - **Crypto operations**: create and manage crypto contacts, and initiate
    USDC transfers across blockchain networks.


    ### Billing API


    The Billing API lets you create and manage invoices and collect payments:


    - **Product management**: create and manage products with custom pricing.

    - **Customer management**: maintain invoicing customers with their
    addresses.

    - **Invoice creation**: generate invoices with line items, discounts, and
    custom notes.

    - **Payment options**: accept payments via ACH, wire, international wire,
    card, and USDC.

    - **Collection accounts**: configure accounts for payment collection.


    ### Getting Started


    Authenticate by sending your API key in the `x-api-key` request header.


    To scope requests to a specific entity, include the `x-entity-id` header.
    Use the `/api-keys/accessible-entities` endpoint to list all entities
    accessible by your API key.


    ### Error Responses


    Errors return JSON with `code`, `message`, and `debug_message`. The `code`
    aligns with FDX where possible; use `debug_message` for troubleshooting
    only.


    Common error codes:


    - `500`: Internal server error

    - `501`: Subsystem unavailable

    - `503`: Scheduled maintenance

    - `601`: Data not found

    - `602`: Customer not authorized

    - `701`: Account not found

    - `703`: Invalid input (including invalid date ranges)

    - `704`: Account type not supported

    - `705`: Account is closed

    - `801`: Transaction not found
  contact:
    name: Meow
    url: https://meow.com/
    email: support@meow.com
  version: 1.0.0
  license:
    name: Proprietary
    url: https://www.meow.com/terms-of-service
servers:
  - url: https://api.meow.com/v1
    description: Meow API Production
  - url: https://api.sandbox.meow.com/v1
    description: Meow API Sandbox
security:
  - apiKeyAuth: []
tags:
  - name: API Keys
    description: Retrieve metadata about API keys and their accessible entities.
  - name: Accounts
    description: Access and manage accounts.
  - name: Approvals
  - name: Balances
    description: Retrieve account balances and available funds.
  - name: Bills
    description: View and manage bills for vendor payments.
  - name: Cards
    description: Manage virtual and physical cards, and view transactions and insights.
  - name: Collection Accounts
    description: Manage accounts for payment collection.
  - name: Contacts
    description: Manage contacts for crypto and USDC transfers.
  - name: Customers
    description: Manage invoicing customers and their details.
  - name: Entities
  - name: Invoices
    description: Create and manage invoices.
  - name: Limits
  - name: Line Items
    description: Manage invoice line items.
  - name: Partner Onboarding
    description: Onboard entities using your partner API key.
  - name: Partner Webhooks
  - name: Payment Methods
    description: View available payment method types.
  - name: Payment Networks
    description: Manage payment networks and routing information.
  - name: Products
    description: Manage products and pricing for invoicing.
  - name: Routing Numbers
    description: Validate routing numbers and retrieve bank information.
  - name: Security Policies
  - name: Simulations
    description: >-
      Trigger simulated events — inbound transfers, card authorizations,
      application approval — to test integrations end-to-end without real money
      movement. **Not available in production**: these endpoints exist only in
      sandbox and development environments and return `404 Not Found` in
      production.
  - name: Tax Forms
    description: Retrieve IRS tax forms (1099 family) issued for accounts.
  - name: Transactions
    description: Retrieve account transaction history and details.
  - name: Transfers
    description: >-
      Initiate ACH, wire, book, and crypto transfers, and retrieve transfer
      details.
  - name: Webhooks
    description: Manage webhook subscriptions and inspect delivery history.
paths:
  /accounts/{account_id}:
    get:
      tags:
        - Accounts
      summary: Get Account Details
      description: Returns detailed information about a specified bank account.
      operationId: get_account_handler_accounts__account_id__get
      parameters:
        - name: account_id
          in: path
          required: true
          schema:
            type: string
            description: The ID of the account.
            title: Account Id
          description: The ID of the account.
        - $ref: '#/components/parameters/EntityIdHeader'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountWithDetails'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - apiKeyAuth:
            - accounts:read
components:
  parameters:
    EntityIdHeader:
      name: x-entity-id
      in: header
      required: false
      schema:
        type: string
        format: uuid
      description: Optional `entity_id` to scope requests to a specific entity.
  schemas:
    AccountWithDetails:
      anyOf:
        - $ref: '#/components/schemas/DepositAccountWithDetail'
        - $ref: '#/components/schemas/InvestmentAccountWithDetail'
        - $ref: '#/components/schemas/DigitalWalletWithDetail'
      title: AccountWithDetails
      description: Account with balance details.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DepositAccountWithDetail:
      properties:
        depositAccount:
          $ref: '#/components/schemas/DepositAccount'
          description: Deposit account with balances.
      additionalProperties: false
      type: object
      required:
        - depositAccount
      title: DepositAccountWithDetail
    InvestmentAccountWithDetail:
      properties:
        investmentAccount:
          $ref: '#/components/schemas/InvestmentAccount'
          description: Investment account with balances and holdings.
      additionalProperties: false
      type: object
      required:
        - investmentAccount
      title: InvestmentAccountWithDetail
    DigitalWalletWithDetail:
      properties:
        digitalWallet:
          $ref: '#/components/schemas/DigitalWallet'
          description: Digital wallet with balances.
      additionalProperties: false
      type: object
      required:
        - digitalWallet
      title: DigitalWalletWithDetail
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    DepositAccount:
      properties:
        accountId:
          $ref: '#/components/schemas/Identifier'
          description: Unique identifier for this account.
        accountType:
          $ref: '#/components/schemas/AccountType'
          description: The type of account.
        accountNumberDisplay:
          anyOf:
            - type: string
            - type: 'null'
          title: Accountnumberdisplay
          description: Last 4 digits of the account number.
          examples:
            - 4321
        productName:
          type: string
          title: Productname
          description: Product name (e.g., Business Checking, Treasury).
        nickname:
          anyOf:
            - type: string
            - type: 'null'
          title: Nickname
          description: Custom display name for the account.
        status:
          $ref: '#/components/schemas/AccountStatus'
          description: Current account status.
        currency:
          $ref: '#/components/schemas/Currency'
          description: Currency of the account.
        currentBalance:
          type: number
          title: Currentbalance
          description: Total balance of posted transactions.
        availableBalance:
          type: number
          title: Availablebalance
          description: Balance available for transfers and payments.
        bankProductType:
          anyOf:
            - type: string
            - type: 'null'
          title: Bankproducttype
          description: The name of the bank this account is held at.
      type: object
      required:
        - accountId
        - accountType
        - productName
        - status
        - currency
        - currentBalance
        - availableBalance
      title: DepositAccount
    InvestmentAccount:
      properties:
        accountId:
          $ref: '#/components/schemas/Identifier'
          description: Unique identifier for this account.
        accountType:
          $ref: '#/components/schemas/AccountType'
          description: The type of account.
        accountNumberDisplay:
          anyOf:
            - type: string
            - type: 'null'
          title: Accountnumberdisplay
          description: Last 4 digits of the account number.
          examples:
            - 4321
        productName:
          type: string
          title: Productname
          description: Product name (e.g., Business Checking, Treasury).
        nickname:
          anyOf:
            - type: string
            - type: 'null'
          title: Nickname
          description: Custom display name for the account.
        status:
          $ref: '#/components/schemas/AccountStatus'
          description: Current account status.
        currency:
          $ref: '#/components/schemas/Currency'
          description: Currency of the account.
        availableCashBalance:
          type: number
          title: Availablecashbalance
          description: Cash available for withdrawal or investment.
        currentValue:
          type: number
          title: Currentvalue
          description: Total current value of the account including all holdings.
        holdings:
          anyOf:
            - items:
                $ref: '#/components/schemas/Holding'
              type: array
            - type: 'null'
          title: Holdings
          description: List of securities and cash positions in the account.
      type: object
      required:
        - accountId
        - accountType
        - productName
        - status
        - currency
        - availableCashBalance
        - currentValue
        - holdings
      title: InvestmentAccount
    DigitalWallet:
      properties:
        accountId:
          $ref: '#/components/schemas/Identifier'
          description: Unique identifier for this wallet.
        accountCategory:
          $ref: '#/components/schemas/AccountCategory'
          description: Account category.
          default: DIGITAL_WALLET
        accountType:
          $ref: '#/components/schemas/DigitalWalletType'
          description: The type of digital wallet.
        accountNumberDisplay:
          anyOf:
            - type: string
            - type: 'null'
          title: Accountnumberdisplay
          description: Last 4 digits of the wallet address.
          examples:
            - 4321
        productName:
          type: string
          title: Productname
          description: Product name (e.g., USDC Wallet).
        nickname:
          anyOf:
            - type: string
            - type: 'null'
          title: Nickname
          description: Custom display name for the wallet.
        status:
          $ref: '#/components/schemas/AccountStatus'
          description: Current wallet status.
        currency:
          $ref: '#/components/schemas/Currency'
          description: Currency of the wallet.
        currentBalance:
          type: number
          title: Currentbalance
          description: Total balance of the wallet.
        availableBalance:
          type: number
          title: Availablebalance
          description: Balance available for transfers.
      type: object
      required:
        - accountId
        - accountType
        - productName
        - status
        - currency
        - currentBalance
        - availableBalance
      title: DigitalWallet
    Identifier:
      type: string
      maxLength: 256
      title: Identifier
      description: Value for a unique identifier.
    AccountType:
      type: string
      enum:
        - BROKERAGEPRODUCT
        - CHECKING
        - MONEYMARKET
        - SAVINGS
        - TAXABLE
      title: AccountType
    AccountStatus:
      type: string
      enum:
        - CLOSED
        - DELINQUENT
        - NEGATIVECURRENTBALANCE
        - OPEN
        - PAID
        - PENDINGCLOSE
        - PENDINGOPEN
        - RESTRICTED
      title: AccountStatus
    Currency:
      properties:
        currencyCode:
          $ref: '#/components/schemas/Iso4217Code'
          description: ISO 4217 currency code.
      type: object
      required:
        - currencyCode
      title: Currency
    Holding:
      properties:
        securityId:
          anyOf:
            - type: string
            - type: 'null'
          title: Securityid
          description: >-
            Security identifier used to look up the closing price. Required
            together with `securityIdType` unless you provide `symbol`.
        securityIdType:
          anyOf:
            - $ref: '#/components/schemas/customer_api__v1__models__SecurityIdType'
            - type: 'null'
          description: Type of security identifier provided (e.g., CUSIP, ISIN).
        holdingName:
          anyOf:
            - type: string
            - type: 'null'
          title: Holdingname
          description: Holding name or security name.
        holdingType:
          anyOf:
            - $ref: '#/components/schemas/HoldingType'
            - type: 'null'
          description: The high-level type of the holding (e.g., STOCK, BOND).
        holdingSubType:
          anyOf:
            - $ref: '#/components/schemas/HoldingSubType'
            - type: 'null'
          description: The more granular subtype of the holding (e.g., CASH, MONEYMARKET).
        symbol:
          anyOf:
            - type: string
            - type: 'null'
          title: Symbol
          description: >-
            Ticker or market symbol. Required unless both `securityId` and
            `securityIdType` are provided.
        purchasedPrice:
          anyOf:
            - type: number
            - type: 'null'
          title: Purchasedprice
          description: >-
            Price of holding at the time of purchase. Used to determine the
            approximate cost basis using the purchase price and the number of
            units.
        currentUnitPrice:
          anyOf:
            - type: number
            - type: 'null'
          title: Currentunitprice
          description: >-
            Current unit price. Used as the institution price and fallback for
            the close price if a security ID is not provided.
        currentUnitPriceDate:
          anyOf:
            - $ref: '#/components/schemas/DateString'
            - type: 'null'
          description: >-
            Current unit price as-of date. ISO 8601 full-date in format
            `YYYY-MM-DD`, per [RFC
            3339](https://datatracker.ietf.org/doc/html/rfc3339.html#section-5.6).
        units:
          anyOf:
            - type: number
            - type: 'null'
          title: Units
          description: >-
            Quantity for security-based holdings: shares for stocks and mutual
            funds, face value for bonds, contracts for options. Required when
            the holding involves a security.
        marketValue:
          type: number
          title: Marketvalue
          description: Market value at the time the data was retrieved.
        faceValue:
          anyOf:
            - type: number
            - type: 'null'
          title: Facevalue
          description: >-
            Required for bonds. Face value at the time the data was retrieved.
            If not present, assume the holding isn't a bond and fall back to
            `marketValue`.
        cashAccount:
          type: boolean
          title: Cashaccount
          description: >-
            If true, indicates that this holding is used to maintain proceeds
            from sales, dividends, and other cash postings to the investment
            account. Used in determining if the security is a cash equivalent.
          default: false
        currency:
          anyOf:
            - $ref: '#/components/schemas/Currency'
            - type: 'null'
          description: Currency of the holding, if different from the account's currency.
      type: object
      required:
        - marketValue
      title: Holding
      description: A holding in an investment account.
    AccountCategory:
      type: string
      enum:
        - DEPOSIT_ACCOUNT
        - DIGITAL_WALLET
        - INVESTMENT_ACCOUNT
      title: AccountCategory
    DigitalWalletType:
      type: string
      enum:
        - DIGITALWALLET
      title: DigitalWalletType
    Iso4217Code:
      type: string
      enum:
        - AED
        - AFN
        - ALL
        - AMD
        - ANG
        - AOA
        - ARS
        - AUD
        - AWG
        - AZN
        - BAM
        - BBD
        - BDT
        - BGN
        - BHD
        - BIF
        - BMD
        - BND
        - BOB
        - BOV
        - BRL
        - BSD
        - BTN
        - BWP
        - BYN
        - BZD
        - CAD
        - CDF
        - CHE
        - CHF
        - CHW
        - CLF
        - CLP
        - CNY
        - COP
        - COU
        - CRC
        - CUC
        - CUP
        - CVE
        - CZK
        - DJF
        - DKK
        - DOP
        - DZD
        - EGP
        - ERN
        - ETB
        - EUR
        - FJD
        - FKP
        - GBP
        - GEL
        - GHS
        - GIP
        - GMD
        - GNF
        - GTQ
        - GYD
        - HKD
        - HNL
        - HRK
        - HTG
        - HUF
        - IDR
        - ILS
        - INR
        - IQD
        - IRR
        - ISK
        - JMD
        - JOD
        - JPY
        - KES
        - KGS
        - KHR
        - KMF
        - KPW
        - KRW
        - KWD
        - KYD
        - KZT
        - LAK
        - LBP
        - LKR
        - LRD
        - LSL
        - LYD
        - MAD
        - MDL
        - MGA
        - MKD
        - MMK
        - MNT
        - MOP
        - MRU
        - MUR
        - MVR
        - MWK
        - MXN
        - MXV
        - MYR
        - MZN
        - NAD
        - NGN
        - NIO
        - NOK
        - NPR
        - NZD
        - OMR
        - PAB
        - PEN
        - PGK
        - PHP
        - PKR
        - PLN
        - PYG
        - QAR
        - RON
        - RSD
        - RUB
        - RWF
        - SAR
        - SBD
        - SCR
        - SDG
        - SLE
        - SEK
        - SGD
        - SHP
        - SLL
        - SOS
        - SRD
        - SSP
        - STN
        - SVC
        - SYP
        - SZL
        - THB
        - TJS
        - TMT
        - TND
        - TOP
        - TRY
        - TTD
        - TWD
        - TZS
        - UAH
        - UGX
        - USD
        - USN
        - UYI
        - UYU
        - UYW
        - UZS
        - VED
        - VES
        - VND
        - VUV
        - WST
        - XAF
        - XAG
        - XAU
        - XBA
        - XBB
        - XBC
        - XBD
        - XCD
        - XDR
        - XOF
        - XPD
        - XPF
        - XPT
        - XSU
        - XTS
        - XUA
        - XXX
        - YER
        - ZAR
        - ZMW
        - ZWG
        - ZWL
      title: Iso4217Code
    customer_api__v1__models__SecurityIdType:
      type: string
      enum:
        - CUSIP
        - ISIN
        - SEDOL
        - SICC
        - VALOR
        - WKN
      title: SecurityIdType
      description: >-
        Standard identifiers used for securities in financial markets.

        CUSIP - Committee on Uniform Securities Identification Procedures (North
        American securities)

        ISIN - International Securities Identification Number (global standard)

        SEDOL - Stock Exchange Daily Official List (UK securities)

        SICC - Standard Industrial Classification Code

        VALOR - Swiss security identification number

        WKN - Wertpapierkennnummer (German securities)
    HoldingType:
      type: string
      enum:
        - ANNUITY
        - BOND
        - CD
        - MUTUALFUND
        - OPTION
        - OTHER
        - STOCK
      title: HoldingType
      description: >-
        Types of financial holdings or investments.


        ANNUITY - A contract sold by financial institutions that provides fixed
        payments to the holder at specified intervals

        BOND - A debt security where an investor loans money to an entity for a
        defined period at a fixed interest rate

        CD - Certificate of Deposit, a time deposit with a bank with fixed term
        and interest rate

        MUTUALFUND - An investment vehicle made up of a pool of funds collected
        from many investors

        OPTION - A contract giving the buyer the right to buy or sell an
        underlying asset at a specific price

        OTHER - Any holding type not covered by the other categories

        STOCK - Shares or equity in a corporation
    HoldingSubType:
      type: string
      enum:
        - CASH
        - MONEYMARKET
      title: HoldingSubType
      description: >-
        The subtype of an investment holding. Set `holdingSubType` to `CASH` or
        `MONEYMARKET` to indicate cash-type holdings.
    DateString:
      type: string
      format: date
      title: DateString
      description: >-
        ISO 8601 full-date in the format `YYYY-MM-DD` (per [IETF RFC
        3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Meow API key, sent in the `x-api-key` header for authentication.
      x-scopes:
        - accounts:read
        - accounts:write
        - accounts:payment-networks
        - accounts:transactions
        - accounts:balances
        - accounts:statements
        - accounts:tax-documents
        - entity:create
        - transfers:crypto:write
        - transfers:usdc:write
        - transfers:ach:write
        - transfers:wire:write
        - transfers:book:write
        - contacts:read
        - contacts:write
        - billing:products:read
        - billing:products:write
        - billing:customers:read
        - billing:customers:write
        - billing:invoices:read
        - billing:invoices:write
        - billing:accounts:read
        - billpay:read
        - billpay:write
        - onboarding:read
        - onboarding:write
        - cards:read
        - cards:write
        - webhooks:read
        - webhooks:write
        - partner:onboarding:read
        - partner:onboarding:write
        - partner:webhooks:read
        - partner:webhooks:write
        - simulations:write
        - banking:limits:read
        - banking:limits:write

````