deterministic
no-api-key
ref
eu
statistics
regions

NUTS region lookup: EU statistical region codes, names and hierarchy

NUTS region lookup (EU statistical regions): resolve a NUTS code to its name, country and level, walk up to its parents or down to its children, or search regions by name. Covers all four levels (country, major region, basic region, small region) for the 27 member states and 12 further reporting countries, from the NUTS 2024 classification. Returns the Latin-script and local-language names plus the urbanisation, coastal and mountain typologies.

Output (data): found, code, level, country, name_latn, name_local, parents [{code, level, name_latn}] from level 0 down to the parent, children [{code, level, name_latn}] (direct children, sorted by code; only when include has children), typology {urban, urban_label, coastal, coastal_label, mountain, mountain_label} (codes are Eurostat typology codes as strings, null where unclassified; labels follow Eurostat's published typology definitions). Keys not named in include are omitted. A name search returns matches [{code, level, country, name_latn, name_local}] (exact name first, then by level and code) plus total_matches. NUTS uses EL and UK for Greece and the United Kingdom; country and the code prefix accept GR and GB as aliases; found responses carry canonical_country (the NUTS spelling, EL or UK for those two) and input_code (the alias as sent) when an alias was mapped.

Deterministic: identical input returns identical output, so the response is served with Cache-Control: private, max-age=31536000, immutable (the paying client may cache it indefinitely; shared caches must not, because the response is paid).

Sources: eurostat-nuts NUTS 2024 (published 2026-09-28, CC BY 4.0). Echoed in meta.sources.

Price: $0.05 USDC per call (x402, Base). Route contract version 1.0.0. Docs: https://api.duoleads.com/docs#ref-nuts

get/v1/ref/nuts

Request

  • Base URL: https://api.duoleads.com
  • URL: https://api.duoleads.com/v1/ref/nuts
  • Auth: none declared

Query parameters

codestring

NUTS code, 2-5 characters, case-insensitive (level-3 codes may contain letters, e.g. NL32B). A GR or GB prefix is accepted for EL or UK. Accepted: 2 to 5 characters matching ^[A-Z]{2}[0-9A-Z]{0,3}$.

namestring

Substring search on region names, case- and accent-insensitive. Up to 25 matches. Accepted: at most 128 characters.

levelinteger

Restrict a name search to one level, 0-3. Accepted: integer 0-3.

countrystring

ISO 3166-1 alpha-2 country filter (UK/GB and EL/GR both accepted). Accepted: an ISO 3166-1 alpha-2 code.

includestring

Comma-separated: parents, children, typology. Default parents,typology. Accepted: comma-separated subset of parents, children, typology.

Response

Paid and settled. data is route-specific; a route that judges its input returns 200 with data.valid: false for a bad value.

okunknown required
route'/v1/ref/nuts' required
version'1.0.0' required

Changes

No recorded changes to this operation across all 1 revision of this API.