> ## Documentation Index > Fetch the complete documentation index at: https://docs.finhub.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Account List > List accounts with pagination and type filter ## OpenAPI ````yaml post /api/v2.1/fincard/virtual/account/list openapi: 3.1.0 info: title: Business BFF API version: 1.0.0 description: Backend for Frontend - Business Panels Orchestration Layer servers: - url: https://sandbox.finhub.cloud description: Sandbox Environment security: [] tags: - name: AML description: Anti-Money Laundering checks and transaction monitoring - name: Admin - Consent Management description: Operations for managing consent templates and definitions - name: B2B Customer - Organization description: B2B organization registration and management - name: B2C Customer - Individual description: Individual customer registration and lifecycle management - name: BFF Admin - Tenant Initialization description: Lazy tenant initialization for fast startup - name: Catalog Hierarchy description: Hierarchical catalog management APIs - name: Catalog-Process Mapping description: APIs for catalog-process relationship management - name: Consent description: Payment consent creation and approval - name: Draft Management - name: External Events description: Kafka-to-HTTP bridge event ingestion and query - name: FinCard Virtual - Webhooks description: FinCard Virtual Card Webhook receiver - name: FinCard Virtual Account description: FinCard Virtual Card Account API proxy - name: FinCard Virtual Card Holder description: FinCard Virtual Card Holder API proxy - name: FinCard Virtual Cards description: FinCard Virtual Card API proxy - name: FinCard Virtual Common description: FinCard Virtual Card Common API proxy - name: FinCard Virtual Wallet description: FinCard Virtual Card Wallet API v2 proxy - name: FinTrans - Operations description: Financial transaction operations - name: Internal Webhooks description: Internal service-to-service webhook trigger (HMAC-secured) - name: MFE Preload description: MFE preload endpoints for SSR optimization - name: MFE Registry description: MFE Registry management endpoints - name: Payment Consent Management description: Operations for managing payment consents and validation - name: Person description: Person details for process context - name: Products description: Product Catalog Management API - name: Reference Data description: Shared reference data (countries, etc.) - name: Tenant Lifecycle description: Tenant mode transitions and lifecycle management - name: Tenant Registration description: Self-registration and tenant onboarding - name: Transfers description: Transfer prepare/execute aliases for muse-proxy compatibility - name: Verification description: Customer verification (KYC/KYB/AML) management - name: Wallet description: Wallet operations and balance management - name: Webhooks description: Webhook subscription and delivery management paths: /api/v2.1/fincard/virtual/account/list: post: tags: - FinCard Virtual Account summary: Account List description: List accounts with pagination and type filter parameters: - description: User agent name: User-Agent in: header schema: type: string - description: Forwarded for name: X-Forwarded-For in: header schema: type: string - $ref: '#/components/parameters/XForwardedFromHeader' - description: Tenant ID name: X-Tenant-ID in: header schema: type: string - description: Device ID name: deviceId in: header schema: type: string - description: Platform name: platform in: header schema: type: string requestBody: description: Account list request content: application/json: schema: $ref: '#/components/schemas/AccountListRequest' required: true responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/AccountListResponse' '400': description: Bad request '500': description: Internal server error components: parameters: XForwardedFromHeader: name: X-Forwarded-From in: header required: true description: Client application identifier schema: type: string example: client-app schemas: AccountListRequest: type: object description: Account list request properties: accountId: type: string examples: - wsb-abc123 description: Account ID (optional filter) example: wsb-abc123 accountType: type: string description: 'Account type: WALLET (Wallet Account), MARGIN (Margin Account)' pageNum: type: integer format: int32 description: Current page. Default is 1 default: 1 pageSize: type: integer format: int32 description: Number of pages per page. Default 10, maximum 10 default: 10 AccountListResponse: type: object description: Account list response properties: success: type: boolean description: Success flag code: type: integer format: int32 description: Response code msg: type: string description: Response message data: $ref: '#/components/schemas/AccountListData' type: object description: Response data AccountListData: type: object description: Account list data properties: total: type: integer format: int64 description: Total count records: type: array items: $ref: '#/components/schemas/AccountData' description: Account records AccountData: type: object description: Account data properties: accountId: type: string description: Account ID accountName: type: string description: Account name accountType: type: string description: Account type currency: type: string description: Currency totalBalance: type: string description: Total balance availableBalance: type: string description: Available balance frozenBalance: type: string description: Frozen balance digital: type: integer format: int64 description: Decimal point length currentBalance: type: number description: Current balance (BFF extension - maps to totalBalance) accountStatus: type: string description: Account status (BFF extension) createTime: type: integer format: int64 description: Create timestamp (milliseconds) - BFF extension updateTime: type: integer format: int64 description: Update timestamp (milliseconds) - BFF extension ````