{"uid":"cap_boIYOXottp7MXO0Sy91Fu","slug":"rafid-logistics-shipping-cost-estimate-3b8c355f","name":"Rafid Logistics Shipping Cost Estimate","description":"Rafid Agent API provides structured intelligence and paid APIs for AI agents across property, company and risk, supplier, finance, document, website, automotive, logistics, recruitment, trading, voice, video and business-planning workflows.","url":"https://api.rafidsystem.com/api/v1/x402/logistics/shipping-cost-estimate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"origin":{"type":"object","required":["country"],"properties":{"city":{"type":"string","maxLength":100,"minLength":1},"country":{"type":"string","maxLength":2,"minLength":1},"postalCode":{"type":"string","maxLength":20,"minLength":1}},"additionalProperties":false},"currency":{"type":"string","default":"USD","maxLength":3,"minLength":1},"shipment":{"type":"object","required":["weightKg","quantity"],"properties":{"widthCm":{"type":"number","maximum":1000,"exclusiveMinimum":0},"category":{"type":"string","maxLength":60,"minLength":1},"heightCm":{"type":"number","maximum":1000,"exclusiveMinimum":0},"lengthCm":{"type":"number","maximum":1000,"exclusiveMinimum":0},"quantity":{"type":"integer","default":1,"maximum":10000,"minimum":1},"weightKg":{"type":"number","maximum":100000,"exclusiveMinimum":0},"declaredValue":{"type":"number","maximum":100000000,"minimum":0}},"additionalProperties":false},"destination":{"type":"object","required":["country"],"properties":{"city":{"type":"string","maxLength":100,"minLength":1},"country":{"type":"string","maxLength":2,"minLength":1},"postalCode":{"type":"string","maxLength":20,"minLength":1}},"additionalProperties":false},"serviceLevel":{"enum":["economy","standard","express","auto"],"type":"string","default":"auto"},"shippingMode":{"enum":["courier","air","sea","road","postal","auto"],"type":"string","default":"auto"}}},"responseSchema":{"type":"json","example":{"options":[],"provider":null,"riskFlags":[{"code":"HEURISTIC_ESTIMATE","message":"This is a heuristic estimate, not an official carrier quote.","severity":"medium"}],"confidence":{"level":"low","reason":"Illustrative heuristic data; no live carrier quote or configured internal route rate is assumed."},"rateSource":"heuristic_estimate","assumptions":["Illustrative example only; no live carrier quote."],"generatedAt":"2026-01-01T00:00:00.000Z","serviceLevel":"standard","shippingMode":"air","costBreakdown":{"handling":6,"baseFreight":48,"fuelSurcharge":9,"oversizeSurcharge":0,"estimatedOtherFees":4,"remoteAreaSurcharge":0},"estimatedCost":{"max":78,"min":55,"currency":"USD"},"actualWeightKg":8,"dutiesAndTaxes":{"note":"Import duties and taxes are not included in the shipping estimate.","included":false,"estimatedAmount":null},"chargeableWeightKg":9.45,"volumetricWeightKg":9.45,"recommendedEstimate":66.5,"estimatedTransitDays":{"max":8,"min":4},"recommendedOptionReason":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yqgmjxK5Cx292QHMkrK_3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Estimates international or domestic shipping costs including freight, surcharges, transit days, and weight details for a given shipment route and service level.","exampleAgentPrompt":"Can you estimate the shipping cost for a 8kg package (40cm x 35cm x 30cm) going from Germany (DE) to Japan (JP) via air freight on a standard service level? I need the cost breakdown in USD.","exampleUseCases":[{"title":"E-commerce international order cost check","prompt":"I need a shipping cost estimate for a 2kg product I'm selling — it's 30cm x 20cm x 15cm — being shipped from the US to Australia by courier on the standard service level. Give me the cost breakdown and expected delivery window in USD."},{"title":"B2B bulk freight planning","prompt":"Estimate the freight cost to ship 500 units weighing 300kg total by sea from China (CN) to the United Kingdom (GB). Each unit is about 20cm x 20cm x 20cm — I want to see the full cost breakdown in USD."},{"title":"Express delivery urgency scenario","prompt":"How much would it cost to send an 1.5kg parcel via express courier from Canada (CA) to the UAE (AE)? It's about 25cm x 15cm x 10cm and I need the fastest service level available with the transit time estimate."}],"resultDescription":"Returns an estimated shipping cost range (min/max) and a recommended midpoint estimate in the requested currency, along with a detailed cost breakdown (base freight, handling, fuel surcharge, oversize and remote area surcharges), chargeable and volumetric weight, estimated transit days, duties and taxes disclaimer, confidence level, rate source, risk flags (e.g. HEURISTIC_ESTIMATE), and key assumptions about the estimate.","failureModes":["Missing required fields (origin.country, destination.country, shipment.weightKg, shipment.quantity) returns validation error","Invalid 2-letter country code returns input error","Weight or dimensions exceeding maximums (100,000 kg, 1,000 cm) return range error","Unsupported route combinations may return low-confidence heuristic estimate with risk flags","No live carrier integration — all estimates are heuristic and may not reflect actual carrier rates","Currency code not recognized may default to USD or return error"],"whenToPreferThis":"Use this endpoint when an AI agent needs a quick, structured shipping cost estimate for logistics planning, e-commerce checkout, or supply chain budgeting — especially when you need a cost breakdown with transit time, chargeable weight computation, and risk/confidence signals. Prefer this over carrier-specific APIs when you want a unified interface across modes (courier, air, sea, road, postal) and service levels. Note that this returns heuristic estimates, not live carrier quotes, so it is best suited for planning and budgeting rather than final booking decisions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:39:30.877Z","isFirstParty":false,"canonicalSlug":"rafid-logistics-shipping-cost-estimate-3b8c355f"}