Need help? Call Live Support at +31 (0) 38 453 07 59

Attention! You're currently using the OT&E environment.

Get contact

Used to get a contact

  • GETMethod
  • /v2/customers/customer/contacts/handleURL
URL fields
Name Type Description Restrictions
Customer String The handle of the customer
  • Regular expression: [a-zA-Z0-9\-_@\.]+
  • Minimum length: 3
  • Maximum length: 40
Handle String The contact handle
  • Regular expression: [a-zA-Z0-9\-_@\.]+
  • Minimum length: 3
  • Maximum length: 40
Request parameters
Name Type Required / Optional Description Restrictions
Fields String Optional Select fields to include in the response, comma separated list of field names. Requesting only the needed fields improves response time, especially when omitting relation fields. Identifying field(s) are always included.

Successful request

Contact has been retrieved successfully
  • 200 OKHTTP Status
  • application/jsonContent-Type
Response fields
Name Type Required / Optional Description
Customer handle String Required The customer handle
Label handle String Required The contact handle
Brand String Required The brand
Organization String Optional The name of the organization
Name String Required The name of the person
Address lines List <String> Required The address lines
Postal code String Required Postal code
City String Required The city
State String Optional The state
Country code String Required The ISO 3166-1 alpha2 country code
Email String Required The email address
Voice String Required The voice telephone number
Fax String Optional The fax telephone number
Registries List <String> Optional List of registries the contact exists at
Properties Map <String, Map <String, String>> Optional Contact registry properties, nested map of registry and the contact properties for that registry
Created date Timestamp Required The date the contact was created
Disclosed Fields List <Enum> Optional List of fields disclosed (in RDAP) where this contact is used for a domain. Country and state are allways publicly available.

Possible values:

  • registryContactId: Registry Contact ID (contact:roid)
  • email: Contact e-mail
  • name: Contact name
  • organization: Contact organization
  • addressLine: Contact address lines
  • city: Contact city or locality
  • postalCode: Contact postal code
  • voice: Contact phone number
  • fax: Contact fax number
validations List < validations > Optional Categories the contact has validated
validations
Name Type Required / Optional Description
Validated on date Timestamp Required The date the contact has validated this category
Category terms version Integer Required The version of the category terms the contact has validated
Validation category Enum Optional The validation category

Possible values:

  • General: General terms and conditions
  • IisNu: .NU registry terms and conditions
  • IisSe: .SE registry terms and condition
  • ESNic: .ES registry terms and condition
  • Nominet: .UK registry terms and condition
  • DkHostmaster: .dk registry terms and condition

Failed requests

Generic errors can be expected.

URL fields
The handle of the customer
The contact handle
Request parameters
Select fields to include in the response, comma separated list of field names. Requesting only the needed fields improves response time, especially when omitting relation fields. Identifying field(s) are always included.
Request

GET /v2/customers/customer/contacts/handle

Response