Output formats

The domain info and weekly changes files are in the JSON Lines (.jsonl) format — one JSON record per line. The domain names file is a single-column CSV (.csv) with a domainName header line. All data feed files are compressed with zstd (Zstandard).

Domain info files

  • Data included: one enriched domain registration record per domain. If a field is redacted or missing in the current WHOIS or RDAP record, it is filled in with the most recent value available in historical WHOIS records.
  • Filename format: domain_info.%date%.weekly.jsonl.zst
  • Sample: domain_info.sample.weekly.jsonl.zst

Each record consists of the domain name, the data section with the domain’s registration fields, and five contact sections. Every field is an object carrying the field value, the date it was last confirmed by our system, and a flag showing whether the value was restored from historical records because it is empty or redacted in the current live record.

{
  "domainName": "example.com",
  "data": [
    {"fieldName": "createdDateISO8601", "fieldValue": "2013-07-22T00:00:00+00:00", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateISO8601", "fieldValue": "2013-07-22T00:00:00+00:00", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateISO8601", "fieldValue": "2026-03-22T20:15:53+00:00", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "createdDateRaw", "fieldValue": "2013-07-22", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateRaw", "fieldValue": "2013-07-22", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateRaw", "fieldValue": "2026-03-22T20:15:53.197Z", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "nameServers", "fieldValue": "ns1.example.com|ns2.example.com", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "whoisServer", "fieldValue": "whois.example-registrar.com", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "registrarName", "fieldValue": "Example Registrar, Inc.", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "status", "fieldValue": "clientTransferProhibited", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false}
  ],
  "registrantContact": [
    {"fieldName": "name", "fieldValue": "John Doe", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "organization", "fieldValue": "Example Inc.", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "street", "fieldValue": "123 Example Street", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "city", "fieldValue": "Jacksonville", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "state", "fieldValue": "FL", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "postalCode", "fieldValue": "32256", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "country", "fieldValue": "UNITED STATES", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "email", "fieldValue": "[email protected]", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "telephone", "fieldValue": "13105551234", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "telephoneExt", "fieldValue": "", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "fax", "fieldValue": "", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "faxExt", "fieldValue": "", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true}
  ],
  "administrativeContact": [ ... ],
  "technicalContact": [ ... ],
  "billingContact": [ ... ],
  "zoneContact": [ ... ]
}

Record structure

domainName

The associated domain name.

data

The domain’s registration record fields (dates, name servers, registrar, status). An array of field objects (see “Field object structure” below).

registrantContact

Contains registrant contact information. An array of field objects.

administrativeContact

Contains administrative contact information. The structure is the same as for the registrantContact field.

technicalContact

Contains technical contact information. The structure is the same as for the registrantContact field.

billingContact

Contains billing contact information. The structure is the same as for the registrantContact field.

zoneContact

Contains zone contact information. The structure is the same as for the registrantContact field.

Field object structure

Every field in the data and contact sections is an object with the following keys:

fieldName

The name of the field (see the field lists below).

fieldValue

The most informative value available for the field. Taken from the current WHOIS/RDAP record when defined there; otherwise restored from the most recent historical WHOIS record that contained it. An empty string or null if no value has ever been captured.

auditDate

The date the field’s value was last confirmed or captured by our system, in ISO 8601 format.

isEmptyOrRedactedNow

true if the field is empty or redacted in the current live record — meaning the value shown was restored from historical WHOIS data. false if the value comes from the current record.

Fields of the data section

createdDateISO8601

The date the domain was registered, in ISO 8601 format.

updatedDateISO8601

The date the domain’s registration record was last updated, in ISO 8601 format.

expiresDateISO8601

The date the domain’s registration expires, in ISO 8601 format.

createdDateRaw

The date the WHOIS record for the domain was created initially, in raw format.

updatedDateRaw

The last date the WHOIS record for the domain was updated, in raw format.

expiresDateRaw

The date the WHOIS record for the domain is expired, in raw format.

nameServers

The domain’s name servers, separated by "|".

whoisServer

The WHOIS server the record was collected from.

registrarName

Registrar name

status

Fields of the contact sections

All five contact sections (registrantContact, administrativeContact, technicalContact, billingContact, zoneContact) share the same field list:

name

The contact’s name.

organization

The contact’s organization.

street

The contact’s street address.

city

The contact’s city.

state

The contact’s state or region.

postalCode

The contact’s postal code.

country

The contact’s country.

email

The contact’s email address.

telephone

The contact’s telephone number.

telephoneExt

The contact’s telephone extension.

fax

The contact’s fax number.

faxExt

The contact’s fax extension.

Domain names files

  • Data included: the full list of domain names covered by the data feed, without their registration records.
  • Filename format: domain_names.%date%.weekly.csv.zst
  • Filename example: domain_names.2026-07-13.weekly.csv.zst
  • Sample: domain_names.sample.weekly.csv.zst
  • Format: single-column CSV — a domainName header line followed by one domain name per line.
domainName
example.com
example.net
example.org
...

Weekly changes files

  • Data included: the domains whose records were added or updated during the week.
  • Filename format: domain_info.%date%.weekly.diff.jsonl.zst
  • Filename example: domain_info.2026-07-13.weekly.diff.jsonl.zst
  • Sample: domain_info.sample.weekly.diff.jsonl.zst

Each line is a record with the same structure as in the domain info files (the data section and the five contact sections), preceded by two keys: changeType, which tells why the domain is present in the file, and domainName.

{
  "changeType": "updated",
  "domainName": "example.com",
  "data": [
    {"fieldName": "createdDateISO8601", "fieldValue": "2024-08-19T18:26:12+00:00", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateISO8601", "fieldValue": "2025-09-26T07:58:15+00:00", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateISO8601", "fieldValue": "2026-08-19T18:26:12+00:00", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "createdDateRaw", "fieldValue": "2024-08-19T18:26:12Z", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateRaw", "fieldValue": "2025-09-26T07:58:15Z", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateRaw", "fieldValue": "2026-08-19T18:26:12Z", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "nameServers", "fieldValue": "ns1.example.com|ns2.example.com", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "whoisServer", "fieldValue": "whois.example-registrar.com", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "registrarName", "fieldValue": "Example Registrar, Inc.", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "status", "fieldValue": "clientTransferProhibited", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false}
  ],
  "registrantContact": [
    {"fieldName": "name", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "organization", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "street", "fieldValue": "123 Example Street", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "city", "fieldValue": "Jacksonville", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "state", "fieldValue": "FL", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "postalCode", "fieldValue": "32256", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "country", "fieldValue": "UNITED STATES", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "email", "fieldValue": "[email protected]", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "telephone", "fieldValue": "13105551234", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "telephoneExt", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "fax", "fieldValue": "13105555678", "auditDate": "2024-07-02T21:01:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "faxExt", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false}
  ],
  "administrativeContact": [ ... ],
  "technicalContact": [ ... ],
  "billingContact": [ ... ],
  "zoneContact": [
    {"fieldName": "name", "fieldValue": null, "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": true},
    ...
  ]
}

Output field description

changeType

Why the domain appears in this week’s changes file. One of:

  • added — the domain was seen for the first time during this week.
  • updated — the domain was already known before this week, and its record changed during it.
domainName

The associated domain name.

data,
registrantContact,
administrativeContact,
technicalContact,
billingContact,
zoneContact

Same as in the domain info files — see “Record structure” and “Field object structure” above. A field that is absent from the current live record and has no historical value has a null fieldValue with isEmptyOrRedactedNow set to true.