LineLookupLine

Part of the response of POST /lines/lookup.

Type: object

Fields

sellerId integer required

The requested seller id. Together with skuId, identifies the cart line.

skuId integer required

The requested SKU id. Together with sellerId, identifies the cart line.

seller object or null required

Null when the seller is unknown.

Show child fieldsHide child fields

seller.name string required

Seller display name; not a handle/slug.

product object or null required

Canonical catalog display data; null when the SKU is unknown.

Show child fieldsHide child fields

product.productId integer required

See Canonical catalog in Core concepts.

product.name string or null required

product.set string or null required

The card set or expansion.

product.image string or null required

The product image URL shown to the buyer.

sku object or null required

The catalog condition, language, and finish. Null when the SKU is unknown.

Show child fieldsHide child fields

sku.condition string or null required

The normalized condition assigned to the card.

sku.language string or null required

The language of the card printing.

sku.finish string or null required

The physical finish or foil treatment of the card.

currentPrice integer or null required

The current listing price in integer cents. Null when there is no live listing for this pair.

available integer required

On-hand minus committed units. Zero when there is no live listing for this pair.

sellerUnavailable object

Present when the store cannot accept checkout; absent when it is ready. The response keeps the line and its current currentPrice and available values. Use this field to decide how to display the line in the cart. If several lines belong to the same unavailable store, each includes the same block.

Show child fieldsHide child fields

sellerUnavailable.sellerId integer required

The unavailable store id, matching the cart line.

sellerUnavailable.reason string required

SELLER_ON_VACATION means the store has enabled vacation mode and is otherwise ready. SELLER_UNAVAILABLE covers all other causes without exposing the store's private account status.

Constraints: allowed values: SELLER_ON_VACATION, SELLER_UNAVAILABLE

policy object

The eligibility and buyer-protection decision for this line.

Show child fieldsHide child fields

policy.status string required

Constraints: allowed values: eligible, blocked

policy.error object or null required

Error details for a failed request.

Show child fieldsHide child fields

policy.error.code string required

The stable machine-readable code for this result.

policy.error.message string required

A human-readable explanation of the result.

policy.error.action string required

How to resolve this issue.

disclosures ListingDisclosures or null

Provenance, grading, and authenticity statements shown to the buyer.

Show child fieldsHide child fields

disclosures.imageSource string required

Constraints: allowed values: catalog

disclosures.conditionSource string required

Constraints: allowed values: seller_declared

disclosures.authenticitySource string required

Constraints: allowed values: seller_attestation

disclosures.snapcasterInspected boolean required

Constraints: allowed values: false

disclosures.snapcasterGraded boolean required

Constraints: allowed values: false

disclosures.snapcasterAuthenticated boolean required

Constraints: allowed values: false

disclosures.gradingStandard string required

Constraints: allowed values: snapcaster-magic-v1, seller-declared-no-specialist-promise

disclosures.declaredGrade string or null required

disclosures.buyerProtection string required

Constraints: allowed values: magic-grade-and-authenticity, genuine-and-as-described

fulfillmentObligation ListingFulfillmentObligation or null

Show child fieldsHide child fields

fulfillmentObligation.sku string required

The SKU that identifies the card variant.

Constraints: allowed values: exact

fulfillmentObligation.printing string required

The card printing the seller must supply.

Constraints: allowed values: exact

fulfillmentObligation.language string required

The language of the card printing.

Constraints: allowed values: exact

fulfillmentObligation.finish string required

The physical finish or foil treatment of the card.

Constraints: allowed values: exact

fulfillmentObligation.condition string required

The normalized condition assigned to the card.

Constraints: allowed values: declared-or-better

Used by

• POST /lines/lookup - Look up cart lines (response)