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

# List Card Products

> Returns the catalog of available card products with their limits, fees, and features.



## OpenAPI

````yaml GET /cards/products
openapi: 3.1.0
info:
  title: KemyCard API
  version: '1.0'
  description: >
    KemyCard API allows you to issue virtual and physical cards, manage KYC/POA
    verification,

    create crypto wallets, virtual bank accounts, and purchase gift cards.
  contact:
    name: KemyCard API Support
    email: hi@kemycard.com
servers:
  - url: https://api.kemycard.com/v1
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Customers
    description: Manage your customers
  - name: Card Products
    description: Browse the card product catalog
  - name: Cards
    description: Issue and manage cards
  - name: KYC
    description: Identity verification
  - name: POA
    description: Proof of address verification
  - name: Wallets
    description: Crypto wallets
  - name: Virtual Accounts
    description: Virtual bank accounts
  - name: Gift Cards
    description: Gift card catalog and purchases
  - name: Balance
    description: Operational balances and transaction history
  - name: Webhooks
    description: Webhook endpoints and delivery management
paths:
  /cards/products:
    get:
      tags:
        - Card Products
      summary: List card products
      description: >-
        Returns the catalog of available card products with their limits, fees,
        and features.
      operationId: listCardProducts
      parameters:
        - name: brand
          in: query
          schema:
            type: string
            enum:
              - MASTERCARD
              - VISA
          description: Filter by card brand
        - name: type
          in: query
          schema:
            type: string
            enum:
              - virtual
              - physical
          description: Filter by card type
        - name: currency
          in: query
          schema:
            type: string
            example: USD
          description: Filter by currency
      responses:
        '200':
          description: Product list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CardProductListResponse'
components:
  schemas:
    CardProductListResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        data:
          type: array
          items:
            $ref: '#/components/schemas/CardProduct'
        meta:
          allOf:
            - $ref: '#/components/schemas/Meta'
            - type: object
              properties:
                total:
                  type: integer
                  description: Number of products returned
                  example: 3
    CardProduct:
      type: object
      properties:
        code:
          type: string
          format: uuid
        name:
          type: string
          example: Mastercard Virtual Basic
        description:
          type: string
          nullable: true
          example: Virtual Mastercard for online transactions
        brand:
          type: string
          enum:
            - MASTERCARD
            - VISA
        currency:
          type: string
          example: USD
        type:
          type: string
          enum:
            - virtual
            - physical
        is_issuable:
          type: boolean
          description: Whether new cards can be created for this product
        is_reloadable:
          type: boolean
          description: Whether cards of this product can be topped up
        required_level:
          type: string
          enum:
            - basic
            - verified
            - full
          description: Minimum KYC level required to order this product
        limits:
          type: object
          properties:
            max_balance:
              type: number
              example: 1000
            min_reload:
              type: number
              example: 5
            max_reload:
              type: number
              example: 1000
            spend_limit_monthly:
              type: number
              description: Monthly spending limit for a customer with approved KYC
              example: 5000
            spend_limit_monthly_without_kyc:
              type: number
              description: Monthly spending limit for a customer without KYC
              example: 1000
            max_card_per_user:
              type: integer
              description: >-
                Maximum number of active cards per customer with approved KYC. 0
                means unlimited (see unlimited_cards)
              example: 3
            max_card_per_user_without_kyc:
              type: integer
              description: Maximum number of active cards per customer without KYC
              example: 1
            unlimited_cards:
              type: boolean
              description: >-
                True when the number of cards per customer with approved KYC is
                unlimited
              example: false
            period_of_validity_months:
              type: integer
              example: 24
        features:
          type: object
          properties:
            google_pay:
              type: boolean
            apple_pay:
              type: boolean
            atm_available:
              type: boolean
            addons:
              type: boolean
              description: >-
                Whether the product supports add-on cards sharing the same
                balance
        initial_load:
          type: object
          description: Initial load required when the card is created
          properties:
            required:
              type: boolean
              description: Whether the card must be loaded at creation
              example: true
            min:
              type: number
              nullable: true
              description: Minimum initial load amount. Null when required is false
              example: 10
            max:
              type: number
              nullable: true
              description: Maximum initial load amount. Null when required is false
              example: 2500
        fees:
          type: object
          description: >
            Fees debited from your `cards_visa` or `cards_mastercard` balance.
            Card creation: `card_fee` + service fee on the initial load.

            Top-up: service fee on the amount. The service fee is
            `service_fee_percent` of the amount, with a

            minimum of `service_fee_min`. The `_with_kyc` values apply when the
            customer's KYC is approved.

            `monthly_fee`, `auth_fee` and `fx_cross_border_fee` are free-text
            and charged on the card itself.
          properties:
            card_fee:
              type: number
              description: >-
                Fee charged when a card is created for a customer without
                approved KYC
              example: 30
            card_fee_with_kyc:
              type: number
              description: >-
                Fee charged when a card is created for a customer with approved
                KYC
              example: 20
            service_fee_percent:
              type: number
              description: >-
                Service fee, in percent of the loaded amount (customer without
                approved KYC)
              example: 5
            service_fee_min:
              type: number
              description: Minimum service fee per load (customer without approved KYC)
              example: 5
            service_fee_percent_with_kyc:
              type: number
              example: 3.5
            service_fee_min_with_kyc:
              type: number
              example: 3.5
            monthly_fee:
              type: string
              nullable: true
            auth_fee:
              type: string
              nullable: true
            fx_cross_border_fee:
              type: string
              nullable: true
              example: 3%
        atm_limits:
          type: object
          nullable: true
          description: Present only when features.atm_available is true
          properties:
            amount_per_transaction:
              type: number
              nullable: true
              example: 500
            amount_per_month:
              type: number
              nullable: true
              example: 5000
            transactions_per_day:
              type: integer
              nullable: true
              example: 3
    Meta:
      type: object
      properties:
        request_id:
          type: string
          example: a4f8e2c1b3d97056
        mode:
          type: string
          enum:
            - test
            - live
          example: test
        timestamp:
          type: string
          format: date-time
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API key (sk_test_... or sk_live_...)

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.