Skip to main content
GET
/
api
/
v1
/
card
/
:item_id
Get card details
curl --request GET \
  --url https://api.example.com/api/v1/card/:item_id
{
  "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" }
    ]
  }
}
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 and /api/v1/inventory/:user_id 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

​
item_id
string
required
The card’s id from /api/v1/vm/buy/status (nfts[].id) or /api/v1/inventory/:user_id (items[].id).

​
Example request

GET /api/v1/card/9XnY...mint_address
X-API-Key: <your_api_key>

​
Response

{
  "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" }
    ]
  }
}
​
id
string
Card identifier. Also the item_id for /api/v1/vm/buyback and /api/v1/ship/quote.
​
name
string
Display name of the card.
​
image
string
Primary CDN URL for the card image. Convenience copy of links.image.
​
back_image
string | null
CDN URL for the card back image, or null when not available.
​
fmv
number
Current fair-market value in USD.Production: live FMV from the Alt pricing oracle.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).
​
metadata
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.

​
Errors

StatusBodyCause
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