Skip to content
GET /v1/mode

Terms by transport mode

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/incoterms-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/incoterms-api/v1/mode" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/incoterms-api/v1/mode", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/incoterms-api/v1/mode");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/incoterms-api/v1/mode",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "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
}