ContactDetail

A registrant contact, as the contact endpoints return it. It carries every field of Contact under the same name, then pending_profile and registries. A member contact's first_name, last_name and email follow the profile until a domain or a registry uses the contact; after that a profile change marks the contact out_of_sync with sync_reason: profile_changed, and pending_profile shows the values POST /contacts/{contact_id}/sync would apply. registries lists each registry holding a copy of the contact, with that registry's own sync state. An edit marks every entry out_of_sync until the registry accepts the update; the contact's own sync_status never reflects registries.

  • object
    Type: string

    Resource type identifier, always "contact_detail".

  • email
    Type: string

    Registrant email address.

  • phone
    Type: string

    Registrant phone in canonical E.164 form.

  • fax
    Type: string

    Registrant fax in canonical E.164 form. Optional; many registries accept an empty value.

  • street1
    Type: string

    First line of the street address.

  • street2
    Type: string

    Second line of the street address. Optional.

  • city
    Type: string

    City or locality.

  • region
    Type: string

    State, province, or administrative region.

  • postal_code
    Type: string

    Postal or ZIP code.

  • country_code
    Type: string

    ISO 3166-1 alpha-2 country code.

  • disclose
    Type: boolean

    Per-contact privacy flag submitted to the registry. False (default) requests redaction; true permits the registry to disclose the registrant payload via WHOIS/RDAP. Not derived from upstream; operator-editable on both kinds.

  • id
    Type: string

    Stable identifier for the contact.

  • verification_status
    Type: enum

    Explicit verification state of the contact: "unverified" or "verified". Member contacts are stamped "verified" at create time because their snapshot is composed from already-validated upstream rows; external contacts start "unverified" and transition only via the verification flow. Not operator-editable via PATCH.

    values
    • unverified = StatusUnverified
    • verified = StatusVerified
  • is_active
    Type: boolean

    Whether the contact is available for assignment. Defaults to true; flipping to false is the reversible operator switch above soft-delete. A contact still in use, by a team role slot, a domain, an order in progress or a contact change being applied, cannot be deactivated until that use ends.

  • verified_at
    Type: string

    Timestamp of the last successful verification, in RFC 3339 UTC form. Supporting observability for verification_status; null when the contact has never been verified.

  • location
    Type:

    Full linked organization location. Present on member contacts; null on external contacts and on member contacts whose location has been deleted.

    Properties: 16
  • sync_status
    Type: enum

    Whether the contact matches its member's profile. Always "in_sync" on an external contact.

    values
    • in_sync = SyncStatusInSync
    • out_of_sync = SyncStatusOutOfSync
  • sync_reason
    enum
    const:  
    profile_changed

    Why the contact is out of sync; null exactly when it is in sync. "profile_changed": the member changed their name or email while a domain or a registry used the contact.

    values
    • profile_changed = SyncReasonProfileChanged
  • sync_status_changed_at
    Type: string

    When sync_status last changed, in RFC 3339 UTC form: while out of sync, the time the contact first fell out of sync.

  • pending_profile
    Type:

    The member's profile as it reads now, which a sync would apply. Null unless sync_reason is "profile_changed" and the member still belongs to the organization.

    Properties: 4
  • registries
    Type:

    One entry per registry where the contact holds a handle, each with that registry's own sync state; empty when it holds none. A registry that runs thin and thick TLDs holds one handle, so it appears once.

    Properties: 7
  • created_at
    Type: string

    Creation timestamp in RFC 3339 UTC form.

  • org_id
    Type: string

    Identifier of the owning organization.

  • updated_at
    Type: string

    Last-update timestamp in RFC 3339 UTC form.

  • kind
    Type: enum

    Contact shape: "member" (derived from user + location + optional phone) or "external" (free-form).

    values
    member = KindMemberexternal = KindExternal
  • user_id
    Type: string

    Identifier of the linked user. Present on member contacts only.

  • phone_id
    Type: string

    Identifier of the linked personal phone. Optional on member contacts; when absent the snapshot's phone is composed from the location's office phone. Always null on external contacts.

  • first_name
    Type: string

    Registrant first name.

  • last_name
    Type: string

    Registrant last name.

  • org_name
    Type: string

    Registrant organization name. Derived from the org's legal name on member contacts; free-form on external contacts.