NUTS

GET/v0/nuts

Validates a NUTS (Nomenclature of Territorial Units for Statistics) code — the hierarchical system used by the EU to divide its territory into regions for statistical purposes. Codes consist of a 2-letter country code followed by 0-3 alphanumeric characters indicating the regional level (NUTS 0 = country, NUTS 1 = major regions, NUTS 2 = basic regions, NUTS 3 = small regions). The endpoint validates format and country code, and returns the region name when known (NUTS 2021 classification). Spaces and hyphens are stripped automatically.

Try it

Query Parameters

Parameter	Type	Required	Description
value	string	Yes	The 2-5 character NUTS code (e.g. `PL21`, `DE`, `ES51`)

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/nuts?value=PL21"

Response Fields

Field	Type	Description
valid	boolean	Whether the code has valid NUTS format and country
code	string	The normalized NUTS code (uppercase)
level	number	NUTS level (0 = country, 1 = major region, 2 = basic region, 3 = small region)
country	string	2-letter country code
countryName	string \| null	Country name
regionName	string \| null	Region name (null if not in the built-in database)

Example Response — NUTS 2

{
  "valid": true,
  "code": "PL21",
  "level": 2,
  "country": "PL",
  "countryName": "Polska",
  "regionName": "Małopolskie"
}

Example Response — NUTS 0

{
  "valid": true,
  "code": "DE",
  "level": 0,
  "country": "DE",
  "countryName": "Deutschland",
  "regionName": "Deutschland"
}

Example Response — NUTS 1

{
  "valid": true,
  "code": "UKI",
  "level": 1,
  "country": "UK",
  "countryName": "United Kingdom",
  "regionName": "London"
}

Example Response — invalid

{
  "valid": false
}