> ## Documentation Index
> Fetch the complete documentation index at: https://dev.phygitals.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get card details

> Returns full details for a single card: FMV, metadata, etc.

Returns the full record for a single card.

## Lookup behavior

The endpoint resolves `:item_id` in two passes:

1. As an `EbayListing.id` (the primary case, covers all items returned from [`/api/v1/vm/buy/init`](/api-reference/purchase/init) and [`/api/v1/inventory/:user_id`](/api-reference/inventory) for ebay-sourced packs).
2. As an on-chain `mint_address` for a CORE-pack NFT (fallback).

If neither resolves, returns `404 { "error": "Card not found" }`.

## Path parameters

<ParamField path="item_id" type="string" required>
  The card's `id` from [`/api/v1/vm/buy/status`](/api-reference/purchase/status) (`nfts[].id`) or [`/api/v1/inventory/:user_id`](/api-reference/inventory) (`items[].id`).
</ParamField>

## Example request

```http theme={"dark"}
GET /api/v1/card/9XnY...mint_address
X-API-Key: <your_api_key>
```

## Response

<ResponseExample>
  ```json 200 theme={"dark"}
  {
    "id": "9XnY...mint_address",
    "name": "Juan Soto RC Auto /25",
    "image": "https://cdn.phygitals.com/cards/soto-rc-auto.png",
    "back_image": "https://cdn.phygitals.com/cards/soto-rc-auto-back.png",
    "fmv": 250.00,
    "metadata": {
      "name": "Juan Soto RC Auto /25",
      "image": "https://cdn.phygitals.com/cards/soto-rc-auto.png",
      "back_image": "https://cdn.phygitals.com/cards/soto-rc-auto-back.png",
      "attributes": [
        { "trait_type": "Year",        "value": "2024" },
        { "trait_type": "Grader",      "value": "PSA" },
        { "trait_type": "Grade",       "value": "PSA 10.0" },
        { "trait_type": "Category",    "value": "Baseball" }
      ]
    }
  }
  ```
</ResponseExample>

<ResponseField name="id" type="string">
  Card identifier. Also the `item_id` for [`/api/v1/vm/buyback`](/api-reference/sellback) and [`/api/v1/ship/quote`](/api-reference/shipping/quote).
</ResponseField>

<ResponseField name="name" type="string">
  Display name of the card.
</ResponseField>

<ResponseField name="image" type="string">
  Primary CDN URL for the card image. Convenience copy of `links.image`.
</ResponseField>

<ResponseField name="back_image" type="string | null">
  CDN URL for the card back image, or `null` when not available.
</ResponseField>

<ResponseField name="fmv" type="number">
  Current fair-market value in USD.

  **Production:** live FMV from the Alt pricing oracle.

  **[Sandbox](/enterprise-api/sandbox):** for `EbayListing` hits, the stored `fmv` is returned. For CORE NFT fallback, FMV is computed as `buyback_price / 0.85` (no Alt oracle call).
</ResponseField>

<ResponseField name="metadata" type="object">
  Full metadata: `name`, `image`, and `attributes[]`.

  For CORE NFT fallback responses, `metadata` is the raw on-chain metadata JSON and may include fields beyond `{ name, image, attributes }` (e.g. `description`, `properties`, `seller_fee_basis_points`). Partners should ignore unknown fields.
</ResponseField>

## Errors

| Status | Body                                          | Cause                         |
| ------ | --------------------------------------------- | ----------------------------- |
| `400`  | `{ "error": "item_id is required" }`          | Missing `:item_id` path param |
| `404`  | `{ "error": "Card not found" }`               | Unknown `item_id`             |
| `500`  | `{ "error": "An unexpected error occurred" }` | Internal server error         |