---
title: "Get list of card accounts"
method: GET
path: "/v3/funding-accounts/cards"
tags: ["funding-accounts"]
---

# Get list of card accounts

`GET /v3/funding-accounts/cards`

Get a list of card account objects.

## Query parameters

- `cardUserStatus` 'VERIFIED' | 'NOMINATED', required — Card user status

## Headers

- `sessionId` string, nullable — API session ID generated with `/v3/login`
- `devKey` string, nullable — Developer key generated with your BILL developer account

## Response `200`

Get list of card accounts response

- ListPayableCardAccountsResponseDto — List Card Accounts response DTO.
  - `rates` object — Applicable card rates
    - `defaultCardAccountId` string — ID of the default card account
    - `funding` object — Card funding rates
      - `creditCardRate` number — Credit card funding rate
      - `debitCardRate` number — Debit card funding rate
    - `activePromotion` object — Active promotions on the card
      - `startDate` string, date-time — Promotion start date
      - `endDate` string, date-time — Promotion end date
      - `creditCardRate` number — Credit card rate
      - `debitCardRate` number — Debit card rate
  - `cards` CardAccountResponseDto[] — List of card accounts
    - `id` string, required — BILL-generated ID of the card account. The value begins with `cat`.
    - `archived` boolean, required — Set as `true` if the card account is archived
    - `createdTime` string, date-time — Created date and time
    - `updatedTime` string, date-time — Updated date and time
    - `createdBy` string — BILL-generated ID of the user that created the card account. The value begins with `006`.
    - `issuingBankName` string — Card issuing bank name
    - `nameOnAccount` string — Full name on card account
    - `brand` string — Card brand
    - `type` 'UNDEFINED' | 'CREDIT_CARD' | 'DEBIT_CARD' | 'PREPAID_CARD' | 'UNKNOWN' — Card type.
    - `status` 'NOT_VERIFIED' | 'VERIFIED' | 'PENDING' | 'BLOCKED' | 'EXPIRED' | 'INVALID' | 'UNDEFINED' — Card account status.
    - `last4` string — Card last four digits
    - `expiration` object — Card expiration information
      - `year` string
      - `month` string
    - `default` object — Card payment defaults for BILL operations
      - `payables` boolean — Set as `true` if the card account is set as default for Accounts Payable operations
      - `receivables` boolean — Set as `true` if the card account is set as default for Accounts Receivable operations
      - `funding` boolean — Set as `true` if the card account is set as default for funding
      - `disbursement` boolean — Set as `true` if the card account is set as default for disbursement

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/revisions/0483350c434e/schema)