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

# List balances

> Get a list of your balances for every currency, both crypto and fiat.



## OpenAPI

````yaml POST /v2/accounts/list
openapi: 3.1.0
info:
  title: Merchant Backend V2
  version: '1.0'
  description: Documentation for merchant backend processing endpoints
servers:
  - url: https://app.ca.cryptoprocessing.com/api
security:
  - xProcessingKey: []
tags:
  - name: Status
  - name: Balance
  - name: Currencies
  - name: Deposit addresses
  - name: Withdrawal
  - name: Exchange
  - name: Invoices
  - name: Transactions
paths:
  /v2/accounts/list:
    post:
      tags:
        - Balance
      summary: List balances
      description: Get a list of your balances for every currency, both crypto and fiat.
      operationId: post-accounts-list
      parameters:
        - $ref: '#/components/parameters/XProcessingSignatureHeader'
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              description: >
                This endpoint does not accept any request parameters. Both an
                empty JSON object (`{}`) and a completely empty (zero-byte) body
                are accepted. `Content-Type: application/json` is still required
                if you send `{}` — but if the body is truly empty (zero bytes),
                `Content-Type` isn't checked at all (it can be omitted or set to
                any value).
            examples:
              Empty JSON object:
                value: {}
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      required:
                        - currency
                        - type
                        - balance
                      properties:
                        currency:
                          type: string
                          description: Asset or currency code.
                        type:
                          type: string
                          description: Asset type.
                          enum:
                            - crypto
                            - fiat
                        balance:
                          type: string
                          description: >-
                            Account balance as a decimal string, may be
                            negative.
              examples:
                Balances:
                  value:
                    data:
                      - currency: BTC
                        type: crypto
                        balance: '0.04000000'
                      - currency: USD
                        type: fiat
                        balance: '10000.00000000'
        '400':
          $ref: '#/components/responses/MalformedJson'
        '403':
          $ref: '#/components/responses/HeaderAuthorization'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  parameters:
    XProcessingSignatureHeader:
      name: X-Processing-Signature
      in: header
      required: true
      description: >-
        Hex-encoded HMAC-SHA512 signature of the request body, [generated using
        your secret key](/api-reference/authentication).
      schema:
        type: string
  responses:
    MalformedJson:
      description: >
        Bad Request


        The request body is not valid JSON, or the Content-Type header is not
        set to `application/json`.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                description: Human-readable error message.
              code:
                type: string
                description: Error code.
          examples:
            Malformed JSON:
              value:
                error: Bad content format
                code: bad_content_format
    HeaderAuthorization:
      description: |
        Forbidden
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                description: Human-readable error message.
              code:
                type: string
                description: Error code.
            description: >-
              Invalid or missing headers, or the API key does not have access to
              the endpoint. Refer to
              [Errors](/api-reference/errors#general-errors) for troubleshooting
              steps.
          examples:
            Bad signature header:
              value:
                error: Bad signature header
                code: bad_header_signature
            API key does not have the required ability:
              value:
                error: The API key does not have access to this endpoint.
                code: api_key_ability_required
            No signature header:
              value:
                error: No signature header
                code: required_header_signature
            No key header:
              value:
                error: No key header
                code: required_header_key
    TooManyRequests:
      description: >
        Too Many Requests


        You sent too many requests in a short time. The limit is counted per API
        key, so requests from all your servers that use the same key count
        together. Wait before you send the request again, increasing the delay
        if you get `429` again, and handle this error by its status code, not by
        a particular response body. See [Too many
        requests](/api-reference/errors#too-many-requests-429-too-many-requests).
  securitySchemes:
    xProcessingKey:
      type: apiKey
      description: Your [API key](/merchant-administration/generate-and-activate-api-keys).
      in: header
      name: X-Processing-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.