---
title: "List Cards with Negative Balance"
method: GET
path: "/open-api/v3/card-balance-negative-list"
tags: ["Card"]
---

# List Cards with Negative Balance

`GET /open-api/v3/card-balance-negative-list`

Fetch card balance negative cards info

## Query parameters

- `accountId` string, uuid, required — The UUID of the Account.
- `cardId` string, uuid — The UUID of the Card.
- `budgetId` string, uuid — The UUID of the budget.
- `cardholderId` string — The ID of the cardholder.
- `label` string — Custom card label or tag
- `status` string — Card status: INACTIVE,CONTROL,ACTIVE,PENDING,FROZEN
- `referenceId` string — Optional filter parameter. When provided, only the card with the matching referenceId will be returned. This value corresponds to the unique identifier you assigned when creating the card.
- `limit` string, number — Limits the number of items to be returned.
- `page` string, number — The page to be returned, counting from 1 as the first page.

## Response `200`

OK

- PageCardBalanceNegativeResource — card balance negative resource
  - `code` string — Return code
  - `message` string — Error message
  - `data` PageResourceCardBalanceNegativeResource — Returned data
    - `list` CardBalanceNegativeResource[] — List of data items
      - `card` CardResource — Returned data
        - `id` string — Unique identifier of the card
        - `accountId` string — Account ID
        - `status` string — Card status. Values: INACTIVE,CONTROL,ACTIVE,PENDING,FROZEN
        - `currency` string — Currency code
        - `bin` string — Card BIN (Bank Identification Number)
        - `userName` string — User name
        - `createTime` string — Card creation time
        - `cardLastFour` string — Last four digits of the card number
        - `billingAddress` AddressResource — Card address
          - `addressLine1` string — First line of the address
          - `addressLine2` string — Second line of the address
          - `city` string — City
          - `country` string — Country
          - `postalCode` string — Postal code
          - `state` string — State
        - `label` string — Card label
        - `balanceId` string — Balance ID
        - `budgetId` string — Budget ID (Only for Budget Card)
        - `cardholderId` string — Cardholder ID
        - `referenceId` string — A unique identifier assigned by you for each card. This value must be unique per card request and will be used later to query or track the corresponding card.
        - `cardMode` 'PHYSICAL_CARD' | 'VIRTUAL_CARD' — Card mode. Example: VIRTUAL_CARD
        - `transactionLimits` TransactionLimitsResource[] — Limit information
          - `type` string — Type of card spending limit. The quota will reset at 00:00 (GMT+8). Values: DAY,WEEK,MONTH,QUARTER,YEAR,LIFETIME,TRANSACTION,NA
          - `value` string — Card spending limit amount
          - `currency` string — Currency code
        - `cardStatusChangeRecordList` CardStatusChangeRecordResource[] — card status change record list
          - `userId` string — user id
          - `accountId` string — account id
          - `cardId` string — card id
          - `operationTime` string — operation time, millisecond timestamp
          - `beforeStatus` string — before status
          - `afterStatus` string — after status
          - `reasonCode` string — reason code:7001:Created via merchant portal, 7002:Created via API, 1001:Closed via Open API, 1002:Closed via merchant portal, 1003:Closed due to risk policy violation, 1004:Closed by administrator, 1005:Closed due to BIN decommission, 1006:Closed due to account termination, 1007:Automatic deletion upon card expiration, 2001:Activated via Open API, 2002:Activated via merchant portal, 3001:Suspended via Open API, 3002:Suspended via merchant portal, 5001:Restricted by administrator, 6001:Unrestricted by administrator,
          - `reasonMessage` string — reason message
          - `requestUrl` string — request url
      - `cardWallet` CardWalletResource — card wallet resources
        - `id` string, required — Unique ID generated for the entity
        - `accountId` string, required — The UUID of the Account
        - `createTime` string — Creation time
        - `currency` string, required — Currency code. Example: USD, EUR, CNY
        - `available` string, required — Available balance
        - `frozen` string, required — Frozen amount
        - `walletType` '0' | '1' | '2', required — Specifies the type of balance object. Object type: 0-Infinity Account balance，1-budget balance，2-prepaid card balance
        - `objectType` '0' | '1' | '2', required — Specifies the type of balance object. Object type: 0-Infinity Account balance，1-budget balance，2-prepaid card balance
    - `total` integer — Total number of records

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/interlace/apis/core-resource.md) · [All operations](https://skmtc.dev/interlace/apis/core-resource/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interlace/core-resource/revisions/29c08a4da357/schema)