gtlds
Data reference

The data, without
the interface.

The public site is generated from static data. This page documents the shape of that data, the fields the interface expects, and the authoritative sources each production field should resolve back to.

Download fixture JSONRead methodology
01Data products

Small files with obvious jobs.

tlds.jsonCurrent frontend fixture · canonical TLD records used by Browse, Operators and global search.JSON
search-index.jsonProduction target · compact precomputed fields for instant client-side search.planned
source-manifest.jsonProduction target · source URLs, fetch times, hashes and ingestion metadata.planned
02Canonical schema

One TLD record, explicit layers.

The fixture is deliberately smaller than the final schema. Production records should expand into nested source-specific sections rather than collapsing unrelated authorities into one convenient object.

gtld-record.jsonproposed production shape
{
  "label": "xyz",
  "display_label": ".xyz",
  "idn": {
    "is_idn": false,
    "a_label": "xyz",
    "u_label": null
  },
  "delegation": {
    "currently_delegated": true,
    "iana_type": "generic",
    "sponsoring_organisation": "…",
    "registration_date": "…"
  },
  "registry": {
    "website": "…",
    "rdap": "…",
    "whois": "…"
  },
  "icann": {
    "agreement_status": "active",
    "spec_13_brand": false,
    "spec_12_community": false
  },
  "provenance": {
    "iana_root_database": "…",
    "icann_registry_agreement": "…"
  }
}
03Field dictionary

Fields should say what they mean, not more.

FieldMeaningPrimary authority
label

ASCII protocol-safe TLD label without the leading dot.

IANA / root
display_label

Human-facing label, including native Unicode where applicable.

IANA + IDNA normalization
currently_delegated

Whether the label is present in the current delegated top-level namespace.

IANA
iana_type

The classification attached to the IANA root-zone record.

IANA
sponsoring_organisation

The sponsoring organisation in the IANA record.

IANA
agreement_status

Status of the applicable ICANN registry agreement record.

ICANN
spec_13_brand

Whether the agreement material explicitly supports the Specification 13 brand attribute.

ICANN
dnssec_ds_present

Whether DS material is present for the TLD in authoritative root data.

Root DNS / IANA
04Source coverage

Production data should carry its receipts.

IANA Root Zone Databaseidentity · classification · delegation record Delegated TLD listcurrent delegation membership RDAP bootstrapRDAP service mapping ICANN Registry Agreementscontract records · explicit specifications
Source terms still apply.

This site can document where data comes from; it should not invent licensing permissions on behalf of IANA, ICANN, registries, or other source providers.

Implementation contract

The interface can change. The meaning of the fields should not.

Methodology