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

# List accounts and balances

> Lists the company's currency accounts with their current available balance, ordered with the main account first.
Only accounts the API key's member can access are returned. Points accounts are excluded.

`balance` is the **available** balance: settled funds plus pending outgoing holds (which are negative).
`total_balance` sums every account converted into `base_currency` at the current FX rate.




## OpenAPI

````yaml /specs/company.openapi.yaml get /developer/company/accounts
openapi: 3.1.0
info:
  title: Incard Developer API
  version: 0.1.0
  description: OpenAPI definition for the Incard Developer API.
servers:
  - url: https://api.incard.com
    description: Developer Gateway
security:
  - BearerAuth: []
tags:
  - name: ACCOUNTS
    description: Currency accounts and their available balances.
  - name: TRANSACTIONS
    description: Transaction history with filters, pagination, and running balances.
  - name: CARDS
    description: List cards and freeze or unfreeze them.
  - name: INVOICES
  - name: webhooks
paths:
  /developer/company/accounts:
    get:
      tags:
        - ACCOUNTS
      summary: List accounts and balances
      description: >
        Lists the company's currency accounts with their current available
        balance, ordered with the main account first.

        Only accounts the API key's member can access are returned. Points
        accounts are excluded.


        `balance` is the **available** balance: settled funds plus pending
        outgoing holds (which are negative).

        `total_balance` sums every account converted into `base_currency` at the
        current FX rate.
      operationId: list_accounts
      responses:
        '200':
          description: Accounts with balances.
          content:
            application/json:
              schema:
                type: object
                title: AccountCollection
                properties:
                  accounts:
                    description: Accounts visible to this member.
                    type: array
                    items:
                      $ref: '#/components/schemas/Account'
                  total_balance:
                    description: >-
                      Sum of every account's available balance converted to
                      `base_currency`.
                    type: number
                  base_currency:
                    description: >-
                      Currency `total_balance` is expressed in (the member's
                      display currency).
                    type: string
                required:
                  - accounts
                  - total_balance
                  - base_currency
              example:
                accounts:
                  - id: 0d6c0a2a-2b08-49bc-89a9-eb936c9ff28c
                    currency_code: GBP
                    name: Main GBP account
                    type: business_transaction
                    created_at: '2025-03-14T10:22:41.000Z'
                    updated_at: '2026-07-02T16:08:11.000Z'
                    provider: currencycloud_gb_cm
                    status: enabled
                    main: true
                    jurisdiction_code: GB
                    funding_accounts:
                      local:
                        account_number: '12345678'
                        account_type: checking
                        name: Incard Ltd
                        address: 1 Example Street, London, EC1A 1AA
                        country_code: GB
                        currency_code: GBP
                        type: regular
                        routing_code_type: sort_code
                        routing_code_value: '040004'
                        bank_name: Example Bank
                      swift:
                        account_number: GB29NWBK60161331926819
                        account_type: checking
                        name: Incard Ltd
                        address: 1 Example Street, London, EC1A 1AA
                        country_code: GB
                        currency_code: GBP
                        type: priority
                        routing_code_type: bic_swift
                        routing_code_value: NWBKGB2L
                        bank_name: Example Bank
                    balance: 4700
                    pinned: false
                  - id: 7a1e9c44-3b2d-4f6e-8a90-1c2d3e4f5a6b
                    currency_code: EUR
                    name: EUR account
                    type: business_transaction
                    created_at: '2025-06-01T09:00:00.000Z'
                    updated_at: '2026-06-30T12:00:00.000Z'
                    provider: currencycloud_gb_cm
                    status: enabled
                    main: false
                    jurisdiction_code: GB
                    funding_accounts:
                      local:
                        account_number: DE89370400440532013000
                        account_type: checking
                        name: Incard Ltd
                        address: 1 Example Street, London, EC1A 1AA
                        country_code: DE
                        currency_code: EUR
                        type: regular
                        routing_code_type: bic_swift
                        routing_code_value: COBADEFFXXX
                        bank_name: Example Bank
                      swift: null
                    balance: 1250.5
                    pinned: true
                total_balance: 5780.42
                base_currency: GBP
        '401':
          description: Unauthorized
        '403':
          description: Forbidden — insufficient permission for this user
components:
  schemas:
    Account:
      type: object
      title: Account
      description: A currency account held by the company.
      properties:
        id:
          description: Account UUID. Matches `account_id` on transactions.
          type: string
        currency_code:
          description: ISO 4217 currency of the account.
          type: string
        name:
          description: Account display name.
          type: string
        type:
          description: Account type, for example `business_transaction`.
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        provider:
          description: Underlying banking provider identifier.
          type: string
        status:
          description: Account status, for example `enabled`.
          type: string
        main:
          description: Whether this is the company's main account.
          type: boolean
        jurisdiction_code:
          description: (Optional) ISO 3166-1 alpha-2 jurisdiction the account is held in.
          type:
            - string
            - 'null'
        funding_accounts:
          description: >-
            (Optional) Bank details for paying into the account. Omitted when
            the account has none.
          type: object
          properties:
            local:
              description: Local-rail details, or `null` when unavailable.
              oneOf:
                - $ref: '#/components/schemas/FundingAccount'
                - type: 'null'
            swift:
              description: SWIFT details, or `null` when unavailable.
              oneOf:
                - $ref: '#/components/schemas/FundingAccount'
                - type: 'null'
        balance:
          description: >-
            Available balance in `currency_code` (settled funds minus pending
            outgoing holds). `null` when the balance could not be retrieved.
          type:
            - number
            - 'null'
        pinned:
          description: Whether the member has pinned the account in the dashboard.
          type: boolean
      required:
        - id
        - currency_code
        - name
        - type
        - created_at
        - updated_at
        - provider
        - status
        - main
        - balance
        - pinned
    FundingAccount:
      type: object
      title: FundingAccount
      description: Bank details a payer can use to send money into the account.
      properties:
        account_number:
          description: Account number or IBAN.
          type: string
        account_type:
          description: >-
            Account type as reported by the provider, for example `checking` or
            `iban`.
          type: string
        name:
          description: Account holder name to use on the payment.
          type: string
        address:
          description: Account holder address.
          type: string
        country_code:
          description: ISO 3166-1 alpha-2 country of the bank.
          type: string
        currency_code:
          description: ISO 4217 currency.
          type: string
        type:
          description: '`regular` for local rails, `priority` for SWIFT.'
          type: string
        routing_code_type:
          description: >-
            Routing code scheme, for example `sort_code`, `bic_swift`, or
            `ach_routing_number`.
          type: string
        routing_code_value:
          description: Routing code value.
          type: string
        bank_name:
          description: (Optional) Name of the bank.
          type:
            - string
            - 'null'
      required:
        - account_number
        - account_type
        - name
        - country_code
        - currency_code
        - type
        - routing_code_type
        - routing_code_value
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: access_token
      description: Short-lived access token. Obtain with your api_key.

````