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.
- objectType: string
Resource type identifier, always "contact".
- emailType: string
Registrant email address.
- phoneType: string
Registrant phone in canonical E.164 form.
- faxType: string
Registrant fax in canonical E.164 form. Optional; many registries accept an empty value.
- street1Type: string
First line of the street address.
- street2Type: string
Second line of the street address. Optional.
- cityType: string
City or locality.
- regionType: string
State, province, or administrative region.
- postalType: string
_code Postal or ZIP code.
- countryType: string
_code ISO 3166-1 alpha-2 country code.
- discloseType: 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.
- idType: string
Stable identifier for the contact.
- verificationType: enum
_status 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 =
Status Unverified - verified =
Status Verified
- unverified =
- isType: boolean
_active 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.
- verifiedType: string
_at Timestamp of the last successful verification, in RFC 3339 UTC form. Supporting observability for verification_status; null when the contact has never been verified.
- locationType:Properties: 16
Full linked organization location. Present on member contacts; null on external contacts and on member contacts whose location has been deleted.
- syncType: enum
_status Whether the contact matches its member's profile. Always "in_sync" on an external contact.
values- in
_sync = Sync Status In Sync - out
_of _sync = Sync Status Out Of Sync
- in
- syncenum
_reason const:profile_changedWhy 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 = Sync Reason Profile Changed
- profile
- syncType: string
_status _changed _at When sync_status last changed, in RFC 3339 UTC form: while out of sync, the time the contact first fell out of sync.
- missingType: array of string
_fields 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.
- createdType: string
_at Creation timestamp in RFC 3339 UTC form.
- updatedType: string
_at Last-update timestamp in RFC 3339 UTC form.
- orgType: string
_id Identifier of the owning organization.
- kindType: enum
Contact shape: "member" (derived from user + location + optional phone) or "external" (free-form).
valuesmember = KindMemberexternal = KindExternal - userType: string
_id Identifier of the linked user. Present on member contacts only.
- phoneType: string
_id Identifier of the linked personal phone. Optional on member contacts; when absent the snapshot's
phoneis composed from the location's office phone. Always null on external contacts. - firstType: string
_name Registrant first name.
- lastType: string
_name Registrant last name.
- orgType: string
_name Registrant organization name. Derived from the org's legal name on member contacts; free-form on external contacts.