{"uid":"cap_Zhw_oZafsXcrZDdYgkeaD","slug":"blocklabs-shipping-options-bcff6034","name":"BlockLabs Shipping Options","description":"All available shipping options (carrier, cost EUR, delivery delay) for a basket to an EU destination - pick one and pass its carrier name into POST /api/order. Payer wallet must be deployed (counterfactual smart accounts are not supported).","url":"https://shop.blocklabs.nl/api/shipping-options","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"country":{"enum":["AT","BE","BG","HR","CY","CZ","DK","EE","FI","FR","DE","GR","HU","IE","IT","LV","LT","LU","MT","NL","PL","PT","RO","SK","SI","ES","SE"],"type":"string","description":"ISO 3166-1 alpha-2 - EU member states only (EU-only shipping)"},"postcode":{"type":"string","pattern":"\\S","minLength":1,"description":"Destination postcode"},"products":{"type":"array","items":{"type":"object","required":["reference","quantity"],"properties":{"quantity":{"type":"integer","minimum":1},"reference":{"type":"string","pattern":"\\S","minLength":1,"description":"Product SKU (from /api/search)"}}},"minItems":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xxm6nAFUfAMA-46JAxvAT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all available shipping carriers, costs (EUR), and delivery delays for a basket of products to a specified EU destination postcode","exampleAgentPrompt":"What shipping options are available for 2 units of SKU 'BL-WIDGET-42' and 1 unit of 'BL-CABLE-07' to postcode 1011AB in the Netherlands? I need carrier names, prices in EUR, and estimated delivery times so I can pick the best one.","exampleUseCases":[{"title":"Cheapest carrier for German order","prompt":"I have 3 units of product SKU 'BL-HEADSET-99' in my basket and I need to ship them to postcode 80331 in Germany — what are all the shipping options with their costs and delivery times so I can pick the cheapest one?"},{"title":"Fast delivery to French customer","prompt":"A customer in France, postcode 75008, ordered 1 unit of 'BL-MONITOR-55' and 2 units of 'BL-STAND-12'. What shipping carriers are available and which one will get it there fastest?"},{"title":"Multi-item basket shipping to Spain","prompt":"Before I place this order, can you check what shipping options exist for sending 1x 'BL-KEYBOARD-21' and 1x 'BL-MOUSE-08' to postcode 28001 in Spain? I want to see all available carriers with their prices and expected delivery delays."}],"resultDescription":"A list of available shipping options, each including the carrier name (to be passed into POST /api/order), the shipping cost in EUR, and the expected delivery delay. The agent selects one carrier from this list to fulfil the order.","failureModes":["Country not in EU allowlist — only the 27 EU member state ISO codes are accepted, non-EU countries return a validation error","Empty or whitespace-only postcode rejected by pattern validation","Products array empty or missing required reference/quantity fields","Payer wallet is counterfactual (not yet deployed on-chain) — payment will fail","Unknown SKU references that don't exist in the catalog return no matching options","x402 payment of 0.001 USDC fails due to insufficient wallet balance"],"whenToPreferThis":"Use this endpoint when you need to present shipping options to a user before placing an order via POST /api/order on the BlockLabs platform, specifically for EU-destination dropshipping. It is required before order placement since the carrier name from its response must be passed into the order endpoint. Prefer this over generic shipping rate APIs when working within the BlockLabs dropshipping catalog ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:30:47.679Z","isFirstParty":false}