URN namespace
urn:via: namespaceA urn:via: name is a persistent name for a government
body or the jurisdiction it governs. UnGovr assigns the names, publishes the full list as
open data, and runs a public resolver for them.
Each name is assigned to one government body or jurisdiction: a country, a state or province, a county, a city or town, a special district, a school district, a court, an agency, an elected office, or an international organization.
| Name | Names |
|---|---|
urn:via:ie | Ireland |
urn:via:eu | the European Union |
urn:via:us/ca | the State of California |
urn:via:us/ny/city/new-york | the City of New York |
Names identify public bodies and offices, never people. The name of an office, such as a county sheriff, names the office and not the person who holds it. A name carries no secret and proves nothing about whoever presents it: it is a reference, not a credential.
Using, storing, comparing or resolving a name needs no account, permission or fee.
After urn:via:, a name is a path of one or more segments separated
by slashes. In the ABNF of RFC 5234, where ALPHA and DIGIT are as defined there:
NSS = segment *( "/" segment ) segment = 1*( ALPHA / DIGIT / "-" )
So a segment holds only ASCII letters, digits and hyphens. Names contain no percent-encoded characters, and no other characters.
Case does not matter. On top of the equivalence rules of RFC 8141,
the part after urn:via: is compared without regard to case, by
mapping ASCII letters to lower case before comparing. The canonical form of a name is all
lower case, and UnGovr assigns and publishes names only in that form. As a regular
expression, the canonical form of the part after urn:via: is:
^[a-z0-9-]+(?:/[a-z0-9-]+)*$
Case folding is the only equivalence rule this namespace adds, so two names that differ in anything but case are different names. A former name and the current name of the same body are different names too; to learn whether two names refer to the same body, resolve both.
The first segment is usually a country's ISO 3166-1 alpha-2 code in lower case, or the short name of an international organization.
Do not read meaning from a name's shape. Software MUST NOT infer a body's type, level, parent or country from the shape of its name. A name can be shorter or longer than the body's place in a hierarchy suggests, and some bodies are placed under a parent for convenience. Read those facts from the record the name resolves to.
No r-component, q-component or f-component semantics are defined. A resolver ignores them.
Anyone may report a missing or wrong body to UnGovr.
UnGovr runs a public resolver: a web page at
https://ungovr.org/urn and a JSON API at
https://ungovr.org/api/urn/resolve?q=<name>. Both are served only over
HTTPS.
Given a name, the resolver returns the canonical name, the body's name and type, a link to a public page about the body, and the body's other public identifiers where UnGovr holds them, such as its ISO 3166 code, Wikidata item, US FIPS code and Census GEOID. Given a former name, it returns the name it now resolves to. It also answers a query by any of those other identifiers.
For most names the body's public page is https://ungovr.org/ followed by the
part after urn:via:, for example
https://ungovr.org/us/ny/city/new-york.
The resolver's answer always carries the page's address, so read it from there rather
than building it.
Anyone may run another resolver from the published list. UnGovr does not certify other resolvers.
urn:ungovr:Before this namespace, UnGovr published the same names under the prefix
urn:ungovr:, and in a short form beginning
ungovr:. No new names are issued in either form. Names
written either way keep resolving to the same bodies, and the resolver answers with the
urn:via: form: urn:ungovr:us/ca resolves to
urn:via:us/ca.
UnGovr publishes the full list, with every former name and the name each now resolves
to, so that another organization could continue resolution if UnGovr could not. The index
of the names files is
https://data.ungovr.org/v1/names/index.json.
There is one file per country, names/<cc>.jsonl, and each line of a
file is one current, former or contested name.
The list is published under the Creative Commons Attribution 4.0 license (CC BY 4.0): https://www.ungovr.org/open-data/license. More of UnGovr's open data is at https://ungovr.org/open-data.
Last revised November 18, 2026.