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

# List accounts

> List all non-system accounts for the authenticated organization. Optionally filter by account type and/or scope. Use scope=default to return accounts where shortcodeId is absent, and scope=shortcode to return accounts where shortcodeId is present. You can combine type and scope in the same request.



## OpenAPI

````yaml api-reference/openapi.json get /v1/accounts
openapi: 3.1.0
info:
  title: Fingo Pay API
  description: >-
    Fingo Pay's unified payments API for M-Pesa C2B (STK Push), B2C
    disbursements, B2B transfers, bank transfers, account balances, and
    transactions.
  version: 1.0.0
servers:
  - url: https://api.fingopay.io
security:
  - bearerAuth: []
tags:
  - name: Payments
    description: Receive payments from customers
  - name: Payouts
    description: Send payments to recipients
  - name: Accounts
    description: Account balances and management
  - name: Transactions
    description: Transaction history and lookup
  - name: Verification
    description: Pre-transaction verification and lookup
  - name: Webhooks
    description: Webhook event notifications
paths:
  /v1/accounts:
    get:
      tags:
        - Accounts
      summary: List accounts
      description: >-
        List all non-system accounts for the authenticated organization.
        Optionally filter by account type and/or scope. Use scope=default to
        return accounts where shortcodeId is absent, and scope=shortcode to
        return accounts where shortcodeId is present. You can combine type and
        scope in the same request.
      operationId: listAccounts
      parameters:
        - name: type
          in: query
          required: false
          description: Filter accounts by type. Can be combined with scope.
          schema:
            type: string
            enum:
              - collections
              - payouts
        - name: scope
          in: query
          required: false
          description: >-
            Filter accounts by shortcode scope. Use default for accounts where
            shortcodeId is absent, or shortcode for accounts where shortcodeId
            is present. Can be combined with type.
          schema:
            type: string
            enum:
              - default
              - shortcode
      responses:
        '200':
          description: Accounts fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountsListResponse'
        '400':
          $ref: '#/components/responses/ErrorResponse'
        '401':
          $ref: '#/components/responses/ErrorResponse'
components:
  schemas:
    AccountsListResponse:
      type: object
      properties:
        status:
          type: string
          example: success
        message:
          type: string
          example: Accounts fetched
        data:
          type: object
          properties:
            items:
              type: array
              items:
                $ref: '#/components/schemas/Account'
          required:
            - items
      required:
        - status
        - message
        - data
    Account:
      type: object
      properties:
        accountNo:
          type:
            - string
            - 'null'
          example: ACC-123456
        name:
          type:
            - string
            - 'null'
          example: Main Collections
        type:
          type: string
          enum:
            - collections
            - payouts
          example: collections
        currency:
          type: string
          example: KES
        available:
          type: integer
          example: 9876543
        pending:
          type: integer
          example: 0
        status:
          type: string
          example: active
        default:
          type: boolean
          example: true
        hostType:
          type:
            - string
            - 'null'
          enum:
            - fingo
            - partner
            - null
          example: fingo
        bankName:
          type:
            - string
            - 'null'
          description: Only included for live payout accounts
          example: Choice Bank
        bankCode:
          type:
            - string
            - 'null'
          description: Only included for live payout accounts
          example: '80100'
        branchCode:
          type:
            - string
            - 'null'
          description: Only included for live payout accounts
          example: '001'
        swiftCode:
          type:
            - string
            - 'null'
          description: Only included for live payout accounts
          example: CHKEKENX
      required:
        - type
        - currency
        - available
        - pending
        - status
        - default
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - invalid_request_error
                - authentication_error
                - rate_limit_error
                - api_error
                - idempotency_error
                - not_found_error
                - conflict_error
              description: Error category
            code:
              type: string
              enum:
                - missing_parameter
                - invalid_parameter
                - unauthorized
                - forbidden
                - too_many_requests
                - internal_error
                - duplicate
                - resource_not_found
                - missing_header
                - validation_error
              description: Specific error code
            message:
              type: string
              description: Human-readable error message
            param:
              type:
                - string
                - 'null'
              description: The parameter that caused the error, if applicable
            requestId:
              type: string
              description: Request ID for support reference
          required:
            - type
            - code
            - message
      required:
        - error
  responses:
    ErrorResponse:
      description: Error response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Use your API key as a Bearer token. Example: Authorization: Bearer
        sk_live_...

````