{"openapi":"3.1.0","info":{"title":"Trade and Customs Reference","version":"1.0.0","description":"Harmonized System codes, Incoterms 2020 rules and UN/LOCODE ports and trade locations for trade and customs work. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"Trade and Customs Reference: Harmonized System codes, Incoterms 2020 rules and UN/LOCODE ports and trade locations for trade and customs work. Use /hs-lookup for a 2, 4 or 6-digit HS code, /hs-search to find codes by words, /hs-chapter for the headings of a chapter 01-97, /hs-structure to parse a code into chapter, heading and subheading, /incoterm for one Incoterms 2020 rule with a seller-versus-buyer responsibility table, /incoterm-compare for two rules side by side, /locode-lookup for a UN/LOCODE port or location, and /locode-search to find locodes by name. Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://trade-reference.x402tookit.com"}],"paths":{"/hs-chapter":{"get":{"operationId":"hs_chapter","summary":"List a Harmonized System 2022 chapter (01-97): title, section, and its headings or 6-digit subheadings.","description":"List a Harmonized System 2022 chapter (01-97): title, section, and its headings or 6-digit subheadings.","tags":["hs-codes","customs","chapter","trade"],"parameters":[{"name":"chapter","in":"query","required":true,"description":"Chapter number 01 to 97, e.g. 85 (chapter 77 is reserved)","schema":{"type":"string"}},{"name":"detail","in":"query","required":false,"description":"headings (default) or subheadings","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Rows 1 to 300 (default 100)","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (default 0)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"input":{"type":["null","string"]},"attribution":{"type":["null","string"]},"chapter":{"type":["null","string"]},"title":{"type":["null","string"]},"section":{"type":["null","object"],"properties":{"roman":{"type":["null","string"]},"name":{"type":["null","string"]}}},"headingCount":{"type":["null","number"]},"subheadingCount":{"type":["null","number"]},"detail":{"type":["null","string"]},"offset":{"type":["null","number"]},"returned":{"type":["null","number"]},"truncated":{"type":["boolean","null"]},"lines":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"level":{"type":["null","string"]},"description":{"type":["null","string"]},"formatted":{"type":["null","string"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"Chapter 87 \"Vehicles; other than railway or tramway rolling stock, and parts and accessories thereof\" (section XVII) has 16 headings and 98 subheadings; showing 16 headings.","reasons":["National tariff lines beyond 6 digits and duty rates are NOT included; a 6-digit HS code alone does not settle classification or duty."],"input":"87","attribution":"Harmonized System 2022 six-digit nomenclature (WCO), as published by UN Comtrade and the open datasets/harmonized-system project (ODC-PDDL), snapshot 2026-10-21. National tariff lines beyond 6 digits …","chapter":"87","title":"Vehicles; other than railway or tramway rolling stock, and parts and accessories thereof","section":{"roman":"XVII","name":"Vehicles, aircraft, vessels and associated transport equipment"},"headingCount":16,"subheadingCount":98,"detail":"headings","offset":0,"returned":16,"truncated":false,"lines":[{"code":"8701","level":"heading","description":"Tractors; (other than tractors of heading no 8709)","formatted":"8701"},{"code":"8702","level":"heading","description":"Vehicles; public transport passenger type","formatted":"8702"}],"degraded":false,"notChecked":["chapter and section notes (they decide which goods fall in which heading)","national tariff lines and duty rates","…1 more"],"source":"Harmonized System 2022, 6-digit (UN Comtrade copy, ODC-PDDL)","asOf":"2026-10-21T10:43:02.767Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-chapter"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-chapter"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-chapter"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-chapter"}}]}}},"/hs-lookup":{"get":{"operationId":"hs_lookup","summary":"Harmonized System 2022 code (2, 4 or 6 digits) to description, section, chapter and parent chain. No duty rates.","description":"Harmonized System 2022 code (2, 4 or 6 digits) to description, section, chapter and parent chain. No duty rates.","tags":["hs-codes","customs","tariff","trade"],"parameters":[{"name":"code","in":"query","required":true,"description":"HS code, e.g. 8471, 847130 or 8471.30 (digits beyond 6 are national and ignored)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"input":{"type":["null","string"]},"attribution":{"type":["null","string"]},"code":{"type":["null","string"]},"level":{"type":["null","string"]},"description":{"type":["null","string"]},"formatted":{"type":["null","string"]},"normalized":{"type":["null","string"]},"section":{"type":["null","object"],"properties":{"roman":{"type":["null","string"]},"name":{"type":["null","string"]}}},"chapter":{"type":["null","string"]},"parentChain":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"level":{"type":["null","string"]},"description":{"type":["null","string"]},"formatted":{"type":["null","string"]}}}},"childCount":{"type":["null","number"]},"children":{"type":["array","null"]},"childrenTruncated":{"type":["boolean","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"8471.30 is a subheading of HS 2022 in section XVI: Automatic data processing machines; portable, weighing not more than 10kg, consisting of at least a central processing unit, a keyboard and a display","reasons":["National tariff lines beyond 6 digits and duty rates are NOT included; a 6-digit HS code alone does not settle classification or duty."],"input":"847130","attribution":"Harmonized System 2022 six-digit nomenclature (WCO), as published by UN Comtrade and the open datasets/harmonized-system project (ODC-PDDL), snapshot 2026-10-21. National tariff lines beyond 6 digits …","code":"847130","level":"subheading","description":"Automatic data processing machines; portable, weighing not more than 10kg, consisting of at least a central processing unit, a keyboard and a display","formatted":"8471.30","normalized":"847130","section":{"roman":"XVI","name":"Machinery and mechanical appliances; electrical equipment; parts thereof; sound recorders and reproducers, television image and sound recorders and reproducers, and parts and accessories of such artic…"},"chapter":"84","parentChain":[{"code":"84","level":"chapter","description":"Machinery and mechanical appliances, boilers, nuclear reactors; parts thereof","formatted":"84"},{"code":"8471","level":"heading","description":"Automatic data processing machines and units thereof, magnetic or optical readers, machines for transcribing data onto data media in coded form and machines for processing such data, not elsewhere spe…","formatted":"8471"}],"childCount":0,"children":[],"childrenTruncated":false,"degraded":false,"notChecked":["national tariff lines beyond 6 digits (HTS, TARIC, CN 8-digit and so on)","duty rates, quotas, import licences, rules of origin and trade remedies","…2 more"],"source":"Harmonized System 2022, 6-digit (UN Comtrade copy, ODC-PDDL)","asOf":"2026-10-21T10:43:03.020Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-lookup"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-lookup"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-lookup"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-lookup"}}]}}},"/hs-search":{"get":{"operationId":"hs_search","summary":"Search Harmonized System 2022 codes by words in the description; filter by heading or subheading level and chapter.","description":"Search Harmonized System 2022 codes by words in the description; filter by heading or subheading level and chapter.","tags":["hs-codes","customs","search","trade"],"parameters":[{"name":"q","in":"query","required":true,"description":"Words like 'laptop computers', 'frozen shrimp' or 'solar cells', or a code prefix like 8471","schema":{"type":"string"}},{"name":"level","in":"query","required":false,"description":"4 for headings only, 6 for subheadings only (default: both; 2 for chapters)","schema":{"type":"integer"}},{"name":"chapter","in":"query","required":false,"description":"Only inside this chapter, 01 to 97","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 50 (default 10)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"query":{"type":["null","object"],"properties":{"q":{"type":["null","string"]},"level":{"type":["null","number"]},"chapter":{}}},"matchedBy":{"type":["null","string"]},"matches":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"level":{"type":["null","string"]},"description":{"type":["null","string"]},"formatted":{"type":["null","string"]},"matchScore":{"type":["null","number"]}}}},"totalMatches":{"type":["null","number"]},"truncated":{"type":["boolean","null"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"14 HS codes match \"portable data processing\" (description words); best: 8471.30 Automatic data processing machines; portable, weighing not more than 10kg, consi.","reasons":["No description contained every word, so partial matches are listed.","A word match is a candidate only: classification follows the legal notes and General Rules, not word matching.","…1 more"],"query":{"q":"portable data processing","level":6,"chapter":null},"matchedBy":"description words","matches":[{"code":"847130","level":"subheading","description":"Automatic data processing machines; portable, weighing not more than 10kg, consisting of at least a central processing unit, a keyboard and a display","formatted":"8471.30","matchScore":45},{"code":"847170","level":"subheading","description":"Units of automatic data processing machines; storage units","formatted":"8471.70","matchScore":23.3}],"totalMatches":14,"truncated":true,"attribution":"Harmonized System 2022 six-digit nomenclature (WCO), as published by UN Comtrade and the open datasets/harmonized-system project (ODC-PDDL), snapshot 2026-10-21. National tariff lines beyond 6 digits …","degraded":false,"notChecked":["trade names and synonyms that are not in the official wording (customs descriptions use formal terms, so 'laptop' may not match)","classification rules and notes: a word match is a candidate, never a classification","…1 more"],"source":"Harmonized System 2022, 6-digit (UN Comtrade copy, ODC-PDDL)","asOf":"2026-10-21T10:43:03.291Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-search"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-search"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-search"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-search"}}]}}},"/hs-structure":{"get":{"operationId":"hs_structure","summary":"Parse an HS code into chapter, heading and subheading parts, flag reserved or national-use digits, and format it.","description":"Parse an HS code into chapter, heading and subheading parts, flag reserved or national-use digits, and format it.","tags":["hs-codes","customs","parsing","validation"],"parameters":[{"name":"code","in":"query","required":true,"description":"HS code of 2, 4 or 6 digits, or a national code like 8471.30.0100 or 847130100000","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"input":{"type":["null","string"]},"attribution":{"type":["null","string"]},"level":{"type":["null","string"]},"parts":{"type":["null","object"],"properties":{"chapter":{"type":["null","string"]},"heading":{"type":["null","string"]},"headingSuffix":{"type":["null","string"]},"subheading":{"type":["null","string"]},"subheadingSuffix":{"type":["null","string"]},"nationalDigits":{"type":["null","string"]}}},"formatted":{"type":["null","string"]},"section":{"type":["null","object"],"properties":{"roman":{"type":["null","string"]},"name":{"type":["null","string"]}}},"chapterTitle":{"type":["null","string"]},"checks":{"type":["null","object"],"properties":{"digitsOnly":{"type":["boolean","null"]},"evenLength":{"type":["boolean","null"]},"chapterNumberInRange":{"type":["boolean","null"]},"chapterExists":{"type":["boolean","null"]},"chapterReserved":{"type":["boolean","null"]},"headingExists":{"type":["boolean","null"]},"subheadingExists":{"type":["boolean","null"]}}},"headingTitle":{"type":["null","string"]},"subheadingTitle":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"VALID_STRUCTURE","summary":"8471.30.0100: subheading in chapter 84 (section XVI).","reasons":["Digits 0100 are national (set by each customs territory), not part of the international HS; the HS part is 847130.","National tariff lines beyond 6 digits and duty rates are NOT included; a 6-digit HS code alone does not settle classification or duty."],"input":"8471.30.0100","attribution":"Harmonized System 2022 six-digit nomenclature (WCO), as published by UN Comtrade and the open datasets/harmonized-system project (ODC-PDDL), snapshot 2026-10-21. National tariff lines beyond 6 digits …","level":"subheading","parts":{"chapter":"84","heading":"8471","headingSuffix":"71","subheading":"847130","subheadingSuffix":"30","nationalDigits":"0100"},"formatted":"8471.30.0100","section":{"roman":"XVI","name":"Machinery and mechanical appliances; electrical equipment; parts thereof; sound recorders and reproducers, television image and sound recorders and reproducers, and parts and accessories of such artic…"},"chapterTitle":"Machinery and mechanical appliances, boilers, nuclear reactors; parts thereof","checks":{"digitsOnly":true,"evenLength":true,"chapterNumberInRange":true,"chapterExists":true,"chapterReserved":false,"headingExists":true,"subheadingExists":true},"headingTitle":"Automatic data processing machines and units thereof, magnetic or optical readers, machines for transcribing data onto data media in coded form and machines for processing such data, not elsewhere spe…","subheadingTitle":"Automatic data processing machines; portable, weighing not more than 10kg, consisting of at least a central processing unit, a keyboard and a display","degraded":false,"notChecked":["whether goods really belong under this code (classification follows legal notes and General Rules)","validity of national digits beyond 6 (each country defines its own)","…1 more"],"source":"Harmonized System 2022, 6-digit (UN Comtrade copy, ODC-PDDL)","asOf":"2026-10-21T10:43:03.553Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-structure"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-structure"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-structure"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/hs-structure"}}]}}},"/incoterm-compare":{"get":{"operationId":"incoterm_compare","summary":"Compare two Incoterms 2020 rules item by item: who clears export and import, pays carriage and insurance, bears risk.","description":"Compare two Incoterms 2020 rules item by item: who clears export and import, pays carriage and insurance, bears risk.","tags":["incoterms","compare","shipping","trade"],"parameters":[{"name":"a","in":"query","required":true,"description":"First rule, e.g. FOB","schema":{"type":"string"}},{"name":"b","in":"query","required":true,"description":"Second rule, e.g. CIF","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"a":{"type":["null","object"],"properties":{"rule":{"type":["null","string"]},"name":{"type":["null","string"]},"transport":{"type":["null","string"]},"anyMode":{"type":["boolean","null"]},"seaOnly":{"type":["boolean","null"]},"group":{"type":["null","string"]},"delivery":{"type":["null","string"]},"riskTransfer":{"type":["null","string"]},"costs":{"type":["null","string"]},"responsibilities":{"type":["array","null"],"items":{"type":"object","properties":{"item":{"type":["null","string"]},"description":{"type":["null","string"]},"party":{"type":["null","string"]}}}},"sellerResponsibilityScore":{"type":["null","number"]},"sellerResponsibilityScaleMax":{"type":["null","number"]},"typicalUse":{"type":["null","string"]},"changeIn2020":{"type":["null","string"]}}},"b":{"type":["null","object"],"properties":{"rule":{"type":["null","string"]},"name":{"type":["null","string"]},"transport":{"type":["null","string"]},"anyMode":{"type":["boolean","null"]},"seaOnly":{"type":["boolean","null"]},"group":{"type":["null","string"]},"delivery":{"type":["null","string"]},"riskTransfer":{"type":["null","string"]},"costs":{"type":["null","string"]},"responsibilities":{"type":["array","null"],"items":{"type":"object","properties":{"item":{"type":["null","string"]},"description":{"type":["null","string"]},"party":{"type":["null","string"]},"note":{"type":["null","string"]}}}},"sellerResponsibilityScore":{"type":["null","number"]},"sellerResponsibilityScaleMax":{"type":["null","number"]},"typicalUse":{"type":["null","string"]},"changeIn2020":{"type":["null","string"]}}},"table":{"type":["array","null"],"items":{"type":"object","properties":{"item":{"type":["null","string"]},"description":{"type":["null","string"]},"FOB":{"type":["null","string"]},"CIF":{"type":["null","string"]},"differs":{"type":["boolean","null"]}}}},"differences":{"type":["array","null"],"items":{"type":"string"}},"sameTransportMode":{"type":["boolean","null"]},"sellerHandlesMore":{"type":["null","string"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPARED","summary":"FOB vs CIF: 2 of 6 responsibilities differ; the seller carries more under CIF.","reasons":["Risk: FOB — Risk passes to the buyer once the goods are on board. CIF — Risk passes to the buyer once the goods are on board at the port of shipment.","The seller-load score is our own simple count (import clearance counts double), not an ICC measure."],"a":{"rule":"FOB","name":"Free On Board","transport":"sea and inland waterway transport only","anyMode":false,"seaOnly":true,"group":"F: main carriage not paid by the seller","delivery":"The seller delivers when the goods are on board the vessel the buyer has nominated at the named port of shipment.","riskTransfer":"Risk passes to the buyer once the goods are on board.","costs":"The buyer pays the sea freight; the seller clears the goods for export and pays loading on board.","responsibilities":[{"item":"exportClearance","description":"Export clearance (licences, formalities, export duties)","party":"seller"},{"item":"mainCarriage","description":"Contracting and paying the main carriage","party":"buyer"}],"sellerResponsibilityScore":1,"sellerResponsibilityScaleMax":7,"typicalUse":"Classic rule for non-containerised sea cargo. For containers handed to a terminal before loading, FCA fits better because the seller's risk would otherwise last past the real handover.","changeIn2020":"none"},"b":{"rule":"CIF","name":"Cost, Insurance and Freight","transport":"sea and inland waterway transport only","anyMode":false,"seaOnly":true,"group":"C: seller pays main carriage, risk passes early","delivery":"As CFR: on board at the port of shipment, with the seller paying freight to the named port of destination.","riskTransfer":"Risk passes to the buyer once the goods are on board at the port of shipment.","costs":"The seller pays freight and also buys the insurance described below.","responsibilities":[{"item":"exportClearance","description":"Export clearance (licences, formalities, export duties)","party":"seller"},{"item":"mainCarriage","description":"Contracting and paying the main carriage","party":"seller"}],"sellerResponsibilityScore":3,"sellerResponsibilityScaleMax":7,"typicalUse":"CFR plus insurance paid by the seller, at the minimum cover level (the buyer can ask for more).","changeIn2020":"none (cover stays at the minimum level, unlike CIP)"},"table":[{"item":"exportClearance","description":"Export clearance (licences, formalities, export duties)","FOB":"seller","CIF":"seller","differs":false},{"item":"mainCarriage","description":"Contracting and paying the main carriage","FOB":"buyer","CIF":"seller","differs":true}],"differences":["Contracting and paying the main carriage: FOB = buyer, CIF = seller","Obligation to buy cargo insurance for the other party's benefit: FOB = none, CIF = seller"],"sameTransportMode":true,"sellerHandlesMore":"CIF","attribution":"Incoterms 2020 summaries are written in our own words from public descriptions, not the ICC text; the ICC publication governs. Confirm the rule, named place and edition in your contract.","degraded":false,"notChecked":["the ICC wording (plain-language summary only)","contract-specific changes, local law, customs valuation or tax treatment","…1 more"],"source":"Incoterms 2020 rules summarised in our own words (ICC rules; not the ICC text)","asOf":"2026-10-21T10:43:03.818Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0300"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/incoterm-compare"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/incoterm-compare"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/incoterm-compare"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/incoterm-compare"}}]}}},"/incoterm":{"get":{"operationId":"incoterm","summary":"Explain one Incoterms 2020 rule (EXW, FCA, CPT, CIP, DAP, DPU, DDP, FAS, FOB, CFR, CIF) with a seller vs buyer table.","description":"Explain one Incoterms 2020 rule (EXW, FCA, CPT, CIP, DAP, DPU, DDP, FAS, FOB, CFR, CIF) with a seller vs buyer table.","tags":["incoterms","shipping","trade","contracts"],"parameters":[{"name":"rule","in":"query","required":true,"description":"Three-letter rule: EXW FCA CPT CIP DAP DPU DDP FAS FOB CFR CIF","schema":{"type":"string"}},{"name":"place","in":"query","required":false,"description":"Named place or port, e.g. Rotterdam, to show the full term (FOB Rotterdam Incoterms 2020)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"term":{"type":["null","string"]},"rule":{"type":["null","string"]},"name":{"type":["null","string"]},"transport":{"type":["null","string"]},"anyMode":{"type":["boolean","null"]},"seaOnly":{"type":["boolean","null"]},"group":{"type":["null","string"]},"delivery":{"type":["null","string"]},"riskTransfer":{"type":["null","string"]},"costs":{"type":["null","string"]},"responsibilities":{"type":["array","null"],"items":{"type":"object","properties":{"item":{"type":["null","string"]},"description":{"type":["null","string"]},"party":{"type":["null","string"]}}}},"sellerResponsibilityScore":{"type":["null","number"]},"sellerResponsibilityScaleMax":{"type":["null","number"]},"typicalUse":{"type":["null","string"]},"changeIn2020":{"type":["null","string"]},"sellerHandles":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"EXPLAINED","summary":"FOB Shanghai Incoterms 2020 (Free On Board): The seller delivers when the goods are on board the vessel the buyer has nominated at the named port of shipment. Risk passes to the buyer once the goods a…","reasons":["FOB Shanghai Incoterms 2020: for sea and inland waterway transport only.","Do not use this rule for air, road, rail or containers handed over at a terminal; the any-mode rules (FCA, CPT, CIP) fit those."],"term":"FOB Shanghai Incoterms 2020","rule":"FOB","name":"Free On Board","transport":"sea and inland waterway transport only","anyMode":false,"seaOnly":true,"group":"F: main carriage not paid by the seller","delivery":"The seller delivers when the goods are on board the vessel the buyer has nominated at the named port of shipment.","riskTransfer":"Risk passes to the buyer once the goods are on board.","costs":"The buyer pays the sea freight; the seller clears the goods for export and pays loading on board.","responsibilities":[{"item":"exportClearance","description":"Export clearance (licences, formalities, export duties)","party":"seller"},{"item":"mainCarriage","description":"Contracting and paying the main carriage","party":"buyer"}],"sellerResponsibilityScore":1,"sellerResponsibilityScaleMax":7,"typicalUse":"Classic rule for non-containerised sea cargo. For containers handed to a terminal before loading, FCA fits better because the seller's risk would otherwise last past the real handover.","changeIn2020":"none","sellerHandles":["exportClearance"],"attribution":"Incoterms 2020 summaries are written in our own words from public descriptions, not the ICC text; the ICC publication governs. Confirm the rule, named place and edition in your contract.","degraded":false,"notChecked":["the ICC wording (this is a plain-language summary; the ICC publication governs)","contract-specific changes, local law, customs valuation or tax treatment","…1 more"],"source":"Incoterms 2020 rules summarised in our own words (ICC rules; not the ICC text)","asOf":"2026-10-21T10:43:04.070Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/incoterm"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/incoterm"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/incoterm"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/incoterm"}}]}}},"/locode-lookup":{"get":{"operationId":"locode_lookup","summary":"UN/LOCODE (for example NLRTM) to place name, country, port/rail/airport function flags, status and coordinates.","description":"UN/LOCODE (for example NLRTM) to place name, country, port/rail/airport function flags, status and coordinates.","tags":["locode","ports","trade","unece"],"parameters":[{"name":"locode","in":"query","required":true,"description":"5-character UN/LOCODE, e.g. NLRTM or 'NL RTM'","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"input":{"type":["null","string"]},"attribution":{"type":["null","string"]},"locode":{"type":["null","string"]},"countryCode":{"type":["null","string"]},"locationCode":{"type":["null","string"]},"country":{"type":["null","string"]},"name":{"type":["null","string"]},"asciiName":{"type":["null","string"]},"subdivision":{"type":["null","string"]},"functions":{"type":["array","null"],"items":{"type":"string"}},"functionCodes":{"type":["null","string"]},"isPort":{"type":["boolean","null"]},"isAirport":{"type":["boolean","null"]},"isRail":{"type":["boolean","null"]},"status":{"type":["null","string"]},"statusMeaning":{"type":["null","string"]},"approved":{"type":["boolean","null"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"iata":{},"normalized":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"NLRTM is Rotterdam (ZH), Netherlands: port, rail terminal, road terminal, airport, postal exchange office.","reasons":[],"input":"NLRTM","attribution":"UN/LOCODE (UNECE), via the datasets/un-locode mirror, snapshot 2026-10-21. Redistribution licence unclear; verify at unlocode.unece.org.","locode":"NLRTM","countryCode":"NL","locationCode":"RTM","country":"Netherlands","name":"Rotterdam","asciiName":"Rotterdam","subdivision":"ZH","functions":["port","rail terminal","…3 more"],"functionCodes":"12345","isPort":true,"isAirport":true,"isRail":true,"status":"AF","statusMeaning":"approved by a national facilitation body","approved":true,"lat":51.9167,"lon":4.5,"iata":null,"normalized":"NLRTM","degraded":false,"notChecked":["road-only, postal-only and function-unknown entries (dropped from this dataset, so a missing code may still exist)","berth, terminal, customs-office or port-authority detail","…2 more"],"source":"UN/LOCODE (UNECE) via open mirror; licence unclear","asOf":"2026-10-21T10:43:04.322Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/locode-lookup"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/locode-lookup"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/locode-lookup"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/locode-lookup"}}]}}},"/locode-search":{"get":{"operationId":"locode_search","summary":"Search UN/LOCODEs by place name, optionally within a country or by port, rail, airport function; capped at 50.","description":"Search UN/LOCODEs by place name, optionally within a country or by port, rail, airport function; capped at 50.","tags":["locode","ports","search","trade"],"parameters":[{"name":"q","in":"query","required":true,"description":"Place name or start of it, e.g. Rotterdam, Los Angeles or Felix","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO 3166 code or country name to restrict to","schema":{"type":"string"}},{"name":"function","in":"query","required":false,"description":"port, rail, airport, multimodal or border","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 50 (default 10)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"query":{"type":["null","object"],"properties":{"q":{"type":["null","string"]},"country":{},"function":{"type":["null","string"]}}},"matches":{"type":["array","null"],"items":{"type":"object","properties":{"locode":{"type":["null","string"]},"countryCode":{"type":["null","string"]},"locationCode":{"type":["null","string"]},"country":{"type":["null","string"]},"name":{"type":["null","string"]},"asciiName":{"type":["null","string"]},"subdivision":{"type":["null","string"]},"functions":{"type":["array","null"],"items":{"type":"string"}},"functionCodes":{"type":["null","string"]},"isPort":{"type":["boolean","null"]},"isAirport":{"type":["boolean","null"]},"isRail":{"type":["boolean","null"]},"status":{"type":["null","string"]},"statusMeaning":{"type":["null","string"]},"approved":{"type":["boolean","null"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"iata":{},"matchScore":{"type":["null","number"]}}}},"totalMatches":{"type":["null","number"]},"truncated":{"type":["boolean","null"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"2 UN/LOCODE matches for \"rotterdam\"; best: NLRTM Rotterdam, Netherlands.","reasons":["Score: 100 exact name, 80 prefix, 60 word prefix, 40 contains. Ties favour ports, then approved statuses.","Several places can share a name in different countries; check the country."],"query":{"q":"rotterdam","country":null,"function":"port"},"matches":[{"locode":"NLRTM","countryCode":"NL","locationCode":"RTM","country":"Netherlands","name":"Rotterdam","asciiName":"Rotterdam","subdivision":"ZH","functions":["port","rail terminal","…3 more"],"functionCodes":"12345","isPort":true,"isAirport":true,"isRail":true,"status":"AF","statusMeaning":"approved by a national facilitation body","approved":true,"lat":51.9167,"lon":4.5,"iata":null,"matchScore":100},{"locode":"USRAJ","countryCode":"US","locationCode":"RAJ","country":"United States of America (the)","name":"Rotterdam","asciiName":"Rotterdam","subdivision":"NY","functions":["port","rail terminal","…1 more"],"functionCodes":"123","isPort":true,"isAirport":false,"isRail":true,"status":"RL","statusMeaning":"recognised location: existence and name confirmed against a gazetteer or reference work","approved":false,"lat":42.7833,"lon":-73.9667,"iata":null,"matchScore":100}],"totalMatches":2,"truncated":false,"attribution":"UN/LOCODE (UNECE), via the datasets/un-locode mirror, snapshot 2026-10-21. Redistribution licence unclear; verify at unlocode.unece.org.","degraded":false,"notChecked":["road-only and postal-only locations (not in this dataset)","alternative names and spellings other than the official and ASCII names","…1 more"],"source":"UN/LOCODE (UNECE) via open mirror; licence unclear","asOf":"2026-10-21T10:43:04.578Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/locode-search"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/locode-search"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/locode-search"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://trade-reference.x402tookit.com/locode-search"}}]}}}}}