{"uid":"cap_xX_7PkdgYM2_TpvFFY5Mp","slug":"forgemesh-shopscout-shipping-comparison-a235497c","name":"ForgeMesh ShopScout – Shipping Comparison","description":"Compare single-seller and split baskets using supplied shipping rules, including free-shipping thresholds and delivery constraints. Estimates exclude tax and duties.","url":"https://shopscout.forgemesh.io/v1/shipping/compare?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","required":["item_id","quantity","offers"],"properties":{"offers":{"type":"array","items":{"type":"object","required":["offer_id","group_id","unit_price_minor"],"properties":{"group_id":{"type":"string","pattern":"^[a-zA-Z0-9_.-]{1,80}$"},"offer_id":{"type":"string","pattern":"^[a-zA-Z0-9_.-]{1,80}$"},"unit_price_minor":{"type":"integer","maximum":1000000000,"minimum":0}}},"maxItems":4,"minItems":1},"item_id":{"type":"string","pattern":"^[a-zA-Z0-9_.-]{1,80}$"},"quantity":{"type":"integer","maximum":100,"minimum":1}}},"maxItems":6,"minItems":1},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"All input amounts use minor units of this currency; no currency conversion."},"constraints":{"type":"object","properties":{"max_shipments":{"type":"integer","maximum":6,"minimum":1},"max_delivery_days":{"type":"integer","maximum":365,"minimum":0}}},"destination":{"type":"object","required":["country"],"properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$"}}},"fulfillment_groups":{"type":"array","items":{"type":"object","required":["group_id","merchant_id","rule_source","ship_to_countries","methods"],"properties":{"methods":{"type":"array","items":{"type":"object","required":["method_id","base_minor","per_unit_minor","delivery_days_max"],"properties":{"method_id":{"type":"string","pattern":"^[a-zA-Z0-9_.-]{1,80}$"},"base_minor":{"type":"integer","maximum":1000000000,"minimum":0},"per_unit_minor":{"type":"integer","maximum":1000000000,"minimum":0},"delivery_days_max":{"type":["integer","null"],"maximum":365,"minimum":0},"free_over_subtotal_minor":{"type":"integer","maximum":1000000000,"minimum":0}}},"maxItems":4,"minItems":1},"group_id":{"type":"string","pattern":"^[a-zA-Z0-9_.-]{1,80}$"},"merchant_id":{"type":"string","pattern":"^[a-zA-Z0-9_.-]{1,80}$"},"rule_source":{"type":"string","maxLength":500,"minLength":1},"ship_to_countries":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1}}},"maxItems":12,"minItems":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8GuO92F7Wa_N6CVwHxdVP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares single-seller and split-basket shipping costs across fulfillment groups using supplied shipping rules, free-shipping thresholds, and delivery constraints.","exampleAgentPrompt":"I have 2 items in my cart — item A (qty 2) offered by merchant-1 at 1500 USD cents and merchant-2 at 1400 USD cents, and item B (qty 1) offered only by merchant-1 at 800 cents. Merchant-1 ships to US for $5 base with free shipping over $20, and merchant-2 charges $4 flat. Can you compare single-seller vs split-basket shipping to the US in USD and tell me which option is cheapest?","exampleUseCases":[{"title":"Split-basket shipping cost optimization","prompt":"I'm shopping for 3 products across two Shopify stores — store A has all three items but store B has two of them cheaper. Both ship to GB. Store A charges £3.99 flat shipping free over £30, store B charges £2.99 flat. I'm spending roughly £25 total. Can you compare whether buying everything from store A or splitting the order saves money on shipping, using GBP minor units?"},{"title":"Enforcing same-day delivery constraint","prompt":"I need to order 4 items for delivery within 3 days to the US. Seller X offers standard (5 days, $4.99) and express (2 days, $12.99) shipping, seller Y offers standard (4 days, $5.99) and express (1 day, $14.99). Can you run a shipping comparison with a max_delivery_days of 3 and tell me which valid fulfillment options exist and what they cost?"},{"title":"Free-shipping threshold eligibility check","prompt":"I want to buy 2 units of product SKU-123 and 1 unit of SKU-456 from merchant shop-alpha, shipping to CA in CAD. Their standard shipping is $7.99 base with free shipping on orders over $5000 cents, and express is $14.99. Can you compute the shipping cost for each method and flag if the free-shipping threshold is triggered?"}],"resultDescription":"Returns a ranked set of fulfillment basket configurations (single-seller and split across groups), each showing per-group shipping method selected, shipping cost in minor currency units, subtotal, total estimated cost (excluding tax and duties), and delivery day estimate. Configurations that violate delivery or shipment constraints are excluded.","failureModes":["Item references an offer group_id not present in fulfillment_groups — validation error","Destination country not covered by any fulfillment group's ship_to_countries — no valid configurations returned","All fulfillment options exceed max_delivery_days constraint — empty result set","Currency code does not match a valid ISO-4217 3-letter code — schema rejection","Item or fulfillment_groups arrays exceed size limits (6 items, 4 methods, 4 offers) — 422 error","Mismatched minor unit amounts (e.g. sending dollar amounts instead of cents) — silently incorrect results","Payment not included or insufficient — 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to programmatically compare shipping costs across multiple fulfillment groups or merchants for a shopping basket, especially when free-shipping thresholds, delivery day constraints, or split-basket scenarios are involved. It is the right choice when you already have offer prices and shipping rules and want pure cost computation without triggering a checkout. Prefer alternatives if you need real-time rate quotes from carriers, tax/duty calculation, or actual order placement.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:36:17.451Z","isFirstParty":false,"canonicalSlug":"forgemesh-shopscout-shipping-comparison-a235497c"}