{"uid":"cap_rSLwHa-rutkbFeP_k1hwu","slug":"forest-commerce-cart-preflight-dfc1024a","name":"Forest Commerce Cart Preflight","description":"Preflight an item into a fresh isolated commerce session without touching a customer cart. Sessions are ephemeral and payment/order creation is never attempted. Base mainnet USDC","url":"https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/commerce/cart-preflight?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","pattern":"^https?://","maxLength":2048,"description":"Public HTTP(S) URL to inspect, resolve, or compare."},"quantity":{"type":"integer","maximum":100,"minimum":1,"description":"Requested item quantity to validate against provider limits."},"variant_id":{"type":"string","description":"Public provider variant identifier to validate."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GtCZdmmtDv4SwcqjvYCSy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a product item into an isolated, ephemeral commerce session to check purchasability without touching a real cart or initiating payment.","exampleAgentPrompt":"Before I commit to buying this product, can you preflight https://shop.example.com/products/blue-sneakers with variant ID 'SKU-7842' for a quantity of 3 to check if it's purchasable without actually placing an order?","exampleUseCases":[{"title":"Pre-purchase variant eligibility check","prompt":"Can you run a preflight check on https://store.example.com/items/wireless-headphones with variant 'VAR-1099' and quantity 2 to see if it would go through before I try to buy it?"},{"title":"Bulk quantity purchase validation","prompt":"I want to order 50 units of a product at https://wholesale.example.com/products/tshirt-black with variant 'SIZE-L-BLACK' — can you validate that quantity is allowed without actually placing the order?"},{"title":"Automated shopping agent pre-check","prompt":"Before my agent adds anything to the cart, preflight https://marketplace.example.com/listing/camera-lens-77mm with variant 'LENS-VAR-42' and quantity 1 to confirm there are no blockers."}],"resultDescription":"Returns a structured validation result for the preflighted item in an isolated ephemeral session, including whether the item is purchasable, any blockers (e.g. quantity limits, variant unavailability, URL resolution failures), and constraint details — without creating any order, cart, or payment transaction.","failureModes":["Invalid or non-public URL returns a URL resolution error","Quantity exceeding provider maximum (100) returns a constraint violation","Unknown or invalid variant_id returns a variant not found error","Network timeout or unreachable product URL returns a connectivity failure","Malformed URL (not matching https?://) returns a schema validation error"],"whenToPreferThis":"Use this endpoint when you need to validate whether a product is purchasable before committing to cart or checkout actions. Prefer this over checkout-check or availability-check endpoints when you want a combined session-level preflight that covers URL validity, variant resolution, and quantity constraints in a single call without any side effects. Ideal for automated shopping agents that need safe, read-only pre-validation before executing purchases.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:17.258Z","isFirstParty":false,"canonicalSlug":"forest-commerce-cart-preflight-dfc1024a"}