{"uid":"cap_v9q1vSJu4a62Nn8bbE3nh","slug":"duo-data-utilities-nuts-region-lookup-0c40ce5f","name":"Duo Data Utilities – NUTS Region Lookup","description":"Look up a NUTS statistical region of the European Union: 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.","url":"https://api.duoleads.com/v1/ref/nuts?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"code":{"type":"string","pattern":"^[A-Za-z]{2}[0-9A-Za-z]{0,3}$","maxLength":16,"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."},"name":{"type":"string","maxLength":128,"description":"Substring search on region names, case- and accent-insensitive. Up to 25 matches."},"level":{"type":"string","pattern":"^[+-]?\\d+$","maxLength":64,"description":"Restrict a name search to one level, 0-3."},"country":{"type":"string","maxLength":16,"description":"ISO 3166-1 alpha-2 country filter (UK/GB and EL/GR both accepted)."},"include":{"type":"string","default":"parents,typology","maxLength":64,"description":"Comma-separated: parents, children, typology. Default parents,typology."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","route","version","data","meta"],"properties":{"ok":{"const":true},"data":{"type":"object","required":["found"],"properties":{"code":{"type":"string"},"found":{"type":"boolean"},"level":{"type":"integer"},"country":{"type":"string"},"matches":{"type":"array","items":{"type":"object","required":["code","level","country","name_latn","name_local"],"properties":{"code":{"type":"string"},"level":{"type":"integer"},"country":{"type":"string"},"name_latn":{"type":"string"},"name_local":{"type":"string"}}}},"parents":{"type":"array","items":{"type":"object","required":["code","level","name_latn"],"properties":{"code":{"type":"string"},"level":{"type":"integer"},"name_latn":{"type":"string"}}}},"children":{"type":"array","items":{"type":"object","required":["code","level","name_latn"],"properties":{"code":{"type":"string"},"level":{"type":"integer"},"name_latn":{"type":"string"}}}},"typology":{"type":"object","required":["urban","urban_label","coastal","coastal_label","mountain","mountain_label"],"properties":{"urban":{"type":["string","null"]},"coastal":{"type":["string","null"]},"mountain":{"type":["string","null"]},"urban_label":{"type":["string","null"]},"coastal_label":{"type":["string","null"]},"mountain_label":{"type":["string","null"]}}},"name_latn":{"type":"string"},"input_code":{"type":"string"},"name_local":{"type":"string"},"total_matches":{"type":"integer"},"canonical_country":{"type":"string"}}},"meta":{"type":"object","required":["request_id","computed_at","price_usd","deterministic","disclaimer"],"properties":{"sources":{"type":"array","items":{"type":"object","required":["id","version","published"]}},"price_usd":{"type":"string"},"disclaimer":{"type":"string"},"request_id":{"type":"string"},"computed_at":{"type":"string","description":"RFC 3339 UTC with milliseconds"},"deterministic":{"type":"boolean"}}},"route":{"const":"/v1/ref/nuts"},"version":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"code":"NL32B","found":true,"level":3,"country":"NL","parents":[{"code":"NL","level":0,"name_latn":"Nederland"},{"code":"NL3","level":1,"name_latn":"West-Nederland"},{"code":"NL32","level":2,"name_latn":"Noord-Holland"}],"typology":{"urban":"1","coastal":"1","mountain":"4","urban_label":"predominantly urban","coastal_label":"coastal","mountain_label":"non-mountain region"},"name_latn":"Groot-Amsterdam","name_local":"Groot-Amsterdam"},"meta":{"sources":[{"id":"eurostat-nuts","licence":"CC BY 4.0","version":"NUTS 2024","published":"2026-09-28","attribution":"© European Union, Eurostat/GISCO"}],"price_usd":"0.05","disclaimer":"Factual output of a deterministic computation over public data. Provided as is, with no warranty of accuracy, completeness or availability. Not investment, financial, legal, tax, medical or any other professional advice, and not a recommendation. Verify before relying on it. Terms: https://api.duoleads.com/terms","request_id":"01K6B7Q4ZC8H3F2M9WXR5TYN0D","computed_at":"2026-09-28T12:00:00.000Z","deterministic":true},"route":"/v1/ref/nuts","version":"1.0.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ORwUHdMfSMrHCqfOfotDB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up, search, and traverse European NUTS statistical regions by code or name, returning names, hierarchy, and typologies from the NUTS 2024 classification.","exampleAgentPrompt":"What is NUTS code NL32B — what's its name, which country is it in, what level is it, and can you show me its parent regions and whether it's coastal or urban?","exampleUseCases":[{"title":"Enriching regional data with NUTS hierarchy","prompt":"I have a dataset with NUTS codes like DE212 and FR101 — can you resolve each one to its full name, country, level, and parent regions so I can add that context to my table?"},{"title":"Searching for regions by name for a report","prompt":"I'm building a report on regions in Poland — can you search for all NUTS regions whose names contain 'Mazow' and tell me what level they're at and their NUTS codes?"},{"title":"Checking typology for location eligibility","prompt":"I need to know if the NUTS region ITF32 qualifies as a mountain region and whether it's coastal — can you pull its typology and also show me its parent regions?"}],"resultDescription":"A JSON object containing the matched NUTS region's code, level, country ISO code, Latin-script name, local-language name, parent regions (each with code, level, and Latin name), optional child regions, and typology flags for urbanisation (with label), coastal status (with label), and mountain classification (with label). Also includes metadata: request ID, computation timestamp, data source attribution (Eurostat NUTS 2024, CC BY 4.0), and price.","failureModes":["Invalid NUTS code format returns an error (code must match ^[A-Za-z]{2}[0-9A-Za-z]{0,3}$)","Code not found in NUTS 2024 classification returns found:false","Name search with no matches returns empty results array","Overly broad name search returns at most 25 matches (results may be truncated)","Invalid country code (not ISO 3166-1 alpha-2) may return no results","Missing both 'code' and 'name' parameters returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need authoritative NUTS 2024 classification data for EU and associated reporting countries — specifically for resolving codes to names, navigating the four-level hierarchy (country → major region → basic region → small region), or searching regions by name. Prefer this over generic geocoding or administrative boundary APIs when you specifically need Eurostat NUTS codes with typologies (urbanisation, coastal, mountain) for statistical or policy analysis purposes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:21.570Z","isFirstParty":false,"canonicalSlug":"duo-data-utilities-nuts-region-lookup-0c40ce5f"}