> ## 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 Issuing Balances Transactions > Returns a list of transactions that have contributed to the issuing account balance (e.g., charges, fee, and so forth). ## OpenAPI ````yaml /card-issuance/v1.6/issuing.yaml get /v1/issuing/balances/transactions 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/balances/transactions: get: tags: - Balances summary: List Issuing Balances Transactions description: >- Returns a list of transactions that have contributed to the issuing account balance (e.g., charges, fee, and so forth). operationId: list-issuing-balances-transactions parameters: - $ref: '#/components/parameters/XOnBehalfOf' - $ref: '#/components/parameters/PageSize' - $ref: '#/components/parameters/PageNumber' - $ref: '#/components/parameters/StartTime' - $ref: '#/components/parameters/EndTime' - $ref: '#/components/parameters/BalanceTransactionType' - $ref: '#/components/parameters/BalanceTransactionStatus' - $ref: '#/components/parameters/BalanceTransactionCurrency' - $ref: '#/components/parameters/BalanceTransactionId' responses: '200': description: OK - Balances transactions returned successfully. headers: x-response-id: $ref: '#/components/headers/XResponseId' content: application/json: schema: title: listIssuingBalancesResponse properties: total_pages: $ref: '#/components/schemas/TotalPages' total_items: $ref: '#/components/schemas/TotalItems' data: type: array items: type: object required: - transaction_id - short_transaction_id - account_id - account_name - balance_id - transaction_type - currency - amount - create_time - complete_time - transaction_status - ending_balance - description properties: transaction_id: $ref: '#/components/schemas/TransactionId' short_transaction_id: $ref: '#/components/schemas/ShortTransactionId' account_id: type: string description: The account id. example: 72970a7c-7921-431c-b95f-3438724ba16f balance_id: type: string description: The account balance id. example: 72970a7c-7921-431c-b95f-3438724ba16f transaction_type: type: string description: >- The transaction type of issuing balances transactions. example: DEPOSIT enum: - DEPOSIT - TRANSFER_IN - TRANSFER_OUT - ISSUING_AUTHORIZATION - ISSUING_REVERSAL - ISSUING_REFUND - CARD_RECHARGE - CARD_WITHDRAW - SETTLEMENT_DEBIT - SETTLEMENT_CREDIT - SETTLEMENT_REVERSAL - FEE - REFUND - ADJUSTMENT - FUNDS_TRANSFER_IN - FUNDS_TRANSFER_OUT - FEE_REFUND - FEE_DEDUCTION - MARGIN_PAYMENT - MARGIN_REFUND - OTHER currency: type: string description: >- Currency of the transaction. Three-letter ISO 4217 currency code. example: USD amount: type: number description: Transaction amount. example: 100.02 create_time: $ref: '#/components/schemas/CreateTime' complete_time: $ref: '#/components/schemas/CompleteTime' transaction_status: type: string example: PENDING description: The transaction status. enum: - FAILED - PENDING - COMPLETED ending_balance: type: number description: Balance after the transaction. example: 100.02 description: type: string description: Description of the transaction. example: Creation card, fee 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 StartTime: name: start_time description: >- The earliest transaction creation time to filter by. The maximum time interval between start_time and end_time is 90 days. in: query required: false schema: type: string example: '2024-03-21T17:17:32+08:00' EndTime: name: end_time description: >- The latest transaction creation time to filter by. The maximum time interval between start_time and end_time is 90 days. in: query required: false schema: type: string example: '2024-03-21T17:17:32+08:00' BalanceTransactionType: name: transaction_type description: Transaction type filter for issuing balance transactions. in: query required: false schema: type: string example: DEPOSIT enum: - ISSUING_AUTHORIZATION - ISSUING_REVERSAL - ISSUING_REFUND - CARD_RECHARGE - CARD_WITHDRAW - FEE - DEPOSIT - TRANSFER_IN - TRANSFER_OUT - SETTLEMENT_DEBIT - SETTLEMENT_CREDIT - ADJUSTMENT - FUNDS_TRANSFER_IN - FUNDS_TRANSFER_OUT - FEE_REFUND - FEE_DEDUCTION - MARGIN_PAYMENT - MARGIN_REFUND - OTHER - SETTLEMENT_REVERSAL - REFUND BalanceTransactionStatus: name: transaction_status description: Transaction status filter for issuing balance transactions. in: query required: false schema: type: string example: COMPLETED enum: - COMPLETED - PENDING - FAILED BalanceTransactionCurrency: name: currency description: Currency filter. Three-letter ISO 4217 currency code. in: query required: false schema: type: string example: USD BalanceTransactionId: name: transaction_id description: Transaction ID filter (long ID). in: query required: false schema: $ref: '#/components/schemas/TransactionId' 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. TransactionId: type: string format: uuid description: Unique Identifier for transaction. example: 5135e6cc-28b6-4889-81dc-3b86a09e1395 ShortTransactionId: type: string format: uuid description: Short unique identifier for transaction. example: CT2024-03-01 CreateTime: type: string description: Create time at which the object was created. example: '2024-03-21T17:17:32+08:00' CompleteTime: type: string description: Completed time at which the object was created. example: '2024-03-21T17:17:32+08:00' securitySchemes: XAuthToken: type: apiKey in: header name: x-auth-token description: The API token for login provided by UQPay. ````