---
title: "Get Card Details by ID"
method: POST
path: "/v1/cards/card-details"
tags: ["Card Details"]
---

# Get Card Details by ID

`POST /v1/cards/card-details`

## Request

- Base URL: `https://api.cardhedger.com`
- URL: `https://api.cardhedger.com/v1/cards/card-details`
- Auth: API key in header `X-API-Key`

Get detailed information for a specific card by its ID.

Requires a card_id. If you only have a card name/description, call `card-match` or
`card-search` first to get the card_id, then use it here.

Fetches card details from CardHedge database using the card's unique identifier.
Returns the same data structure as card search endpoint.

**Example curl:**
```bash
curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{"card_id": "1586812246197x228181943611293700"}' \
     "https://api.cardhedger.com/v1/cards/card-details"
```

Returns card with pricing, sales data, and metadata.

## Request body

- CardDetailsRequest: Request parameters for card details endpoint.
  - `card_id` string, required: Unique card identifier from CardHedge
  - `raw_images_only` boolean, nullable: Deprecated and ignored: this endpoint now always returns the raw card photo (not the graded slab image). The field is retained for backward compatibility but no longer affects the response.

## Response `200`

Successful Response

- CardSearchResponse: Response model for card search endpoint.
  - `pages` integer: Total number of pages available
  - `count` integer: Total number of matching cards
  - `count_capped` boolean: True when `count` is a capped value and the real total is higher (filter-only browses cap the count for performance). Render as `count`+ — e.g. "10,000+".
  - `cards` CardSearchCard[], required: List of matching cards
    - `description` string, required: Full card description
    - `player` string, required: Player or character name
    - `set` string, required: Card set name
    - `number` string, required: Card number in set
    - `variant` string, required: Card variant (e.g., 'Base', 'Reverse Foil')
    - `card_id` string, required: Unique card identifier
    - `image` string, required: Card image URL
    - `category` string, required: Card category
    - `category_group` string, required: Category group
    - `set_type` string, required: Set type
    - `7 Day Sales` integer, required: Sales in last 7 days
    - `30 Day Sales` integer, required: Sales in last 30 days
    - `rookie` boolean, required: Whether the card is a rookie card
    - `gain` number, required: Price gain percentage
    - `prices` CardPrice[], required: Price information at different grades
      - `grade` string, required: Card grade (e.g., 'Raw', 'PSA 10')
      - `price` string, required: Price in string format
    - `subset` string, nullable: Card subset within the set (e.g. 'Base Set', 'Chrome'); null when the card has no subset

## Other responses

- `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.dev/cardhedger/apis/card-hedge-api/revisions/6de42f192a4d?raw)