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

# List account balances

> Retrieve a list of balances for an account. 
The balances are returned in an array, with each item representing a balance for that account.

For charge_card accounts, there will be two balances returned: "cash" and "credit".
For debit accounts, there will only be one balance returned: "debit".




## OpenAPI

````yaml get /account/{accountId}/balance
openapi: 3.1.0
info:
  title: Slash Public API
  description: API description
  version: 0.0.1
  contact: {}
servers:
  - url: https://api.slash.com
    description: production
security:
  - api_key: []
  - partner_api_key: []
  - bearer: []
  - developer_application: []
paths:
  /account/{accountId}/balance:
    parameters:
      - name: accountId
        in: path
        schema:
          type: string
        required: true
    get:
      description: >
        Retrieve a list of balances for an account. 

        The balances are returned in an array, with each item representing a
        balance for that account.


        For charge_card accounts, there will be two balances returned: "cash"
        and "credit".

        For debit accounts, there will only be one balance returned: "debit".
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  balances:
                    type: array
                    items:
                      $ref: '#/components/schemas/Balance'
                      x-entrypoint:
                        virtualPath: schemas/Balance
                        sourcePath: schemas/Balance.yaml
                        title: Balance
                        origin: ./src/publicApi
                required:
                  - balances
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: TooManyRequests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - api_key: []
        - bearer: []
components:
  schemas:
    Balance:
      type: object
      properties:
        accountId:
          type: string
          description: The ID of the account associated with the balance.
        type:
          type: string
          description: >
            The type of balance.

            - "cash" represents the excess balance not used as collateral for
            the charge card. Not applicable to debit accounts.

            - "credit" represents the balance that can be spent on the charge
            card. Not applicable to debit accounts.

            - "debit" represents the balance that can be spent or withdrawn. Not
            applicable to charge card accounts.
          enum:
            - cash
            - credit
            - debit
        available:
          allOf:
            - $ref: '#/components/schemas/Money'
              x-entrypoint:
                virtualPath: schemas/Money
                sourcePath: schemas/Money.yaml
                title: Money
                origin: ./src/publicApi
            - description: >
                The amount of money that is immediately available to use. 

                - For "credit" balances, this is the immediately available
                amount that can be spent on the charge card.

                - For "cash" balances, this value represents the immediately
                available excess cash that is not being used as collateral for
                the charge card. You can choose to transfer more than these
                funds to your bank account, but any amount not coverable by the
                available balance will be removed from the charge card's
                collateral balance (the "credit" balance).

                - For "debit" balances, this is the amount of money available
                that can be spent or withdrawn immediately.
        posted:
          allOf:
            - $ref: '#/components/schemas/Money'
              x-entrypoint:
                virtualPath: schemas/Money
                sourcePath: schemas/Money.yaml
                title: Money
                origin: ./src/publicApi
            - description: >
                The amount of money that has been posted to the account. This
                value does not include any pending transactions and instead
                represents the amount of money that has been posted to the
                balance.
        timestamp:
          type: string
          format: date-time
          description: >-
            The UTC timestamp associated with the balance. Since the balance can
            change rapidly, the timestamp is included to indicate the time when
            the balance was computed.
      required:
        - accountId
        - type
        - available
        - posted
        - timestamp
      x-entrypoint:
        virtualPath: schemas/Balance
        sourcePath: schemas/Balance.yaml
        title: Balance
        origin: ./src/publicApi
      title: Balance
    Error:
      type: object
      properties:
        message:
          type: string
        name:
          type: string
        identifier:
          type: string
        rawStatus:
          type: number
        meta:
          type: object
          additionalProperties: true
      required:
        - message
        - name
        - identifier
        - rawStatus
      x-entrypoint:
        origin: ./src/publicApi
        sourcePath: ./src/publicApi/main.yaml
        title: Error
        virtualPath: components/Error
      title: Error
    Money:
      type: object
      description: Represents a monetary value
      properties:
        amountCents:
          type: integer
          description: The amount in cents
      required:
        - amountCents
      x-entrypoint:
        virtualPath: schemas/Money
        sourcePath: schemas/Money.yaml
        title: Money
        origin: ./src/publicApi
      title: Money
  securitySchemes:
    api_key:
      type: apiKey
      description: |
        API key authentication for public API requests.

        Keys come in two flavors:

        - *Legal-entity-scoped keys* are pinned to a single legal entity.
          Minted via the dashboard under a specific entity; every request
          acts on that entity.
        - *User-scoped keys* are pinned to a user and span every legal
          entity that user has access to. Every request made with a
          user-scoped key (except `GET /legal-entity`, which lists the
          legal entities the user can access) must include an
          `x-legal-entity` header naming the legal entity the request is
          operating on. Requests without the header are rejected with
          `400`. The authenticated user must have an active permission
          role on the supplied legal entity, otherwise the request is
          rejected with `403`.
      name: X-API-Key
      in: header
    partner_api_key:
      type: apiKey
      description: |
        Partner-program API key authentication.

        Keys are minted in the partner dashboard (Developers → API Keys),
        are scoped to a single partner program, and are prefixed with
        `sk_partner_`. Partner keys are only accepted by routes that
        declare this scheme; they are rejected by `api_key` routes and
        vice versa.
      name: X-API-Key
      in: header
    bearer:
      type: http
      scheme: bearer
    developer_application:
      type: http
      scheme: basic

````