snapcasterLineLookupLine
Reusable LineLookupLine schema.
Type: object
Fields
| Field | Type | Constraints | Meaning | Example |
|---|---|---|---|---|
sellerIdrequired | integer | None | Echo of the requested cart-line key (with `skuId`). | 0 (generated) |
skuIdrequired | integer | None | Echo of the requested cart-line key (with `sellerId`). | 0 (generated) |
sellerrequired | object or null | None | Null when the Seller is unknown. | {
"name": "string"
} (generated) |
seller.namerequired | string | None | Seller display name; not a handle/slug. | string (generated) |
productrequired | object or null | None | Canonical Catalog display data; null when the sku is unknown. | {
"productId": 0,
"name": "string",
"set": "string",
"image": "string"
} (generated) |
product.productIdrequired | integer | None | Product Id for the surrounding product record. | 0 (generated) |
product.namerequired | string or null | None | The human-readable name of the resource. | string (generated) |
product.setrequired | string or null | None | The card set or expansion. | string (generated) |
product.imagerequired | string or null | None | The product image URL shown to the buyer. | string (generated) |
skurequired | object or null | None | Canonical printing descriptors; null when the sku is unknown. | {
"condition": "string",
"language": "string",
"finish": "string"
} (generated) |
sku.conditionrequired | string or null | None | The normalized condition assigned to the card. | string (generated) |
sku.languagerequired | string or null | None | The language of the card printing. | string (generated) |
sku.finishrequired | string or null | None | The physical finish or foil treatment of the card. | string (generated) |
currentPricerequired | integer or null | None | Live Listing price in integer minor units (cents); null when no live Listing backs the pair. | 0 (generated) |
availablerequired | integer | None | Available stock (on-hand minus committed units); 0 when no live Listing backs the pair. | 0 (generated) |
sellerUnavailable | object | None | Present ONLY when this line’s store fails Checkout readiness; its ABSENCE is the ready signal. The line is never pruned, repriced or reduced because of it - `currentPrice` and `available` stay the Listing’s real live state, and the client decides what the Cart shows. The same store failing across several lines carries the same block on each. | {
"sellerId": 0,
"reason": "SELLER_ON_VACATION"
} (generated) |
sellerUnavailable.sellerIdrequired | integer | None | The store that cannot take the money, echoing the line key. | 0 (generated) |
sellerUnavailable.reasonrequired | string | allowed values: SELLER_ON_VACATION, SELLER_UNAVAILABLE | Buyer-safe category. `SELLER_ON_VACATION` means the store paused itself and is otherwise ready; `SELLER_UNAVAILABLE` is every other cause, deliberately indistinguishable so a store’s private account standing is never published. | SELLER_ON_VACATION (generated) |
policy | object | None | The eligibility and buyer-protection decision for this line. | {
"status": "eligible",
"error": {
"code": "string",
"message": "string",
"action": "string"
}
} (generated) |
policy.statusrequired | string | allowed values: eligible, blocked | The current lifecycle or policy state of the resource. | eligible (generated) |
policy.errorrequired | object or null | None | Structured error information returned when the request cannot be completed. | {
"code": "string",
"message": "string",
"action": "string"
} (generated) |
policy.error.coderequired | string | None | The stable machine-readable code for this result. | string (generated) |
policy.error.messagerequired | string | None | A human-readable explanation of the result. | string (generated) |
policy.error.actionrequired | string | None | The corrective action available for this condition. | string (generated) |
disclosures | 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) |
disclosures.imageSourcerequired | string | allowed values: catalog | Image Source for the surrounding disclosures record. | catalog (generated) |
disclosures.conditionSourcerequired | string | allowed values: seller_declared | Condition Source for the surrounding disclosures record. | seller_declared (generated) |
disclosures.authenticitySourcerequired | string | allowed values: seller_attestation | Authenticity Source for the surrounding disclosures record. | seller_attestation (generated) |
disclosures.snapcasterInspectedrequired | boolean | allowed values: false | Snapcaster Inspected for the surrounding disclosures record. | false (generated) |
disclosures.snapcasterGradedrequired | boolean | allowed values: false | Snapcaster Graded for the surrounding disclosures record. | false (generated) |
disclosures.snapcasterAuthenticatedrequired | boolean | allowed values: false | Snapcaster Authenticated for the surrounding disclosures record. | false (generated) |
disclosures.gradingStandardrequired | string | allowed values: snapcaster-magic-v1, seller-declared-no-specialist-promise | Grading Standard for the surrounding disclosures record. | snapcaster-magic-v1 (generated) |
disclosures.declaredGraderequired | string or null | None | Declared Grade for the surrounding disclosures record. | string (generated) |
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) |
fulfillmentObligation | object or null | None | Fulfillment Obligation supplied to or returned by this operation. | {
"sku": "exact",
"printing": "exact",
"language": "exact",
"finish": "exact",
"condition": "declared-or-better"
} (generated) |
fulfillmentObligation.skurequired | string | allowed values: exact | The stock-keeping identity for the exact card offering. | exact (generated) |
fulfillmentObligation.printingrequired | string | allowed values: exact | The exact card printing the Seller is obligated to supply. | exact (generated) |
fulfillmentObligation.languagerequired | string | allowed values: exact | The language of the card printing. | exact (generated) |
fulfillmentObligation.finishrequired | string | allowed values: exact | The physical finish or foil treatment of the card. | exact (generated) |
fulfillmentObligation.conditionrequired | string | allowed values: declared-or-better | The normalized condition assigned to the card. | declared-or-better (generated) |
Examples
{ "sellerId": 0, "skuId": 0, "seller": { "name": "string" }, "product": { "productId": 0, "name": "string", "set": "string", "image": "string" }, "sku": { "condition": "string", "language": "string", "finish": "string" }, "currentPrice": 0, "available": 0}