RDDSRecord

Registration data for a taken domain, normalised across RDAP and WHOIS. source names the protocol that produced the record; RDAP records carry the full directory metadata (notices, links, conformance), while WHOIS records populate the subset they can and leave those empty. Contact fields are reproduced verbatim; a withheld field is reported through the entity's redacted flag and remarks, with redaction giving the registry's a-priori posture.

  • object
    Type: string

    Resource type identifier.

  • domain
    Type: string

    Registry ldhName (A-label / punycode form) of the domain.

  • unicode_name
    Type: string

    U-label (Unicode) form when the registry supplies it.

  • handle
    Type: string

    Registry's opaque domain object identifier.

  • source
    Type: string

    Protocol that produced this record: "rdap" or "whois".

  • redaction
    Type: string

    Registry redaction posture: "none", "gdpr", or "registry_specific".

  • privacy_proxy_allowed
    Type: boolean

    Whether the registry permits a registrar privacy/proxy service for this TLD.

  • partial
    Type: boolean

    Whether a WHOIS response could not be fully parsed; always false for RDAP.

  • statuses
    Type: array string[]

    EPP/RDAP status strings, e.g. "clientTransferProhibited".

  • registrar
    Type: object · RDDSRegistrar

    Registrar of record with abuse contact, derived from the registrar entity.

    Registrar of record with abuse contact.

    • object
      Type: string

      Resource type identifier.

    • name
      Type: string

      Registrar name.

    • iana_id
      Type: string

      IANA registrar id from the registrar entity's public identifiers.

    • url
      Type: string

      Registrar website URL.

    • abuse_email
      Type: string

      Abuse contact email from the nested abuse entity.

    • abuse_phone
      Type: string

      Abuse contact phone from the nested abuse entity.

  • entities
    Type: array object[] · RDDSEntity[]

    Parties associated with the domain, keyed by role, nesting preserved.

    A party associated with the domain (registrant, technical, abuse, registrar, ...). A withheld field is reported through redacted and remarks; the scalar fields carry whatever the source published, verbatim.

    • object
      Type: string

      Resource type identifier.

    • roles
      Type: array string[]

      Roles this entity holds, e.g. ["registrant"] or ["registrar"].

    • handle
      Type: string

      Registry handle for the entity.

    • name
      Type: string

      Contact name.

    • organization
      Type: string

      Contact organization.

    • email
      Type: string

      Contact email.

    • phone
      Type: string

      Contact phone.

    • address
      Type: array string[]

      Postal address lines.

    • contact_uri
      Type: string

      Contact URI when the source publishes one instead of inline fields.

    • redacted
      Type: boolean

      Whether one or more of this entity's fields were withheld at the source.

    • remarks
      Type: array object[] · RDDSNotice[]

      Object-level remarks explaining any withholding.

      A notice or remark: title, free-text description, and links.

    • events
      Type: array object[] · RDDSEvent[]

      Entity-scoped events.

      A lifecycle event (registration, expiration, last changed, ...).

    • entities
      Type: array object[] · RDDSEntity[]

      Nested entities, e.g. the abuse contact under a registrar.

      A party associated with the domain (registrant, technical, abuse, registrar, ...). A withheld field is reported through redacted and remarks; the scalar fields carry whatever the source published, verbatim.

  • nameservers
    Type: array object[] · RDDSNameserver[]

    Delegated nameservers with their own status and events.

    A delegated nameserver.

    • object
      Type: string

      Resource type identifier.

    • name
      Type: string

      Host name of the nameserver.

    • statuses
      Type: array string[]

      Per-host status strings.

    • events
      Type: array object[] · RDDSEvent[]

      Per-host events.

      A lifecycle event (registration, expiration, last changed, ...).

  • dnssec
    Type: object · RDDSSecureDNS

    DNSSEC delegation posture.

    • object
      Type: string

      Resource type identifier.

    • delegation_signed
      Type: boolean

      Whether the delegation is signed (a DS record exists at the parent).

    • zone_signed
      Type: boolean

      Whether the zone itself is signed.

  • events
    Type: array object[] · RDDSEvent[]

    Every lifecycle event verbatim; the derived date fields are projections of it.

    A lifecycle event (registration, expiration, last changed, ...).

    • object
      Type: string

      Resource type identifier.

    • action
      Type: string

      Event action name, e.g. "registration" or "registrar expiration".

    • actor
      Type: string

      Actor that produced the event, when the source names one.

    • date
      Type: string

      Event timestamp (RFC 3339).

  • links
    Type: array object[] · RDDSLink[]

    RDAP directory links (empty for WHOIS).

    An RDAP hyperlink.

    • object
      Type: string

      Resource type identifier.

    • value
      Type: string

      Context URI the link applies to.

    • rel
      Type: string

      Link relation, e.g. "self".

    • href
      Type: string

      Target URI.

    • type
      Type: string

      Media type of the target.

    • title
      Type: string

      Human-readable title.

  • notices
    Type: array object[] · RDDSNotice[]

    Response-level notices: terms of use, status glossary, inaccuracy form (RDAP only).

    A notice or remark: title, free-text description, and links.

    • object
      Type: string

      Resource type identifier.

    • title
      Type: string

      Notice title, e.g. "Terms of Use".

    • type
      Type: string

      Notice type when the source classifies it.

    • description
      Type: array string[]

      Free-text description lines.

    • links
      Type: array object[] · RDDSLink[]

      Associated links.

      An RDAP hyperlink.

  • remarks
    Type: array object[] · RDDSNotice[]

    Object-level remarks explaining redaction (RDAP only).

    A notice or remark: title, free-text description, and links.

    • object
      Type: string

      Resource type identifier.

    • title
      Type: string

      Notice title, e.g. "Terms of Use".

    • type
      Type: string

      Notice type when the source classifies it.

    • description
      Type: array string[]

      Free-text description lines.

    • links
      Type: array object[] · RDDSLink[]

      Associated links.

      An RDAP hyperlink.

  • port43
    Type: string

    WHOIS referral server advertised by an RDAP response.

  • conformance
    Type: array string[]

    rdapConformance / ICANN profile flags (RDAP only).

  • raw_whois
    Type: string

    Verbatim port-43 WHOIS text; present only for a WHOIS-sourced record.

  • registered_at
    Type: string

    Registration date, projected from events.

  • updated_at
    Type: string

    Last-changed date, projected from events.

  • expires_at
    Type: string

    Registry expiration date, projected from events.

  • registrar_expires_at
    Type: string

    Registrar-reported expiration date, projected from events.

  • last_rdap_update_at
    Type: string

    Timestamp the registry last updated its RDAP database, projected from events.