> ## 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 Arts
> Personal Visa only
Returns the card arts available to the issuing account. The list combines the channel's system-default card art and any card arts bound to the account or its master account.
Use this endpoint to populate a card-art picker before [creating](/card-issuance/v1.6/api-reference/create-card) or [updating](/card-issuance/v1.6/api-reference/update-card) a card.
## OpenAPI
````yaml /card-issuance/v1.6/issuing.yaml get /v1/issuing/cards/arts
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/cards/arts:
get:
tags:
- Card Arts
summary: List Card Arts
description: >
Personal Visa only
Returns the card arts available to the issuing account. The list
combines the channel's system-default card art and any card arts bound
to the account or its master account.
Use this endpoint to populate a card-art picker before
[creating](/card-issuance/v1.6/api-reference/create-card) or
[updating](/card-issuance/v1.6/api-reference/update-card) a card.
operationId: list-card-arts
parameters:
- $ref: '#/components/parameters/XOnBehalfOf'
- name: product_id
in: query
required: false
description: >-
Filter the results to the card arts available for this card product.
Omit to return all card arts available to the account.
schema:
type: string
format: uuid
example: 467e993f-317a-49fc-9ea0-bf49de7d1f76
responses:
'200':
headers:
x-response-id:
$ref: '#/components/headers/XResponseId'
description: Card arts retrieved successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/CardArtListResponse'
title: ListCardArtsResponse
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
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:
CardArtListResponse:
type: object
required:
- default_card_art_id
- card_arts
properties:
default_card_art_id:
allOf:
- $ref: '#/components/schemas/CardArtId'
- description: >-
The issuing account's current default card art. A `Create Card`
call that omits `card_art_id` uses this value.
card_arts:
type: array
description: >-
Card arts available to the issuing account, ordered with the default
first, then system-configured arts, then account-bound arts.
items:
$ref: '#/components/schemas/CardArtItem'
CardArtId:
type: string
example: 01KD52BKQWDMFF63R1NNQN7A79
description: >-
Identifier of a card art. Stable across card products; reuse the same
value when creating multiple cards with the same design.
CardArtItem:
type: object
required:
- card_art_id
- description
- is_default
- is_system_config
properties:
card_art_id:
$ref: '#/components/schemas/CardArtId'
description:
type: string
example: Premium Black
description: >-
Display name for the card art. Safe to surface in your own card-art
picker.
is_default:
type: boolean
example: true
description: >-
Whether this card art is the issuing account's current default. A
`Create Card` call that omits `card_art_id` uses the default.
is_system_config:
type: boolean
example: false
description: >-
Whether this card art comes from the channel's system configuration
(always available to every account on the channel). When `false`,
the card art is bound specifically to the issuing account or its
master account.
securitySchemes:
XAuthToken:
type: apiKey
in: header
name: x-auth-token
description: The API token for login provided by UQPay.
````