{"openapi":"3.1.0","info":{"title":"Incoterms API","version":"1.0.0","description":"The ICC Incoterms — the international commercial terms used in every contract of international sale — as an API. For each of the 11 three-letter terms (EXW, FCA, FAS, FOB, CFR, CIF, CPT, CIP, DAP, DPU, DDP): its full name, a plain-language description of what the seller and the buyer are each responsible for, the official Incoterms group (E departure, F main-carriage-unpaid, C main-carriage-paid, D arrival) and the mode of transport it applies to (any mode, or sea and inland waterway only). Look a term up, list the terms in a group, filter by transport mode, or list them all. The reference an e-commerce checkout, ERP, freight-forwarding or trade-finance system needs to interpret a delivery term. Served from memory — always fast.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/incoterms-api","description":"oanor gateway"}],"tags":[{"name":"Lookup"},{"name":"Group"},{"name":"Mode"},{"name":"List"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/term":{"get":{"operationId":"get_v1_term","tags":["Lookup"],"summary":"Incoterm by three-letter term","description":"","parameters":[{"name":"term","in":"query","required":true,"description":"Three-letter Incoterm","schema":{"type":"string"},"example":"CIF"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"incoterm":{"mode":"Sea and inland waterway","name":"Cost, Insurance and Freight","term":"CIF","group":"C","group_name":"Main carriage paid","description":"The seller covers transport and minimum insurance to the destination port. Under Incoterms 2020, the minimum insurance required is ICC (C). Risk transfers to the buyer once the goods are loaded onto the ship."}},"meta":{"timestamp":"2026-06-08T18:25:07.123Z","request_id":"59c3929c-52ef-4d89-ad80-1c3729a068d1"},"status":"ok","message":"Incoterm retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/group":{"get":{"operationId":"get_v1_group","tags":["Group"],"summary":"Terms in an Incoterms group","description":"","parameters":[{"name":"group","in":"query","required":true,"description":"Group letter: E, F, C or D","schema":{"type":"string"},"example":"C"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":4,"group":"C","incoterms":[{"mode":"Sea and inland waterway","name":"Cost and Freight","term":"CFR","group":"C","group_name":"Main carriage paid","description":"The seller covers transport costs to the destination port. Risk transfers to the buyer once the goods are loaded onto the ship."},{"mode":"Sea and inland waterway","name":"Cost, Insurance and Freight","term":"CIF","group":"C","group_name":"Main carriage paid","description":"The seller covers transport and minimum insurance to the destination port. Under Incoterms 2020, the minimum insurance required is ICC (C). Risk transfers to the buyer once the goods are loaded onto the ship."},{"mode":"Any mode of transport","name":"Carriage and Insurance Paid To","term":"CIP","group":"C","group_name":"Main carriage paid","description":"The seller covers transportation and insurance to the agreed destination. Under Incoterms 2020, the seller must provide insurance coverage at least equal to ICC (A) or an equivalent standard. Risk transfers to the buyer once the goods are handed over to the first carrier."},{"mode":"Any mode of transport","name":"Carriage Paid To","term":"CPT","group":"C","group_name":"Main carriage paid","description":"The seller pays for transportation to the agreed destination. Risk transfers to the buyer once the goods are handed over to the first carrier."}],"group_name":"Main carriage paid"},"meta":{"timestamp":"2026-06-08T18:25:07.246Z","request_id":"896896c6-544a-4d31-bc39-ab0205f6eb87"},"status":"ok","message":"Group retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/mode":{"get":{"operationId":"get_v1_mode","tags":["Mode"],"summary":"Terms by transport mode","description":"","parameters":[{"name":"mode","in":"query","required":true,"description":"'any' or 'sea'","schema":{"type":"string"},"example":"sea"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"mode":"Sea and inland waterway","count":4,"incoterms":[{"mode":"Sea and inland waterway","name":"Cost and Freight","term":"CFR","group":"C","group_name":"Main carriage paid","description":"The seller covers transport costs to the destination port. Risk transfers to the buyer once the goods are loaded onto the ship."},{"mode":"Sea and inland waterway","name":"Cost, Insurance and Freight","term":"CIF","group":"C","group_name":"Main carriage paid","description":"The seller covers transport and minimum insurance to the destination port. Under Incoterms 2020, the minimum insurance required is ICC (C). Risk transfers to the buyer once the goods are loaded onto the ship."},{"mode":"Sea and inland waterway","name":"Free Alongside Ship","term":"FAS","group":"F","group_name":"Main carriage unpaid","description":"The seller places the goods alongside the ship at the agreed port. The seller clears them for export, but the buyer covers loading costs and risks. Used for bulk and heavy-lift cargo, not containers."},{"mode":"Sea and inland waterway","name":"Free On Board","term":"FOB","group":"F","group_name":"Main carriage unpaid","description":"The seller loads the goods onto the ship at the agreed port, clearing them for export. Risk transfers to the buyer once the goods are on board."}]},"meta":{"timestamp":"2026-06-08T18:25:07.385Z","request_id":"1a5f617d-4dd3-4b74-a56a-998cb03911b9"},"status":"ok","message":"Mode retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["List"],"summary":"List all Incoterms","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"total":11,"incoterms":[{"mode":"Sea and inland waterway","name":"Cost and Freight","term":"CFR","group":"C","group_name":"Main carriage paid","description":"The seller covers transport costs to the destination port. Risk transfers to the buyer once the goods are loaded onto the ship."},{"mode":"Sea and inland waterway","name":"Cost, Insurance and Freight","term":"CIF","group":"C","group_name":"Main carriage paid","description":"The seller covers transport and minimum insurance to the destination port. Under Incoterms 2020, the minimum insurance required is ICC (C). Risk transfers to the buyer once the goods are loaded onto the ship."},{"mode":"Any mode of transport","name":"Carriage and Insurance Paid To","term":"CIP","group":"C","group_name":"Main carriage paid","description":"The seller covers transportation and insurance to the agreed destination. Under Incoterms 2020, the seller must provide insurance coverage at least equal to ICC (A) or an equivalent standard. Risk transfers to the buyer once the goods are handed over to the first carrier."},{"mode":"Any mode of transport","name":"Carriage Paid To","term":"CPT","group":"C","group_name":"Main carriage paid","description":"The seller pays for transportation to the agreed destination. Risk transfers to the buyer once the goods are handed over to the first carrier."},{"mode":"Any mode of transport","name":"Delivered at Place","term":"DAP","group":"D","group_name":"Arrival","description":"The seller delivers the goods to an agreed destination. The buyer covers import duties and unloading costs. The seller remains responsible until the goods are ready for unloading."},{"mode":"Any mode of transport","name":"Delivered Duty Paid","term":"DDP","group":"D","group_name":"Arrival","description":"The seller is responsible for delivering the goods to the named destination in the buyer’s country, including all costs involved."},{"mode":"Any mode of transport","name":"Delivered at Place Unloaded","term":"DPU","group":"D","group_name":"Arrival","description":"The seller pays for transport and unloading at the agreed destination. The buyer is responsible for import duties and further transport. (Replaces DAT from Incoterms 2010.)"},{"mode":"Any mode of transport","name":"Ex-Works","term":"EXW","group":"E","group_name":"Departure","description":"The seller makes the goods available at their premises. The buyer bears all risks, transportation costs, taxes, and duties from that point onwards. This term is commonly used for initial price quotations."},{"mode":"Sea and inland waterway","name":"Free Alongside Ship","term":"FAS","group":"F","group_name":"Main carriage unpaid","description":"The seller places the goods alongside the ship at the agreed port. The seller clears them for export, but the buyer covers loading costs and risks. Used for bulk and heavy-lift cargo, not containers."},{"mode":"Any mode of transport","name":"Free Carrier","term":"FCA","group":"F","group_name":"Main carriage unpaid","description":"The seller delivers the goods, cleared for export, to the buyer’s carrier at an agreed location. This term is suitable for multimodal transport, including containers."},{"mode":"Sea and inland waterway","name":"Free On Board","term":"FOB","group":"F","group_name":"Main carriage unpaid","description":"The seller loads the goods onto the ship at the agreed port, clearing them for export. Risk transfers to the buyer once the goods are on board."}]},"meta":{"timestamp":"2026-06-08T18:25:07.500Z","request_id":"54eae2d2-f9e6-44ff-8e72-4156aff517af"},"status":"ok","message":"Incoterms listed successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"groups":{"C":"Main carriage paid","D":"Arrival","E":"Departure","F":"Main carriage unpaid"},"service":"incoterms-api","endpoints":{"GET /v1/list":"List all Incoterms.","GET /v1/meta":"This document.","GET /v1/mode":"Terms by transport mode (mode=, 'any' or 'sea').","GET /v1/term":"Incoterm detail by three-letter term (term=, e.g. CIF).","GET /v1/group":"Terms in an Incoterms group (group=, E / F / C / D)."},"description":"ICC Incoterms (international commercial terms): three-letter term, full name, plain-language description, official group (E/F/C/D) and transport mode. Look up a term, list a group, filter by mode, or list them all. The reference a checkout, ERP, freight or trade-finance system needs. No key.","total_terms":11},"meta":{"timestamp":"2026-06-08T18:25:07.612Z","request_id":"b8d77ad4-3896-478b-b0f2-9cca23b4218c"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":10000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":500,"monthly_call_quota":110000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1400,"monthly_call_quota":550000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3400,"monthly_call_quota":2800000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/incoterms-api"}