{"uid":"cap_iOtIqub0HVvcIo8ToT3eL","slug":"forest-commerce-variant-resolver-285718a8","name":"Forest Commerce – Variant Resolver","description":"Resolve requested product options to a canonical public variant when the provider exposes them. Ambiguous or missing options are reported explicitly; no checkout or cart mutation occurs. Base mainnet USDC","url":"https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/commerce/variant-resolve?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."},"options":{"type":"object","description":"Public identifiers value used to scope this lookup.","additionalProperties":true}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_k74todEsM_9w0a3Pu0mFq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves requested product options (size, color, etc.) to a canonical public variant identifier, explicitly reporting ambiguous or missing options without modifying any cart or checkout state.","exampleAgentPrompt":"Can you resolve which exact product variant this URL maps to when I select size Large and color Blue? https://example-store.com/products/t-shirt","exampleUseCases":[{"title":"Resolve clothing variant before purchase","prompt":"I'm looking at this product page https://shop.example.com/hoodie and I want the size Medium in Forest Green — can you tell me which canonical variant that resolves to?"},{"title":"Detect ambiguous option combinations","prompt":"For this product URL https://store.example.com/sneakers, I'm trying to select size 10 and color White, but I'm not sure if those options are valid — can you resolve the variant and tell me if anything is ambiguous or missing?"},{"title":"Identify variant for automated order workflow","prompt":"I need the canonical variant ID for this product https://retailer.example.com/backpack with the options color: Black and capacity: 30L so I can pass it downstream in my shopping automation."}],"resultDescription":"Returns the canonical public variant identifier matching the supplied product URL and option values. If options are ambiguous or missing, those are reported explicitly. No cart is created or modified and no checkout flow is triggered.","failureModes":["Ambiguous options that match multiple variants are reported with details rather than resolved","Missing required options are flagged explicitly in the response","Product URL is unreachable or returns a non-200 status","Provider does not expose public variant data for the given URL","Supplied options do not match any known variant, returning an error or empty result","URL pattern validation fails for malformed or non-HTTP(S) URLs"],"whenToPreferThis":"Use this endpoint when you need to programmatically resolve a set of human-selected product options (size, color, etc.) to a canonical variant identifier before proceeding with price lookup, availability checking, or order automation — without touching cart or checkout state. Prefer it over full product normalization endpoints when variant resolution is the specific bottleneck, and over checkout-check endpoints when you do not yet need to validate cart reachability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:12.502Z","isFirstParty":false,"canonicalSlug":"forest-commerce-variant-resolver-285718a8"}