{"uid":"cap_S1EJXyboyNDC2FO5zCIhW","slug":"tradepulse-incoterms-2020-decoder-d83e05a0","name":"TradePulse Incoterms 2020 Decoder","description":"Incoterms 2020 decoder for trade and import-export agents. Returns a plain-English explanation of any Incoterm with buyer/seller obligation split, risk transfer point, documentation checklist, and insurance guidance.","url":"https://tradepulse-five.vercel.app/api/trade/incoterms","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"lang":{"type":"string"},"term":{"type":"string"},"product":{"type":"string"},"to_country":{"type":"string"},"from_country":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"term":"FOB","full_name":"Free on Board","when_NOT_to_use":["Container shipments — use FCA instead (ICC 2020 recommendation)"],"buyer_obligations":{"pays_for":["Ocean freight","Marine insurance","Import duties"]},"seller_obligations":{"pays_for":["Export customs","Origin port handling to vessel"]},"risk_transfer_point":"When goods pass ship's rail at named port of origin"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bgxqbEUJzEOxo2rJt5x68","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a plain-English explanation of any Incoterm with buyer/seller obligation split, risk transfer point, documentation checklist, insurance guidance, and when-to-use comparison","exampleAgentPrompt":"Can you decode the Incoterm DDP for me — explain what it means in plain English, who's responsible for what between buyer and seller, where risk transfers, what documents are needed, and when I should use it versus other options?","exampleUseCases":[{"title":"Clarify FOB buyer seller split","prompt":"Can you break down the FOB Incoterm for me? I need to understand exactly what my seller is responsible for versus what I'm on the hook for as the buyer, where the risk transfers, and what paperwork I should be expecting from them."},{"title":"Choose best Incoterm for sea freight","prompt":"I'm shipping a large container of goods overseas and I'm not sure whether to use CIF or CFR in my contract. Can you explain both and help me figure out which one makes more sense for my situation, especially around insurance and who carries the risk during the voyage?"},{"title":"Understand EXW obligations before signing","prompt":"My supplier wants to use EXW on our next order and I'm not totally sure what that means for us. Can you explain what EXW actually requires from both sides, what documents we'll need, and whether there's a better alternative we should consider before we sign the contract?"}],"resultDescription":"A structured breakdown of the requested Incoterm including: plain-English definition, buyer obligations, seller obligations, the exact point of risk transfer, a documentation checklist, insurance requirements and guidance, and a when-to-use comparison against alternative Incoterms.","failureModes":["Invalid or unrecognized Incoterm code returns an error or empty result","Misspelled Incoterm abbreviation may not be matched","Network timeout if the vercel deployment is cold-starting","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when an agent or user needs to quickly understand the meaning, obligations, and practical implications of a specific Incoterm 2020 rule — especially when they need the buyer/seller split, risk transfer point, and documentation requirements in structured, actionable form. Ideal for trade compliance workflows, contract drafting assistance, freight procurement decisions, and onboarding teams unfamiliar with Incoterms.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:41:15.028Z","isFirstParty":false}