> ## 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. # Card Info > Get card details including status and optional balance ## OpenAPI ````yaml post /api/v2.1/fincard/virtual/card/info 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/card/info: post: tags: - FinCard Virtual Cards summary: Card Info description: Get card details including status and optional balance 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: Card info request content: application/json: schema: $ref: '#/components/schemas/CardInfoRequest' required: true responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/CardInfoResponse' '400': description: Bad request '404': description: Card not found '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: CardInfoRequest: type: object required: - cardId description: Card info request properties: cardId: type: string description: Card ID simpleInfo: type: boolean description: Return only basic info (no balance). Default true CardInfoResponse: type: object description: Card info response properties: success: type: boolean examples: - true description: Success flag example: true code: type: integer format: int32 examples: - 200 description: Response code example: 200 msg: type: string examples: - Success description: Response message example: Success data: $ref: '#/components/schemas/CardData' type: object description: Card data CardData: type: object description: Created card data properties: cardId: type: string examples: - card-12345678 description: Card ID example: card-12345678 cardToken: type: string examples: - tok_12345678 description: Card token example: tok_12345678 maskedCardNumber: type: string examples: - '**** **** **** 4242' description: Card number (masked) example: '**** **** **** 4242' expiryDate: type: string examples: - 12/25 description: Expiry date example: 12/25 cardStatus: type: string examples: - ACTIVE description: Card status example: ACTIVE cardType: type: string examples: - VIRTUAL description: Card type example: VIRTUAL brand: type: string examples: - VISA description: Card brand example: VISA currency: type: string examples: - USD description: Card currency example: USD accountId: type: string examples: - wsb-12345678 description: Account ID example: wsb-12345678 cardholderId: type: string examples: - ch-12345678 description: Cardholder ID example: ch-12345678 cardName: type: string examples: - My Virtual Card description: Card name example: My Virtual Card availableBalance: type: number examples: - 1000 description: Available balance example: 1000 currentBalance: type: number examples: - 1000 description: Current balance example: 1000 blockedAmount: type: number examples: - 0 description: Blocked amount example: 0 spendingLimit: type: number examples: - 5000 description: Spending limit example: 5000 dailyLimit: type: number examples: - 1000 description: Daily limit example: 1000 monthlyLimit: type: number examples: - 10000 description: Monthly limit example: 10000 dailySpent: type: number examples: - 100 description: Daily spent example: 100 monthlySpent: type: number examples: - 500 description: Monthly spent example: 500 createTime: type: integer format: int64 examples: - 1640995200000 description: Create time example: 1640995200000 updateTime: type: integer format: int64 examples: - 1640995200000 description: Update time example: 1640995200000 activateTime: type: integer format: int64 examples: - 1640995200000 description: Activate time example: 1640995200000 expireTime: type: integer format: int64 examples: - 1767225600000 description: Expire time example: 1767225600000 settings: $ref: '#/components/schemas/CardSettings' type: object description: Card settings limits: $ref: '#/components/schemas/CardLimits' type: object description: Card limits features: type: array examples: - - CHIP - NFC - 3DS items: type: string description: Card features example: - CHIP - NFC - 3DS CardSettings: type: object description: Card settings properties: enableOnline: type: boolean examples: - true description: Enable online transactions example: true enableInternational: type: boolean examples: - true description: Enable international transactions example: true enableContactless: type: boolean examples: - true description: Enable contactless example: true enableAtm: type: boolean examples: - true description: Enable ATM withdrawals example: true allowedMcc: type: array examples: - - '5411' - '5812' items: type: string description: Merchant category codes example: - '5411' - '5812' blockedMcc: type: array examples: - - '7995' items: type: string description: Blocked merchant category codes example: - '7995' pinFreeAmount: type: number examples: - 100 description: PIN-free amount example: 100 autoLoad: type: boolean examples: - false description: Auto-load enabled example: false autoLoadAmount: type: number examples: - 1000 description: Auto-load amount example: 1000 autoLoadThreshold: type: number examples: - 100 description: Auto-load threshold example: 100 CardLimits: type: object description: Card limits properties: spendingLimit: type: number examples: - 5000 description: Spending limit example: 5000 dailyLimit: type: number examples: - 1000 description: Daily limit example: 1000 monthlyLimit: type: number examples: - 10000 description: Monthly limit example: 10000 perTransactionLimit: type: number examples: - 2500 description: Per transaction limit example: 2500 atmDailyLimit: type: number examples: - 500 description: ATM daily limit example: 500 atmPerTransactionLimit: type: number examples: - 300 description: ATM per transaction limit example: 300 ````