DomainVersion

One immutable lifecycle event for a domain: the complete frozen snapshot at this version plus the field-level changes from the previous version.

  • object
    Type: string

    Resource type identifier

  • id
    Type: string

    Unique identifier for this version event

  • domain_id
    Type: string

    Identifier of the domain this version belongs to

  • version
    Type: integer

    Per-domain monotonic version number, starting at 1

  • change_type
    Type: string · DomainVersionChangeTypeenum

    Classification of the lifecycle event that produced this version

    values
    • registration_pending = ChangeTypeRegistrationPending
    • registered = ChangeTypeRegistered
    • renewed = ChangeTypeRenewed
  • change_summary
    Type: string

    Human-readable summary of the change; omitted when none was recorded

  • snapshot
    Type: object · DomainVersionSnapshot

    Complete frozen state of the domain at this version

    • object
      Type: string

      Resource type identifier

    • auto_renew
      Type: boolean

      Whether auto-renewal was enabled at this version; omitted when unknown

    • period
      Type: object · Period

      Registration term at this version; omitted when unknown

    • expires_at
      Type: string

      Registry expiry at this version; omitted when unknown

    • roid
      Type: string

      Registry object id (ROID) at this version; omitted before the registry confirms the create

    • sponsoring_registrar
      Type: string

      Sponsoring registrar at this version; omitted before the registry confirms the create

    • contacts
      Type: array object[] · DomainVersionContact[]

      Frozen role contacts assigned at this version; empty when none were assigned

      Frozen copy of a contact assigned to a role at a single version.

    • nameservers
      Type: array string[]

      Delegated nameserver hostnames at this version

    • epp_statuses
      Type: array string[]

      EPP status codes set at this version

    • ds_records
      Type: array object[] · DomainVersionDS[]

      DNSSEC delegation-signer records at this version

      Frozen DNSSEC delegation-signer record at a single version.

  • changes
    Type: array object[] · DomainVersionChange[]

    Field-level changes versus the previous version; empty for the first version

    A single field-level change between this version and the previous one. kind tells the client how to render from/to.

    • object
      Type: string

      Resource type identifier

    • field
      Type: string

      Snake-case name of the field that changed

    • label
      Type: string

      Human-readable label for the changed field

    • kind
      Type: stringenum

      How a client should render from/to

      values
      • date
      • toggle
      • count
      • text
      • list
      • reference
    • from
      Type: object

      Previous value; omitted when the field was unset before this version

    • to
      Type: object

      New value; omitted when the field was unset at this version

  • changed_by
    Type: object · Actor

    Actor that produced this version; omitted when attribution is unavailable

    • object
      Type: string

      Resource type identifier

    • method
      Type: string

      Principal class. One of session, personal_key, org_key, system.

    • user
      Type: object · User

      Full user profile. Populated for session and personal_key (the key owner) when the user row is resolvable; null for org_key and system, and also null when the user row was deleted after the attribution was recorded.

    • personal_key
      Type: object · ActorPersonalKey

      Personal API key pointer. Populated only for personal_key.

    • org_key
      Type: object · ActorOrgKey

      Org API key pointer. Populated only for org_key.

  • occurred_at
    Type: string

    When this version was recorded