---
title: "List Your Card Issues"
method: GET
path: "/v1/cards/issues"
tags: ["Card Issues"]
---

# List Your Card Issues

`GET /v1/cards/issues`

List all card data issues submitted by your API key, ordered by most recent first.

Optionally filter by status to see only issues in a specific state.

**Requires Enterprise tier.** Returns 403 for Free and Pro tier API keys.

**Available statuses:** `new`, `in_progress`, `resolved`

**Example curl:**
```bash
# List all issues
curl -H "X-API-Key: your-api-key-here" \
     "https://api.cardhedger.com/v1/cards/issues"

# Filter by status
curl -H "X-API-Key: your-api-key-here" \
     "https://api.cardhedger.com/v1/cards/issues?status=new"
```

## Query parameters

- `status` string, nullable — Filter by status (e.g. new, in_progress, resolved)

## Response `200`

List of issues with total count

- CardIssueListResponse — Paginated list of card issues for the authenticated API key.
  - `issues` CardIssueDetail[], required — List of card issues, ordered by most recent first
    - `id` integer, required — Unique issue ID
    - `card_id` string, required — The card ID this issue relates to
    - `card_title` string, nullable — Card title (if provided at submission)
    - `issue_description` string, required — Description of the reported issue
    - `customer_id` integer, required — ID of the customer who submitted the issue
    - `status` string, required — Current status: `new` (submitted), `in_progress` (being reviewed), or `resolved` (fixed)
    - `resolution_description` string, nullable — Description of how the issue was resolved (populated when status is 'resolved')
    - `date_fixed` string, date-time, nullable — Timestamp when the issue was resolved (null until fixed)
    - `created_at` string, date-time, required — When the issue was submitted
    - `updated_at` string, date-time, required — When the issue was last updated
  - `total_count` integer, required — Total number of issues matching the query

## Other responses

- `403` — Enterprise tier required
- `422` — Validation Error

---

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