Contact

A registrant contact record submitted to domain registries. Two shapes are supported: member contacts derive their registrant payload from an existing user, organization location, and optional personal phone; external contacts are free-form rows whose payload is operator-edited end-to-end. The snapshot fields (first_name, last_name, org_name, email, phone, fax, address, country_code) carry a stable copy of the registrant payload so the registry sees a consistent submission even when the upstream rows change. On a member contact the address, phone, fax and org_name follow the linked location, phone and organization automatically. first_name, last_name and email follow the member's profile until a domain or a registry uses the contact; after that they change only when an admin syncs the contact. On an external contact every snapshot field is taken directly from the request body. location carries the full linked organization location on member contacts. It is null on external contacts, and also null on a member contact whose location has since been deleted. disclose is the per-contact privacy flag forwarded to the registry. It defaults to false, withholding the payload, and publication is an explicit edit. It is not derived from upstream and remains operator-editable on both shapes. sync_status says whether a member contact still matches its member's profile. A profile change reaches a contact directly until a domain or a registry uses it. After that, a profile change marks it out_of_sync with sync_reason: profile_changed until POST /contacts/{contact_id}/sync applies it, which needs contact:write. An external contact has no profile and is always in_sync. missing_fields names the fields a domain registration needs that the contact leaves empty, and is empty once the contact can fill a domain role. A member contact's fields are filled at their source: the name and email in the member's profile, the address in the location, the phone in the member's phones or the location.

  • Resource type identifier, always "contact".

  • Registrant email address.

  • Registrant phone in canonical E.164 form.

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

  • First line of the street address.

  • Second line of the street address. Optional.

  • City or locality.

  • State, province, or administrative region.

  • Postal or ZIP code.

  • ISO 3166-1 alpha-2 country code.

  • 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.

  • Stable identifier for the contact.

  • 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
  • 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.

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

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

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

    values
    • in_sync = SyncStatusInSync
    • out_of_sync = SyncStatusOutOfSync
  • 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
  • When sync_status last changed, in RFC 3339 UTC form: while out of sync, the time the contact first fell out of sync.

  • Fields a domain registration needs that the contact leaves empty, in the order first_name, last_name, email, phone, street1, city, postal_code, country_code; empty when the contact can fill a domain role. first_name and last_name are listed together, and only when both are empty, since either one names the registrant.

  • Creation timestamp in RFC 3339 UTC form.

  • Last-update timestamp in RFC 3339 UTC form.

  • Identifier of the owning organization.

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

    values
    member = KindMemberexternal = KindExternal
  • Identifier of the linked user. Present on member contacts only.

  • 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.

  • Registrant first name.

  • Registrant last name.

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