---
title: "List Arc-issued cards."
method: GET
path: "/cards"
tags: ["Accounts"]
---

# List Arc-issued cards.

`GET /cards`

## Query parameters

- `limit` string — Page size, 1–100 (default 25).
- `cursor` string — Opaque cursor from a prior response nextCursor.
- `scope` 'own' | 'team' — own (default) shows your cards; team shows the company’s.
- `status` 'active' | 'inactive' | 'canceled' — Filter by card status.
- `format` 'physical' | 'virtual' — Filter by card form factor.
- `cardholder` string — Case-insensitive substring match on the cardholder name.
- `last4` string — Exactly this masked last-4 (four digits) — the only per-card handle, since cards carry no public id.

## Response `200`

A page of cards.

- object
  - `data` Card[], required
    - `last4` string, required
    - `type` 'debit', required
    - `format` 'physical' | 'virtual', required
    - `cardholder` string, required
    - `status` 'active' | 'inactive' | 'canceled', required
    - `limit` object, nullable, required — An amount as integer minor units plus its currency.
      - `minorUnits` integer, required — Integer minor units (e.g. cents for USD); never a float.
      - `currency` string, required — ISO 4217 currency code, e.g. "USD".
    - `createdAt` string, required — ISO 8601 timestamp, UTC.
  - `nextCursor` string, nullable, required — Pass back as ?cursor for the next page; null on the last page.

---

[API](https://skmtc.dev/joinarc/apis/arc-api.md) · [All operations](https://skmtc.dev/joinarc/apis/arc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinarc/arc-api/revisions/f0dc4aa0fe84/schema)