---
title: "List payment cards"
method: GET
path: "/v1/cards"
tags: ["Payment Cards"]
---

# List payment cards

`GET /v1/cards`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/cards`
- Auth: HTTP bearer

List cards for the caller (agents see only their own). Always masked (last4 only).

## Response `200`

Card list

- CardListResponse
  - `cards` CardResponse[], required
    - `id` string, uuid, required
    - `agent_id` string, uuid, nullable
    - `issuer` 'laso' | 'manual', required
    - `kind` 'prepaid' | 'gift_card', required
    - `brand` string
    - `last4` string
    - `exp_month` integer
    - `exp_year` integer
    - `currency` string, required
    - `order_amount_usd` string
    - `balance` string
    - `status` 'ordering' | 'pending' | 'ready' | 'depleted' | 'expired' | 'voided' | 'orphaned_payment' | 'awaiting_approval' | 'rejected', required
    - `storage_mode` 'reference' | 'full', required
    - `reveal_policy` object, required
    - `approval_id` string, uuid: Linked approval when status is awaiting_approval
    - `void_after` string, date-time
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/ae109b496830?raw)