Search products

GET/search

Informational read showing how Listings surface to Buyers; a Platform does not implement this operation. Public buyer-facing Product search over the Canadian marketplace. No keyword returns the full landing grid; a `keyword` filters by analyzed name. Each result is one Product carrying a "from $X" minimum price and an "N sellers" distinct-seller count, plus category/set/rarity/store facets. `sellerCode` scopes the grid to a single store (an unknown or non-browsable handle yields an empty result set, never an error) and composes with every other filter. Keyset-paginated: follow `nextCursor` until it is null.

When to use

Use this operation to search products.

Informational: a Platform does not implement this buyer-facing operation.

Endpoint

GET /search

Environment	Base URL
Sandbox	https://api-sandbox.snapcaster.ca/api/v1/marketplace
Production	https://api.snapcaster.ca/api/v1/marketplace

Authentication

None.

Request

Field	In	Type	Constraints	Meaning	Example
keyword	query	string	maximum length: 255	Free-text terms used to search the catalog.	string (generated)
category	query	string	minimum length: 1; maximum length: 255	The trading-card game category.	string (generated)
set	query	string	minimum length: 1; maximum length: 255	The card set or expansion.	string (generated)
rarity	query	string	minimum length: 1; maximum length: 255	The rarity assigned to the card printing.	string (generated)
sellerCode	query	string	minimum length: 1; maximum length: 64	Seller Code supplied to or returned by this operation.	string (generated)
condition	query	array of string or string	string: minimum length: 1; string: maximum length: 255; array of string: minimum items: 1	The normalized condition assigned to the card.	string (generated)
language	query	array of string or string	string: minimum length: 1; string: maximum length: 255; array of string: minimum items: 1	The language of the card printing.	string (generated)
finish	query	array of string or string	string: minimum length: 1; string: maximum length: 255; array of string: minimum items: 1	The physical finish or foil treatment of the card.	string (generated)
collectorNumber	query	array of string or string	string: minimum length: 1; string: maximum length: 255; array of string: minimum items: 1	Collector Number supplied to or returned by this operation.	string (generated)
checkoutMode	query	string	allowed values: express, manual, any	Checkout Mode supplied to or returned by this operation.	express (generated)
sort	query	string	allowed values: name, name_desc	The ordering applied to the returned records.	name (generated)
limit	query	integer	exclusive minimum: 0; maximum: 100	The maximum number of records requested for this page.	1 (generated)
cursor	query	string	minimum length: 1	The opaque continuation token for the next page.	string (generated)

No request body.

Example

Sandbox is the default. These requests use the contract's canonical field examples.

Generated cURL request - Sandbox

curl --request GET \
  --url 'https://api-sandbox.snapcaster.ca/api/v1/marketplace/search'

Response

200

A page of the Product grid.

Generated Response 200: Generated response 200

{
  "success": true,
  "data": {
    "items": [
      {
        "productId": 0,
        "name": "string",
        "set": "string",
        "category": "string",
        "rarity": "string",
        "collectorNumber": "string",
        "imageUrl": "string",
        "isSealed": true,
        "fromPrice": 0,
        "sellerCount": 0,
        "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"
        }
      }
    ],
    "facets": {
      "category": [
        {
          "value": "string",
          "count": 0
        }
      ],
      "set": [
        {
          "value": "string",
          "count": 0
        }
      ],
      "rarity": [
        {
          "value": "string",
          "count": 0
        }
      ],
      "seller": [
        {
          "sellerCode": "string",
          "storeName": "string",
          "count": 0
        }
      ],
      "condition": [
        {
          "value": "string",
          "count": 0
        }
      ],
      "language": [
        {
          "value": "string",
          "count": 0
        }
      ],
      "finish": [
        {
          "value": "string",
          "count": 0
        }
      ],
      "collectorNumber": [
        {
          "value": "string",
          "count": 0
        }
      ]
    },
    "nextCursor": "string"
  }
}

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.	{ "items": [ { "productId": 0, "name": "string", "set": "string", "category": "string", "rarity": "string", "collectorNumber": "string", "imageUrl": "string", "isSealed": true, "fromPrice": 0, "sellerCount": 0, "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" } } ], "facets": { "category": [ { "value": "string", "count": 0 } ], "set": [ { "value": "string", "count": 0 } ], "rarity": [ { "value": "string", "count": 0 } ], "seller": [ { "sellerCode": "string", "storeName": "string", "count": 0 } ], "condition": [ { "value": "string", "count": 0 } ], "language": [ { "value": "string", "count": 0 } ], "finish": [ { "value": "string", "count": 0 } ], "collectorNumber": [ { "value": "string", "count": 0 } ] }, "nextCursor": "string" } (generated)
data.itemsrequired	array of object	None	The records included in this page or batch.	[ { "productId": 0, "name": "string", "set": "string", "category": "string", "rarity": "string", "collectorNumber": "string", "imageUrl": "string", "isSealed": true, "fromPrice": 0, "sellerCount": 0, "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.items[].productIdrequired	integer	None	Product Id for the surrounding items item record.	0 (generated)
data.items[].namerequired	string or null	None	The human-readable name of the resource.	string (generated)
data.items[].setrequired	string or null	None	The card set or expansion.	string (generated)
data.items[].categoryrequired	string or null	None	The trading-card game category.	string (generated)
data.items[].rarityrequired	string or null	None	The rarity assigned to the card printing.	string (generated)
data.items[].collectorNumberrequired	string or null	None	Collector Number for the surrounding items item record.	string (generated)
data.items[].imageUrlrequired	string or null	None	Image Url for the surrounding items item record.	string (generated)
data.items[].isSealedrequired	boolean	None	Is Sealed for the surrounding items item record.	true (generated)
data.items[].fromPricerequired	integer	None	Minimum offer price across sellers, in integer minor units (cents).	0 (generated)
data.items[].sellerCountrequired	integer	None	Count of distinct Sellers offering this Product.	0 (generated)
data.items[].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.items[].disclosures.imageSourcerequired	string	allowed values: catalog	Image Source for the surrounding disclosures record.	catalog (generated)
data.items[].disclosures.conditionSourcerequired	string	allowed values: seller_declared	Condition Source for the surrounding disclosures record.	seller_declared (generated)
data.items[].disclosures.authenticitySourcerequired	string	allowed values: seller_attestation	Authenticity Source for the surrounding disclosures record.	seller_attestation (generated)
data.items[].disclosures.snapcasterInspectedrequired	boolean	allowed values: false	Snapcaster Inspected for the surrounding disclosures record.	false (generated)
data.items[].disclosures.snapcasterGradedrequired	boolean	allowed values: false	Snapcaster Graded for the surrounding disclosures record.	false (generated)
data.items[].disclosures.snapcasterAuthenticatedrequired	boolean	allowed values: false	Snapcaster Authenticated for the surrounding disclosures record.	false (generated)
data.items[].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.items[].disclosures.declaredGraderequired	string or null	None	Declared Grade for the surrounding disclosures record.	string (generated)
data.items[].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.items[].fulfillmentObligationrequired	object or null	None	Fulfillment Obligation for the surrounding items item record.	{ "sku": "exact", "printing": "exact", "language": "exact", "finish": "exact", "condition": "declared-or-better" } (generated)
data.items[].fulfillmentObligation.skurequired	string	allowed values: exact	The stock-keeping identity for the exact card offering.	exact (generated)
data.items[].fulfillmentObligation.printingrequired	string	allowed values: exact	The exact card printing the Seller is obligated to supply.	exact (generated)
data.items[].fulfillmentObligation.languagerequired	string	allowed values: exact	The language of the card printing.	exact (generated)
data.items[].fulfillmentObligation.finishrequired	string	allowed values: exact	The physical finish or foil treatment of the card.	exact (generated)
data.items[].fulfillmentObligation.conditionrequired	string	allowed values: declared-or-better	The normalized condition assigned to the card.	declared-or-better (generated)
data.facetsrequired	object	None	Available filter values and their result counts.	{ "category": [ { "value": "string", "count": 0 } ], "set": [ { "value": "string", "count": 0 } ], "rarity": [ { "value": "string", "count": 0 } ], "seller": [ { "sellerCode": "string", "storeName": "string", "count": 0 } ], "condition": [ { "value": "string", "count": 0 } ], "language": [ { "value": "string", "count": 0 } ], "finish": [ { "value": "string", "count": 0 } ], "collectorNumber": [ { "value": "string", "count": 0 } ] } (generated)
data.facets.categoryrequired	array of object	None	The trading-card game category.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.category[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.category[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.facets.setrequired	array of object	None	The card set or expansion.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.set[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.set[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.facets.rarityrequired	array of object	None	The rarity assigned to the card printing.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.rarity[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.rarity[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.facets.sellerrequired	array of object	None	Store facet: one entry per Seller with browsable Listings under the current query, carrying the public `sellerCode` to scope by and the store name to render. Both express (native) and manual (handoff) stores appear. Unlike the other facets a value needs two fields, so this one is not a plain { value, count }.	[ { "sellerCode": "string", "storeName": "string", "count": 0 } ] (generated)
data.facets.seller[].sellerCoderequired	string	None	The store’s public handle — feed it back as the `sellerCode` query param to scope.	string (generated)
data.facets.seller[].storeNamerequired	string	None	The store display name to render; not a handle/slug.	string (generated)
data.facets.seller[].countrequired	integer	None	Number of the store’s Listings under the current query.	0 (generated)
data.facets.conditionrequired	array of object	None	The normalized condition assigned to the card.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.condition[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.condition[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.facets.languagerequired	array of object	None	The language of the card printing.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.language[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.language[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.facets.finishrequired	array of object	None	The physical finish or foil treatment of the card.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.finish[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.finish[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.facets.collectorNumberrequired	array of object	None	Collector Number for the surrounding facets record.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.collectorNumber[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.collectorNumber[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.nextCursorrequired	string or null	None	Opaque keyset cursor for the next page; null on the last page.	string (generated)

Errors

Status	Code	Meaning	Do this
400	INVALID_REQUEST	The request failed validation (`INVALID_REQUEST`).	Correct the fields named in the error details, then retry the request.

Related

Operations

• Get product offers
• Look up cart lines

Concepts

• Core concepts

Changelog

None.

Schema

Full schema details (75 fields)

Parameters

Field	In	Type	Constraints	Meaning	Example
keyword	query	string	maximum length: 255	Free-text terms used to search the catalog.	string (generated)
category	query	string	minimum length: 1; maximum length: 255	The trading-card game category.	string (generated)
set	query	string	minimum length: 1; maximum length: 255	The card set or expansion.	string (generated)
rarity	query	string	minimum length: 1; maximum length: 255	The rarity assigned to the card printing.	string (generated)
sellerCode	query	string	minimum length: 1; maximum length: 64	Seller Code supplied to or returned by this operation.	string (generated)
condition	query	array of string or string	string: minimum length: 1; string: maximum length: 255; array of string: minimum items: 1	The normalized condition assigned to the card.	string (generated)
language	query	array of string or string	string: minimum length: 1; string: maximum length: 255; array of string: minimum items: 1	The language of the card printing.	string (generated)
finish	query	array of string or string	string: minimum length: 1; string: maximum length: 255; array of string: minimum items: 1	The physical finish or foil treatment of the card.	string (generated)
collectorNumber	query	array of string or string	string: minimum length: 1; string: maximum length: 255; array of string: minimum items: 1	Collector Number supplied to or returned by this operation.	string (generated)
checkoutMode	query	string	allowed values: express, manual, any	Checkout Mode supplied to or returned by this operation.	express (generated)
sort	query	string	allowed values: name, name_desc	The ordering applied to the returned records.	name (generated)
limit	query	integer	exclusive minimum: 0; maximum: 100	The maximum number of records requested for this page.	1 (generated)
cursor	query	string	minimum length: 1	The opaque continuation token for the next page.	string (generated)

Request

None.

Response 200 (application/json)

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.	{ "items": [ { "productId": 0, "name": "string", "set": "string", "category": "string", "rarity": "string", "collectorNumber": "string", "imageUrl": "string", "isSealed": true, "fromPrice": 0, "sellerCount": 0, "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" } } ], "facets": { "category": [ { "value": "string", "count": 0 } ], "set": [ { "value": "string", "count": 0 } ], "rarity": [ { "value": "string", "count": 0 } ], "seller": [ { "sellerCode": "string", "storeName": "string", "count": 0 } ], "condition": [ { "value": "string", "count": 0 } ], "language": [ { "value": "string", "count": 0 } ], "finish": [ { "value": "string", "count": 0 } ], "collectorNumber": [ { "value": "string", "count": 0 } ] }, "nextCursor": "string" } (generated)
data.itemsrequired	array of object	None	The records included in this page or batch.	[ { "productId": 0, "name": "string", "set": "string", "category": "string", "rarity": "string", "collectorNumber": "string", "imageUrl": "string", "isSealed": true, "fromPrice": 0, "sellerCount": 0, "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.items[].productIdrequired	integer	None	Product Id for the surrounding items item record.	0 (generated)
data.items[].namerequired	string or null	None	The human-readable name of the resource.	string (generated)
data.items[].setrequired	string or null	None	The card set or expansion.	string (generated)
data.items[].categoryrequired	string or null	None	The trading-card game category.	string (generated)
data.items[].rarityrequired	string or null	None	The rarity assigned to the card printing.	string (generated)
data.items[].collectorNumberrequired	string or null	None	Collector Number for the surrounding items item record.	string (generated)
data.items[].imageUrlrequired	string or null	None	Image Url for the surrounding items item record.	string (generated)
data.items[].isSealedrequired	boolean	None	Is Sealed for the surrounding items item record.	true (generated)
data.items[].fromPricerequired	integer	None	Minimum offer price across sellers, in integer minor units (cents).	0 (generated)
data.items[].sellerCountrequired	integer	None	Count of distinct Sellers offering this Product.	0 (generated)
data.items[].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.items[].disclosures.imageSourcerequired	string	allowed values: catalog	Image Source for the surrounding disclosures record.	catalog (generated)
data.items[].disclosures.conditionSourcerequired	string	allowed values: seller_declared	Condition Source for the surrounding disclosures record.	seller_declared (generated)
data.items[].disclosures.authenticitySourcerequired	string	allowed values: seller_attestation	Authenticity Source for the surrounding disclosures record.	seller_attestation (generated)
data.items[].disclosures.snapcasterInspectedrequired	boolean	allowed values: false	Snapcaster Inspected for the surrounding disclosures record.	false (generated)
data.items[].disclosures.snapcasterGradedrequired	boolean	allowed values: false	Snapcaster Graded for the surrounding disclosures record.	false (generated)
data.items[].disclosures.snapcasterAuthenticatedrequired	boolean	allowed values: false	Snapcaster Authenticated for the surrounding disclosures record.	false (generated)
data.items[].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.items[].disclosures.declaredGraderequired	string or null	None	Declared Grade for the surrounding disclosures record.	string (generated)
data.items[].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.items[].fulfillmentObligationrequired	object or null	None	Fulfillment Obligation for the surrounding items item record.	{ "sku": "exact", "printing": "exact", "language": "exact", "finish": "exact", "condition": "declared-or-better" } (generated)
data.items[].fulfillmentObligation.skurequired	string	allowed values: exact	The stock-keeping identity for the exact card offering.	exact (generated)
data.items[].fulfillmentObligation.printingrequired	string	allowed values: exact	The exact card printing the Seller is obligated to supply.	exact (generated)
data.items[].fulfillmentObligation.languagerequired	string	allowed values: exact	The language of the card printing.	exact (generated)
data.items[].fulfillmentObligation.finishrequired	string	allowed values: exact	The physical finish or foil treatment of the card.	exact (generated)
data.items[].fulfillmentObligation.conditionrequired	string	allowed values: declared-or-better	The normalized condition assigned to the card.	declared-or-better (generated)
data.facetsrequired	object	None	Available filter values and their result counts.	{ "category": [ { "value": "string", "count": 0 } ], "set": [ { "value": "string", "count": 0 } ], "rarity": [ { "value": "string", "count": 0 } ], "seller": [ { "sellerCode": "string", "storeName": "string", "count": 0 } ], "condition": [ { "value": "string", "count": 0 } ], "language": [ { "value": "string", "count": 0 } ], "finish": [ { "value": "string", "count": 0 } ], "collectorNumber": [ { "value": "string", "count": 0 } ] } (generated)
data.facets.categoryrequired	array of object	None	The trading-card game category.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.category[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.category[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.facets.setrequired	array of object	None	The card set or expansion.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.set[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.set[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.facets.rarityrequired	array of object	None	The rarity assigned to the card printing.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.rarity[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.rarity[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.facets.sellerrequired	array of object	None	Store facet: one entry per Seller with browsable Listings under the current query, carrying the public `sellerCode` to scope by and the store name to render. Both express (native) and manual (handoff) stores appear. Unlike the other facets a value needs two fields, so this one is not a plain { value, count }.	[ { "sellerCode": "string", "storeName": "string", "count": 0 } ] (generated)
data.facets.seller[].sellerCoderequired	string	None	The store’s public handle — feed it back as the `sellerCode` query param to scope.	string (generated)
data.facets.seller[].storeNamerequired	string	None	The store display name to render; not a handle/slug.	string (generated)
data.facets.seller[].countrequired	integer	None	Number of the store’s Listings under the current query.	0 (generated)
data.facets.conditionrequired	array of object	None	The normalized condition assigned to the card.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.condition[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.condition[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.facets.languagerequired	array of object	None	The language of the card printing.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.language[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.language[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.facets.finishrequired	array of object	None	The physical finish or foil treatment of the card.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.finish[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.finish[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.facets.collectorNumberrequired	array of object	None	Collector Number for the surrounding facets record.	[ { "value": "string", "count": 0 } ] (generated)
data.facets.collectorNumber[].valuerequired	string	None	The value represented by this entry.	string (generated)
data.facets.collectorNumber[].countrequired	integer	None	Number of Products carrying this value under the current query.	0 (generated)
data.nextCursorrequired	string or null	None	Opaque keyset cursor for the next page; null on the last page.	string (generated)

Error 400 (application/json)

Field	Type	Constraints	Meaning	Example
successrequired	boolean	allowed values: false	Whether the operation completed as requested.	false (generated)
errorrequired	object	None	Structured error information returned when the request cannot be completed.	{ "code": "UNAUTHORIZED", "message": "string" } (generated)
error.coderequired	string	allowed values: UNAUTHORIZED, INVALID_REQUEST, UNSUPPORTED_API_VERSION, SELLER_SOURCE_EXCLUSIVE, BATCH_TOO_LARGE, RATE_LIMITED, ORDER_NOT_FOUND, SELLER_NOT_FOUND, INVALID_TRANSITION, CHECKOUT_IDEMPOTENCY_KEY_REUSED, CHECKOUT_MANUAL_SELLER_UNSUPPORTED, CHECKOUT_SELF_PURCHASE_NOT_ALLOWED, CHECKOUT_SELLER_UNAVAILABLE, CHECKOUT_NOT_FOUND, FEATURE_DISABLED	Stable public error code the Platform can branch on.	UNAUTHORIZED (generated)
error.messagerequired	string	None	A human-readable explanation of the result.	string (generated)
error.details	unknown	None	Additional structured context for diagnosing the result.	{} (generated)