---
title: "Report a Card Data Issue"
method: POST
path: "/v1/cards/issues"
tags: ["Card Issues"]
---

# Report a Card Data Issue

`POST /v1/cards/issues`

Report a data issue for a specific card. Use this endpoint to flag problems such as incorrect prices,
wrong variants, missing data, or date errors. Issues are tracked and resolved by our data team.

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

**Status lifecycle:** `new` → `in_progress` → `resolved`

**Example curl:**
```bash
curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "card_id": "1587446850514x224832321163624450",
       "card_title": "2018 Topps Chrome Shohei Ohtani #150 Refractor",
       "issue_description": "PSA 10 price showing $250 but recent comps are consistently $2,500+"
     }' \
     "https://api.cardhedger.com/v1/cards/issues"
```

## Request body

- CardIssueCreate — Request body for submitting a card data issue.
  - `card_id` string, required — The unique card ID from CardHedge (e.g. from card-search or card-details)
  - `card_title` string, nullable — Optional card title for context (e.g. '2018 Topps Chrome Shohei Ohtani #150 Refractor')
  - `issue_description` string, required — Detailed description of the data issue — what is wrong and what the correct value should be (minimum 10 characters)

## Response `201`

Issue created successfully

- CardIssueResponse — Response returned after successfully creating a card issue.
  - `id` integer, required — Unique issue ID — use this to check status later
  - `status` string, required — Issue status (always 'new' on creation)
  - `created_at` string, date-time, required — Timestamp when the issue was created

## 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)