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

# List Card Products

> Returns a list of issuing product objects.



## OpenAPI

````yaml /card-issuance/v1.6/issuing.yaml get /v1/issuing/products
openapi: 3.0.2
info:
  title: Issuing API
  version: 0.0.1
  description: >
    UQPAY Issuing API allows you to issue virtual cards, manage cardholders, and
    monitor card transactions.


    ## What you can do

    - Create and manage virtual cards (issue, activate, freeze, cancel)

    - Onboard and verify cardholders with KYC

    - Set spending limits and card controls

    - Recharge and withdraw card balances

    - Query card transactions and account balances

    - Transfer funds between issuing accounts

    - Generate and download reports


    ## Authentication

    All requests require a valid auth token obtained via the [Access
    Token](/account-center/v1.6/api-reference/access-token) endpoint. Include
    the token in the `x-auth-token` header.


    ## Idempotency

    POST requests support the `x-idempotency-key` header to safely retry without
    creating duplicate resources.
  contact:
    name: UQPAY Support Team
    url: https://www.uqpay.com/support
    email: support@uqpay.com
  license:
    name: Proprietary
    url: https://www.uqpay.com/legal/api-terms
  termsOfService: https://www.uqpay.com/legal/terms
  x-api-id: uqpay-issuing-api-v1.6.0
  x-categories:
    - Card Issuing
    - Transaction Processing
  x-features:
    - Virtual Card Issuance
    - Real-time Processing
    - Webhook Notifications
    - Comprehensive Reporting
    - Transaction Monitoring
servers:
  - url: https://api-sandbox.uqpaytech.com/api
    description: Sandbox base URL.
  - url: https://api.uqpay.com/api
    description: Production base URL.
security: []
tags:
  - name: Card Lifecycle
    description: >-
      Create cards and manage their full lifecycle — issue, retrieve, update,
      activate, assign, and change status.
  - name: Card Secure Data
    description: >-
      Access sensitive card data (PAN, CVV) through the PCI-compliant endpoint
      or a tokenized iframe. Availability depends on your PCI status, not the
      card product.
  - name: Card Funding
    description: Load and unload a card's stored balance for prepaid-style cards.
  - name: Card PIN
    description: >-
      Set and manage card PINs. `reset-pin` covers physical cards;
      `manage-card-pin` covers virtual cards.
  - name: Card Add-ons
    description: >-
      Product-specific card capabilities. Each operation applies only to certain
      card products — see [Card
      products](/card-issuance/v1.6/guide/card-products).
  - name: Card Arts
    description: >-
      Manage the visual designs (card arts) available to your issuing account.
      Set an account-wide default, or pass `card_art_id` when issuing or
      updating a card to override per card. Available on Personal Visa.
  - name: Cardholders
    description: >-
      You can create cardholders, which are authorized representatives of your
      business that can be issued cards.
  - name: Transactions
    description: >-
      These APIs allow you to retrieve information on transactions that are made
      on your user's cards.
  - name: Products
    description: >-
      With this set of APIs, you will be able to create card orders for your
      customers.
  - name: Balances
    description: >-
      The available and pending amounts for each currency are broken down
      further by payment source types. You can retrieve it to see the balance
      currently on your issuing account.
  - name: Transfers
    description: Transfer funds between issuing accounts.
  - name: Reports
    description: Generate and download issuing reports.
  - name: Simulator
    description: Simulate card transactions on the sandbox environment.
paths:
  /v1/issuing/products:
    get:
      tags:
        - Products
      summary: List Card Products
      description: Returns a list of issuing product objects.
      operationId: list-card-products
      parameters:
        - $ref: '#/components/parameters/XOnBehalfOf'
        - $ref: '#/components/parameters/PageSize'
        - $ref: '#/components/parameters/PageNumber'
      responses:
        '200':
          description: OK - Products returned successfully.
          headers:
            x-response-id:
              $ref: '#/components/headers/XResponseId'
          content:
            application/json:
              schema:
                title: ListProductsResponse
                properties:
                  total_pages:
                    $ref: '#/components/schemas/TotalPages'
                  total_items:
                    $ref: '#/components/schemas/TotalItems'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CardProductsResponse'
              example:
                total_pages: 1
                total_items: 2
                data:
                  - product_id: 467e993f-317a-49fc-9ea0-bf49de7d1f76
                    mode_type: SHARE
                    card_bin: '40963608'
                    card_form:
                      - VIR
                      - PHY
                    max_card_quota: 100
                    card_scheme: VISA
                    no_pin_payment_amount:
                      - currency: USD
                        amount: '2000'
                      - currency: SGD
                        amount: '2600'
                    card_currency:
                      - USD
                      - SGD
                    create_time: '2025-10-10T17:36:26+08:00'
                    update_time: '2026-01-14T15:34:57+08:00'
                    product_status: ENABLED
                    required_fields:
                      - name: first_name
                        type: string
                        required: true
                      - name: last_name
                        type: string
                        required: true
                      - name: email
                        type: string
                        required: true
                      - name: country_code
                        type: string
                        required: true
                      - name: date_of_birth
                        type: string
                        required: true
                      - name: phone_number
                        type: string
                        required: true
                  - product_id: ee1598df-dff3-4d74-98a0-e219ab9d4320
                    mode_type: SHARE
                    card_bin: '539578'
                    card_form:
                      - VIR
                    max_card_quota: 3000
                    card_scheme: MASTERCARD
                    no_pin_payment_amount:
                      - currency: USD
                        amount: '2000'
                      - currency: SGD
                        amount: '2600'
                    card_currency:
                      - USD
                      - SGD
                    create_time: '2025-10-20T16:29:34+08:00'
                    update_time: '2025-10-20T16:34:54+08:00'
                    product_status: ENABLED
                    required_fields:
                      - name: first_name
                        type: string
                        required: true
                      - name: last_name
                        type: string
                        required: true
                      - name: email
                        type: string
                        required: true
                      - name: country_code
                        type: string
                        required: true
                      - name: date_of_birth
                        type: string
                        required: true
                      - name: phone_number
                        type: string
                        required: true
                      - name: gender
                        type: string
                        required: true
                      - name: nationality
                        type: string
                        required: true
                      - name: identity
                        type: object
                        required: true
                        fields:
                          - name: type
                            type: string
                            required: true
                          - name: number
                            type: string
                            required: true
                          - name: front_file
                            type: string
                            required: true
                          - name: back_file
                            type: string
                            required: false
                          - name: hand_file
                            type: string
                            required: false
                      - name: residential_address
                        type: object
                        required: true
                        fields:
                          - name: country
                            type: string
                            required: true
                          - name: state
                            type: string
                            required: true
                          - name: city
                            type: string
                            required: true
                          - name: district
                            type: string
                            required: false
                          - name: line1
                            type: string
                            required: true
                          - name: line2
                            type: string
                            required: false
                          - name: line_en
                            type: string
                            required: true
                          - name: postal_code
                            type: string
                            required: false
      security:
        - XAuthToken: []
components:
  parameters:
    XOnBehalfOf:
      in: header
      name: x-on-behalf-of
      schema:
        type: string
      required: false
      description: >
        Specifies the sub-account on whose behalf the request is made. This
        should be set to the `account_id`, which can be retrieved via the [List
        Connected
        Accounts](/account-center/v1.6/api-reference/list-connected-accounts)
        endpoint. If omitted or empty, the request is executed using the master
        account.

        More information at [Connected
        Accounts](/account-center/v1.6/guide/connected-accounts).
      example: 18523f72-f4de-4f9c-bb8e-ec7d1c4f32be
    PageSize:
      name: page_size
      description: >-
        The maximum number of items to return per page. This number can be
        between 10 - 100, and will default to 10
      in: query
      required: true
      schema:
        type: integer
        minimum: 10
        maximum: 100
        default: 10
    PageNumber:
      name: page_number
      description: >-
        The page number to retrieve the next set of items. The number has to be
        greater than 1, and will default to 1
      in: query
      required: true
      schema:
        type: integer
        minimum: 1
        default: 1
  headers:
    XResponseId:
      description: >-
        Universally unique identifier (UUID v4) for the response. Helpful for
        identifying a request when communicating with UQPAY support.
      schema:
        type: string
        format: uuid
        example: 2adba88e-9d63-44bc-b975-9b6ae3440dde
  schemas:
    TotalPages:
      type: integer
      example: 1
      description: The total pages of available items.
    TotalItems:
      type: integer
      example: 10
      description: The total counts of available items.
    CardProductsResponse:
      type: object
      required:
        - product_id
        - card_bin
        - card_type
        - card_mode
        - card_scheme
        - create_time
        - update_time
        - product_status
        - no_pin_payment_amount
        - card_form
        - card_currency
      properties:
        product_id:
          $ref: '#/components/schemas/CardId'
        mode_type:
          $ref: '#/components/schemas/ModeType'
        card_bin:
          $ref: '#/components/schemas/CardBin'
        card_form:
          description: >
            Indicates the supported card form(s) for this product under the
            current account.

            Returned as an array:

            - `VIR` represents a virtual card.

            - `PHY` represents a physical card.
          type: array
          items:
            type: string
          example:
            - VIR
        max_card_quota:
          type: integer
          description: >
            The maximum number of cards that can be issued for this product
            under the current account.
          example: 100
        card_scheme:
          $ref: '#/components/schemas/CardScheme'
        no_pin_payment_amount:
          $ref: '#/components/schemas/NoPINPaymentAmountArrayInResponse'
        card_currency:
          type: array
          items:
            type: string
          example:
            - SGD
            - USD
          description: >-
            Specifies the currencies available for issuing cards with this
            product. Returned as an array of strings.
        create_time:
          description: Time at which the object was created.
          type: string
          example: '2023-09-15T10:02:17+08:00'
        update_time:
          description: Time at which the object was updated.
          type: string
          example: '2023-09-15T10:02:17+08:00'
        product_status:
          type: string
          example: ENABLED
          description: |
            Product status - one of `ENABLED`, `DISABLED`.
            This field is mandatory and must be one of:
              * `ENABLED` - Product enabled.
              * `DISABLED` - Product disabled.
        required_fields:
          type: array
          description: >-
            The list of cardholder fields required by this product's card BIN
            for KYC verification. Returned when configured.
          items:
            $ref: '#/components/schemas/ProductRequiredField'
    CardId:
      type: string
      example: c0cef051-29c5-4796-b86a-cd5b684bfad7
      description: Unique identifier for the card.
    ModeType:
      type: string
      example: SHARE
      enum:
        - SHARE
        - SINGLE
      description: |
        Mode type enum - SINGLE or SHARE. 

          * `SINGLE` - A single card only has prepaid mode.
          * `SHARE` - A share card can have debit mode, meaning it is associated with debit program and account.
    CardBin:
      type: string
      example: '40963608'
      description: Card number prefix (BIN).
    CardScheme:
      type: string
      example: VISA
      description: Card scheme.
    NoPINPaymentAmountArrayInResponse:
      type: array
      description: >
        The maximum allowable amounts for no-PIN card transactions, specified
        per currency.

        Each item in the array represents the upper limit that can be configured
        for NO-PIN payments in a specific currency under the current card
        product.
      items:
        type: object
        required:
          - amount
          - currency
        properties:
          amount:
            type: string
            description: Amount for NO-PIN payment.
            example: '2000'
          currency:
            type: string
            description: ISO 4217 currency code (e.g., USD, SGD).
            example: USD
    ProductRequiredField:
      type: object
      description: >-
        A field required by the card BIN for cardholder KYC. When `type` is
        `object`, the `fields` array describes the sub-fields.
      properties:
        name:
          type: string
          description: The field name.
          example: identity
        type:
          type: string
          description: 'The field data type: `string` or `object`.'
          example: object
        required:
          type: boolean
          description: Whether this field is mandatory.
          example: true
        description:
          type: string
          description: A human-readable description of the field.
          example: Identity document information
        fields:
          type: array
          description: >-
            Sub-fields when `type` is `object`. Structure is the same as the
            parent `required_fields` item.
          items:
            $ref: '#/components/schemas/ProductRequiredField'
  securitySchemes:
    XAuthToken:
      type: apiKey
      in: header
      name: x-auth-token
      description: The API token for login provided by UQPay.

````