⚠️
View All

URN namespace

The urn:via: namespace

A 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.

Resolve a name

What a name names

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.

NameNames
urn:via:ieIreland
urn:via:euthe European Union
urn:via:us/cathe State of California
urn:via:us/ny/city/new-yorkthe 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.

Syntax

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.

Assignment

  • UnGovr assigns every name. There is no delegation.
  • A name is assigned when a body is added to UnGovr's list, and is formed from the body's place in the hierarchy and its name.
  • Before a name is assigned, it is checked against every name UnGovr has ever assigned, current or former, so no name is assigned twice.
  • A name, once assigned, is never assigned to another body.
  • When a body's name changes, UnGovr may assign a new name, and the old name keeps resolving to the same body.
  • When two records turn out to be one body, the name of the retired record resolves to the one that remains.
  • A body that is dissolved keeps its name, and its record says it was dissolved.
  • If a name turns out to have been given to one body when another body could equally claim it, the name resolves to the list of bodies it may mean rather than to one of them.

Anyone may report a missing or wrong body to UnGovr.

Resolution

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.

Names written as 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.

The list as open data

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.