Skip to documentation
Developers
DOCUMENTATIONAPI referenceProductsGet product details
PRODUCTS / V1

Get product details

Read the exact product identity, set, card attributes, SKU variants, and verified card image URL.

GET/v1/products/{productId}/details
Bearer key requiredJSON response
Example requestv1
curl --request GET \  --url 'https://pokepos-market-api.vercel.app/v1/products/704860/details' \  --header 'Authorization: Bearer YOUR_API_KEY'
Response illustrative JSON
{  "source": "tcgplayer-public-site",  "productId": 704860,  "fetchedAt": "2026-09-29T12:30:00.000Z",  "cacheHit": true,  "product": {    "productId": 704860,    "name": "Mega Excadrill ex",    "cardNumber": "103/084",    "rarity": "Ultra Rare",    "imageUrl": "https://tcgplayer-cdn.tcgplayer.com/..."  }}
Example values can change with the source.
REQUEST

Parameters

Pass path parameters in the URL and query parameters after ?.

productIdintegerrequiredpath

Numeric TCGplayer product ID. Range: 1–any. Example: 716465.

RESPONSE

Response object

Product details and SKU identities. The root schema is DetailsResult.

sourcestring

Name of the market data source.

productIdinteger

Numeric ID for the exact catalog product.

fetchedAtstring

Time this section was fetched, in ISO 8601 format.

cacheHitboolean

Whether the response used a cached observation.

productProduct

Identity and attributes of the selected product.

SCHEMAS

Related objects

Expand a type to inspect its fields.

Product18 fields
productIdinteger

Numeric ID for the exact catalog product.

sourceUrlstring

Source product page URL.

namestring

Display name from the source catalog.

categoryobject

Product line or category for this result.

groupobject

Set or group metadata from the source catalog.

productTypestring | null

Product type reported by the catalog.

sealedboolean

Whether the product is sealed rather than a single card.

cardNumberstring | null

Collector number printed on the card.

raritystring | null

Rarity label reported by the catalog.

attributesobject

Structured product attributes.

formattedAttributesobject

Source-formatted product attributes.

skusSku[]

Conditions, finishes, and languages offered for this product.

marketPricenumber | null

US dollars. Null means no observation is available.

lowestPricenumber | null

US dollars. Null means no observation is available.

lowestPriceWithShippingnumber | null

US dollars. Null means no observation is available.

listingCountinteger | null

Number of current listings, when reported.

sellerCountinteger | null

Number of current sellers, when reported.

imageUrlstring | null

Verified source URL for the product image.

Sku4 fields
skuIdinteger

Numeric ID of one condition and variant combination.

conditionstring | null

Card condition associated with this SKU or offer.

variantstring | null

Printing finish or variant associated with this SKU or offer.

languagestring | null

Language associated with this SKU or offer.

HTTP

Status codes

200

Product details and SKU identities.

400

Invalid parameter or request body.

404

Product, route, or image not found.

502

An upstream market source is unavailable.

Errors use the error.code and error.message shape. Keep the x-request-id response header for support and tracing.

PREVIOUSGet a product snapshotNEXTGet market prices