---
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`

## Request

- Base URL: `https://gateway.stage.bill.com/connect`
- URL: `https://gateway.stage.bill.com/connect/v3/funding-accounts/cards`
- Auth: none declared

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: Card expiration year
      - `month` string: Card expiration month
    - `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.dev/bill/apis/bill-v3-api.md) - [All operations](https://skmtc.dev/bill/apis/bill-v3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bill/apis/bill-v3-api/revisions/54edddceb0a5?raw)