---
title: "INCOTERMS 2020 Lookup"
method: GET
path: "/api/incoterms"
tags: ["Reference Data"]
---

# INCOTERMS 2020 Lookup

`GET /api/incoterms`

## Request

- Base URL: `https://www.freightutils.com`
- URL: `https://www.freightutils.com/api/incoterms`
- Auth: none declared

Look up INCOTERMS 2020 rules by code or filter by category. Returns detailed responsibility breakdowns for each term. When called with a specific code, returns a single detailed object. When called without a code, returns all terms.

## Query parameters

- `code` string
- `category` 'any_mode' | 'sea_only'
- `view` 'summary'
- `offset` integer
- `limit` integer

## Response `200`

INCOTERMS data. Returns a single Incoterm object when queried by code, or a list when browsing.

- union
  - IncotermDetail
    - `code` string, required: INCOTERM code.
    - `name` string, required: Full INCOTERM name.
    - `slug` string, required: URL-friendly identifier.
    - `category` 'any_mode' | 'sea_only', required: Transport mode category.
    - `summary` string, required: Brief summary of the term.
    - `seller_responsibility` string, required: What the seller is responsible for.
    - `buyer_responsibility` string, required: What the buyer is responsible for.
    - `risk_transfer` string, required: Point at which risk transfers from seller to buyer.
    - `cost_transfer` string, required: Point at which cost responsibility transfers.
    - `insurance` string, required: Insurance obligations.
    - `export_clearance` string, required: Who handles export customs clearance.
    - `import_clearance` string, required: Who handles import customs clearance.
    - `best_for` string, required: Scenarios this term is best suited for.
    - `watch_out` string, required: Common pitfalls or things to be aware of.
  - IncotermsListResponse
    - `count` integer, required: Number of INCOTERMS returned.
    - `results` IncotermDetail[], required
      - `code` string, required: INCOTERM code.
      - `name` string, required: Full INCOTERM name.
      - `slug` string, required: URL-friendly identifier.
      - `category` 'any_mode' | 'sea_only', required: Transport mode category.
      - `summary` string, required: Brief summary of the term.
      - `seller_responsibility` string, required: What the seller is responsible for.
      - `buyer_responsibility` string, required: What the buyer is responsible for.
      - `risk_transfer` string, required: Point at which risk transfers from seller to buyer.
      - `cost_transfer` string, required: Point at which cost responsibility transfers.
      - `insurance` string, required: Insurance obligations.
      - `export_clearance` string, required: Who handles export customs clearance.
      - `import_clearance` string, required: Who handles import customs clearance.
      - `best_for` string, required: Scenarios this term is best suited for.
      - `watch_out` string, required: Common pitfalls or things to be aware of.
    - `_source` SourceEnvelope: Additive provenance citation for the dataset or method behind this response, from FreightUtils' single provenance source of truth. Shapes: reference, methodology (calculators), or reference with provenance_status:'pending-verification'. Fields appear only when a real value exists.
      - `type` 'reference' | 'methodology', required
      - `authority` string
      - `dataset` string
      - `source_url` string
      - `data_vintage` string
      - `licence` string
      - `retrieved_via` string
      - `standard` string
      - `reference` string
      - `computed_by` string
      - `provenance_status` 'pending-verification'
      - `dataset_edition` string: Edition this response is served from (editioned reference datasets only), e.g. 'UN/LOCODE 2025-1'.
      - `authority_current_edition` string: The authority's current in-force edition at the last check. Differs from dataset_edition only when the served data lags the authority.
      - `checked_at` string: YYYY-MM-DD of the last served-vs-authority edition comparison (on-demand checker, staleness-guarded).

## Other responses

- `400`: Invalid or missing parameters.

---

[API](https://skmtc.dev/freightutils/apis/freightutils-api.md) · [All operations](https://skmtc.dev/freightutils/apis/freightutils-api/llms.txt) · [OpenAPI document](https://skmtc.dev/freightutils/apis/freightutils-api/revisions/6607bb3cea90?raw)