Api Endpoint

NUTS Region Lookup (EU)

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.

Open interactive test console

Offering

Provider
api.duoleads.com
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Location And Travel
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.duoleads.com/v1/ref/nuts
MIME type
application/json
First seen
2026-10-16T01:50:38.788Z
Last seen
Tags
nuts, nuts-region, eu-regions, eu, statistics

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.05 USDC
Atomic price: 50000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "50000",
    "payTo": "0xCD673f7e1daD254347AEab6be0DEFe8b9C6b3A39"
  }
]

Observed health

Status
Healthy
Latest latency
129 ms
Average latency
2059 ms
HTTP status
402
Last checked
Reachability
92.3% over 13 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "description": "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.",
          "pattern": "^[A-Za-z]{2}[0-9A-Za-z]{0,3}$",
          "maxLength": 16
        },
        "name": {
          "type": "string",
          "description": "Substring search on region names, case- and accent-insensitive. Up to 25 matches.",
          "maxLength": 128
        },
        "level": {
          "type": "string",
          "description": "Restrict a name search to one level, 0-3.",
          "pattern": "^[+-]?\\d+$",
          "maxLength": 64
        },
        "country": {
          "type": "string",
          "description": "ISO 3166-1 alpha-2 country filter (UK/GB and EL/GR both accepted).",
          "maxLength": 16
        },
        "include": {
          "type": "string",
          "description": "Comma-separated: parents, children, typology. Default parents,typology.",
          "maxLength": 64,
          "default": "parents,typology"
        }
      },
      "required": []
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "code": {
              "description": "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.",
              "maxLength": 16,
              "pattern": "^[A-Za-z]{2}[0-9A-Za-z]{0,3}$",
              "type": "string"
            },
            "country": {
              "description": "ISO 3166-1 alpha-2 country filter (UK/GB and EL/GR both accepted).",
              "maxLength": 16,
              "type": "string"
            },
            "include": {
              "default": "parents,typology",
              "description": "Comma-separated: parents, children, typology. Default parents,typology.",
              "maxLength": 64,
              "type": "string"
            },
            "level": {
              "description": "Restrict a name search to one level, 0-3.",
              "maxLength": 64,
              "pattern": "^[+-]?\\d+$",
              "type": "string"
            },
            "name": {
              "description": "Substring search on region names, case- and accent-insensitive. Up to 25 matches.",
              "maxLength": 128,
              "type": "string"
            }
          },
          "required": [],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "data": {
              "properties": {
                "canonical_country": {
                  "type": "string"
                },
                "children": {
                  "items": {
                    "properties": {
                      "code": {
                        "type": "string"
                      },
                      "level": {
                        "type": "integer"
                      },
                      "name_latn": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "code",
                      "level",
                      "name_latn"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "code": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                },
                "found": {
                  "type": "boolean"
                },
                "input_code": {
                  "type": "string"
                },
                "level": {
                  "type": "integer"
                },
                "matches": {
                  "items": {
                    "properties": {
                      "code": {
                        "type": "string"
                      },
                      "country": {
                        "type": "string"
                      },
                      "level": {
                        "type": "integer"
                      },
                      "name_latn": {
                        "type": "string"
                      },
                      "name_local": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "code",
                      "level",
                      "country",
                      "name_latn",
                      "name_local"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "name_latn": {
                  "type": "string"
                },
                "name_local": {
                  "type": "string"
                },
                "parents": {
                  "items": {
                    "properties": {
                      "code": {
                        "type": "string"
                      },
                      "level": {
                        "type": "integer"
                      },
                      "name_latn": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "code",
                      "level",
                      "name_latn"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "total_matches": {
                  "type": "integer"
                },
                "typology": {
                  "properties": {
                    "coastal": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "coastal_label": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "mountain": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "mountain_label": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "urban": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "urban_label": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "urban",
                    "urban_label",
                    "coastal",
                    "coastal_label",
                    "mountain",
                    "mountain_label"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "found"
              ],
              "type": "object"
            },
            "meta": {
              "properties": {
                "computed_at": {
                  "description": "RFC 3339 UTC with milliseconds",
                  "type": "string"
                },
                "deterministic": {
                  "type": "boolean"
                },
                "disclaimer": {
                  "type": "string"
                },
                "price_usd": {
                  "type": "string"
                },
                "request_id": {
                  "type": "string"
                },
                "sources": {
                  "items": {
                    "required": [
                      "id",
                      "version",
                      "published"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                }
              },
              "required": [
                "request_id",
                "computed_at",
                "price_usd",
                "deterministic",
                "disclaimer"
              ],
              "type": "object"
            },
            "ok": {
              "const": true
            },
            "route": {
              "const": "/v1/ref/nuts"
            },
            "version": {
              "type": "string"
            }
          },
          "required": [
            "ok",
            "route",
            "version",
            "data",
            "meta"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}