snapcasterBrowseProductOffersResponse
Reusable BrowseProductOffersResponse schema.
Type: object
Fields
| Field | Type | Constraints | Meaning | Example |
|---|---|---|---|---|
successrequired | boolean | allowed values: true | Whether the operation completed as requested. | true (generated) |
degraded | boolean | allowed values: true | Present and true while the marketplace is in Degraded Mode: prices and availability on browse surfaces may be briefly out of date, and are confirmed before purchase. Absent when the platform is healthy. | true (generated) |
datarequired | object | None | The operation or event payload. | {
"offers": [
{
"lane": "native",
"productId": 0,
"sellerId": 0,
"storeSlug": "string",
"variantId": 0,
"skuId": 0,
"sellerName": "string",
"condition": "string",
"language": "string",
"finish": "string",
"isSealed": true,
"price": 0,
"available": 0,
"checkoutMode": "express",
"salesCount": 0,
"sellerCode": "string",
"reviewScore": {
"score": 0,
"count": 0
},
"poBoxDelivery": {
"status": "available"
},
"disclosures": {
"imageSource": "catalog",
"conditionSource": "seller_declared",
"authenticitySource": "seller_attestation",
"snapcasterInspected": false,
"snapcasterGraded": false,
"snapcasterAuthenticated": false,
"gradingStandard": "snapcaster-magic-v1",
"declaredGrade": "string",
"buyerProtection": "magic-grade-and-authenticity"
},
"fulfillmentObligation": {
"sku": "exact",
"printing": "exact",
"language": "exact",
"finish": "exact",
"condition": "declared-or-better"
}
}
],
"product": {
"productId": 0,
"name": "string",
"set": "string",
"rarity": "string",
"collectorNumber": "string",
"imageUrl": "string",
"details": [
{
"label": "string",
"value": "string"
}
]
}
} (generated) |
data.offersrequired | array of object | None | The Product’s offers, cheapest first. | [
{
"lane": "native",
"productId": 0,
"sellerId": 0,
"storeSlug": "string",
"variantId": 0,
"skuId": 0,
"sellerName": "string",
"condition": "string",
"language": "string",
"finish": "string",
"isSealed": true,
"price": 0,
"available": 0,
"checkoutMode": "express",
"salesCount": 0,
"sellerCode": "string",
"reviewScore": {
"score": 0,
"count": 0
},
"poBoxDelivery": {
"status": "available"
},
"disclosures": {
"imageSource": "catalog",
"conditionSource": "seller_declared",
"authenticitySource": "seller_attestation",
"snapcasterInspected": false,
"snapcasterGraded": false,
"snapcasterAuthenticated": false,
"gradingStandard": "snapcaster-magic-v1",
"declaredGrade": "string",
"buyerProtection": "magic-grade-and-authenticity"
},
"fulfillmentObligation": {
"sku": "exact",
"printing": "exact",
"language": "exact",
"finish": "exact",
"condition": "declared-or-better"
}
}
] (generated) |
data.offers[].lanerequired | string | allowed values: native, handoff | Which lane this offer comes from (#1634, ADR-0068): `native` is a marketplace Seller’s Listing, `handoff` is a Handoff Store’s synced single. Read this first - it says which identity fields carry a value and whether Snapcaster stands behind the sale at all. | native (generated) |
data.offers[].productIdrequired | integer | None | Product Id for the surrounding offers item record. | 0 (generated) |
data.offers[].sellerIdrequired | integer or null | None | Cart-line key (with `skuId`); identifies the offering Seller. `null` on a `handoff` offer: a Handoff Store has no seller record and never gets a synthetic one. | 0 (generated) |
data.offers[].storeSlugrequired | string or null | None | The Handoff Store’s slug - its stable identity across the cart, the quote and the permalink. `null` on a `native` offer. | string (generated) |
data.offers[].variantIdrequired | integer or null | None | The Shopify variant this handoff offer is for; with `storeSlug` it is the handoff cart-line key. `null` on a `native` offer. | 0 (generated) |
data.offers[].skuIdrequired | integer | None | The canonical TCGplayer sku id. With `sellerId` it is the NATIVE cart-line key; a `handoff` offer has no `sellerId` and is carted by `storeSlug` + `variantId` instead. | 0 (generated) |
data.offers[].sellerNamerequired | string or null | None | Display name of whoever is offering the card - the Seller’s store name, or the Handoff Store’s name. Not a handle/slug/seller_code. | string (generated) |
data.offers[].conditionrequired | string or null | None | The normalized condition assigned to the card. | string (generated) |
data.offers[].languagerequired | string or null | None | The language of the card printing. | string (generated) |
data.offers[].finishrequired | string or null | None | The physical finish or foil treatment of the card. | string (generated) |
data.offers[].isSealedrequired | boolean | None | True when the canonical SKU condition is `Unopened`; matches the Product grid classification. | true (generated) |
data.offers[].pricerequired | integer | None | Offer price in integer minor units (cents). | 0 (generated) |
data.offers[].availablerequired | integer | None | Available stock: on-hand minus committed units. | 0 (generated) |
data.offers[].checkoutModerequired | string or null | allowed values: express, manual, null | The store's buyer-facing checkout mode (ADR-0025): `express` (native — transacts on Snapcaster) or `manual` (handoff — the Buyer finishes on the Seller's own checkout). `null` only for a legacy doc indexed before the field existed. | express (generated) |
data.offers[].salesCountrequired | integer or null | None | The store's live number of sales (paid-order count), computed live per request — not indexed. A number for an `express` (native) store (`0` for a genuinely-new one); `null` for a `manual` (handoff) store, which mints no orders, so the client renders nothing. | 0 (generated) |
data.offers[].sellerCoderequired | string or null | None | The store’s PUBLIC handle — the Seller-page identity to link this offer to (`/marketplace/sellers/{sellerCode}`). Resolved live from the database, not the search projection; `null` when the store has no directory row (the offer is still served). | string (generated) |
data.offers[].reviewScorerequired | object | None | A store’s live Review score and the count it is drawn from, always together so a low-sample score reads as low-sample. Computed per request and never indexed. A store with no reviews carries `{ score: null, count: 0 }` — never a 0.0 — and a `manual` (handoff) store, unreviewable in v1, reads the same way. Shared by the Seller page and the Product-page offers. | {
"score": 0,
"count": 0
} (generated) |
data.offers[].reviewScore.scorerequired | number or null | None | Mean of current non-hidden ratings, rounded to 2 decimals. `null` — NOT 0 — when the store has no reviews yet, so a new store is never shown as a 0.0-rated one. | 0 (generated) |
data.offers[].reviewScore.countrequired | integer | None | How many current non-hidden Reviews the mean is drawn from. | 0 (generated) |
data.offers[].poBoxDeliveryrequired | object or null | None | The store’s effective PO Box delivery value. `null` on a `handoff` offer: Snapcaster arranges no shipment on that lane, so it makes no claim either way. | {
"status": "available"
} (generated) |
data.offers[].poBoxDelivery.statusrequired | string | allowed values: available, seller_declines, platform_suspended | `available`: the store delivers to PO Boxes. `seller_declines`: the store does not. `platform_suspended`: PO Box delivery is suspended platform-wide (e.g. a Canada Post strike) and outranks the store’s own setting. | available (generated) |
data.offers[].disclosuresrequired | object or null | None | Provenance, grading, and authenticity statements shown to the buyer. | {
"imageSource": "catalog",
"conditionSource": "seller_declared",
"authenticitySource": "seller_attestation",
"snapcasterInspected": false,
"snapcasterGraded": false,
"snapcasterAuthenticated": false,
"gradingStandard": "snapcaster-magic-v1",
"declaredGrade": "string",
"buyerProtection": "magic-grade-and-authenticity"
} (generated) |
data.offers[].disclosures.imageSourcerequired | string | allowed values: catalog | Image Source for the surrounding disclosures record. | catalog (generated) |
data.offers[].disclosures.conditionSourcerequired | string | allowed values: seller_declared | Condition Source for the surrounding disclosures record. | seller_declared (generated) |
data.offers[].disclosures.authenticitySourcerequired | string | allowed values: seller_attestation | Authenticity Source for the surrounding disclosures record. | seller_attestation (generated) |
data.offers[].disclosures.snapcasterInspectedrequired | boolean | allowed values: false | Snapcaster Inspected for the surrounding disclosures record. | false (generated) |
data.offers[].disclosures.snapcasterGradedrequired | boolean | allowed values: false | Snapcaster Graded for the surrounding disclosures record. | false (generated) |
data.offers[].disclosures.snapcasterAuthenticatedrequired | boolean | allowed values: false | Snapcaster Authenticated for the surrounding disclosures record. | false (generated) |
data.offers[].disclosures.gradingStandardrequired | string | allowed values: snapcaster-magic-v1, seller-declared-no-specialist-promise | Grading Standard for the surrounding disclosures record. | snapcaster-magic-v1 (generated) |
data.offers[].disclosures.declaredGraderequired | string or null | None | Declared Grade for the surrounding disclosures record. | string (generated) |
data.offers[].disclosures.buyerProtectionrequired | string | allowed values: magic-grade-and-authenticity, genuine-and-as-described | Buyer Protection for the surrounding disclosures record. | magic-grade-and-authenticity (generated) |
data.offers[].fulfillmentObligationrequired | object or null | None | Fulfillment Obligation for the surrounding offers item record. | {
"sku": "exact",
"printing": "exact",
"language": "exact",
"finish": "exact",
"condition": "declared-or-better"
} (generated) |
data.offers[].fulfillmentObligation.skurequired | string | allowed values: exact | The stock-keeping identity for the exact card offering. | exact (generated) |
data.offers[].fulfillmentObligation.printingrequired | string | allowed values: exact | The exact card printing the Seller is obligated to supply. | exact (generated) |
data.offers[].fulfillmentObligation.languagerequired | string | allowed values: exact | The language of the card printing. | exact (generated) |
data.offers[].fulfillmentObligation.finishrequired | string | allowed values: exact | The physical finish or foil treatment of the card. | exact (generated) |
data.offers[].fulfillmentObligation.conditionrequired | string | allowed values: declared-or-better | The normalized condition assigned to the card. | declared-or-better (generated) |
data.productrequired | object or null | None | Card metadata; null when no catalog row exists. | {
"productId": 0,
"name": "string",
"set": "string",
"rarity": "string",
"collectorNumber": "string",
"imageUrl": "string",
"details": [
{
"label": "string",
"value": "string"
}
]
} (generated) |
data.product.productIdrequired | integer | None | Product Id for the surrounding product record. | 0 (generated) |
data.product.namerequired | string or null | None | The human-readable name of the resource. | string (generated) |
data.product.setrequired | string or null | None | The joined group / set name. | string (generated) |
data.product.rarityrequired | string or null | None | Derived from the extended_data `Rarity` entry. | string (generated) |
data.product.collectorNumberrequired | string or null | None | Derived from the extended_data `Number` entry. | string (generated) |
data.product.imageUrlrequired | string or null | None | Real card art from the catalog product. | string (generated) |
data.product.detailsrequired | array of object | None | Generic surfacing of every extended_data entry as { label, value }. | [
{
"label": "string",
"value": "string"
}
] (generated) |
data.product.details[].labelrequired | string | None | The entry’s displayName, falling back to its machine name. | string (generated) |
data.product.details[].valuerequired | string | None | The value represented by this entry. | string (generated) |
Examples
{ "success": true, "data": { "offers": [ { "lane": "native", "productId": 0, "sellerId": 0, "storeSlug": "string", "variantId": 0, "skuId": 0, "sellerName": "string", "condition": "string", "language": "string", "finish": "string", "isSealed": true, "price": 0, "available": 0, "checkoutMode": "express", "salesCount": 0, "sellerCode": "string", "reviewScore": { "score": 0, "count": 0 }, "poBoxDelivery": { "status": "available" }, "disclosures": { "imageSource": "catalog", "conditionSource": "seller_declared", "authenticitySource": "seller_attestation", "snapcasterInspected": false, "snapcasterGraded": false, "snapcasterAuthenticated": false, "gradingStandard": "snapcaster-magic-v1", "declaredGrade": "string", "buyerProtection": "magic-grade-and-authenticity" }, "fulfillmentObligation": { "sku": "exact", "printing": "exact", "language": "exact", "finish": "exact", "condition": "declared-or-better" } } ], "product": { "productId": 0, "name": "string", "set": "string", "rarity": "string", "collectorNumber": "string", "imageUrl": "string", "details": [ { "label": "string", "value": "string" } ] } }}