Loading
Cart Total
$0.00
-
Your shopping cart is empty
Loading
Hello! Log in Your Account
New customer? Start here
Domain Contacts
Domain Management
Domain Contacts
Name Server Groups
DNZ Zones and Records
Email and Web Forwarding
SSL Certificates
Create, manage and query contacts used for domain name registrations.
Become a ResellerFilter:
* You will be charged every time this command is run.
Gets all contacts on the account
Back to top
Request Details
Response Details
This command has no URL/Query String parameters
200 Response
{
"result" : [
{
"city" : "Guildford",
"contact_name" : "Jane Doe",
"country_code" : "GB",
"created_on" : "2023-06-07",
"email_address" : "example@example.com",
"fax_number" : "+44.3301226000",
"is_default" : true,
"is_validated" : false,
"nickname" : "Default Example",
"organisation" : "ACME Ltd",
"phone_number" : "+44.3301226000",
"state" : "Surrey",
"street_one" : "Westbury House",
"street_three" : "",
"street_two" : "15 Bury Street",
"updated_on" : "2023-06-07",
"uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
"zip" : "GU2 4AW"
}
],
"status_code" : 200,
"status_message" : "OK"
}
Gets a specific contact on the account
Back to top
Request Details
Response Details
URL and Query String Parameters
Name
Type
Required
uuid
String
True
The UUID of the Contact to be queried
200 Response
{
"result" : {
"city" : "Guildford",
"contact_name" : "Jane Doe",
"country_code" : "GB",
"created_on" : "2023-06-07",
"email_address" : "example@example.com",
"fax_number" : "+44.3301226000",
"is_default" : true,
"is_validated" : false,
"nickname" : "Default Example",
"organisation" : "ACME Ltd",
"phone_number" : "+44.3301226000",
"state" : "Surrey",
"street_one" : "Westbury House",
"street_three" : "",
"street_two" : "15 Bury Street",
"updated_on" : "2023-06-07",
"uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
"zip" : "GU2 4AW"
},
"status_code" : 200,
"status_message" : "OK"
}
404 Response
{
"result" : {},
"status_code" : 404,
"status_message" : "Not Found"
}
Creates a new Contact
Back to top
Request Details
Response Details
This command has no URL/Query String parameters
POST body
Name
Type
Required
city
String
True
The postal city for this contact
contact_name
String
True
The contact name
country_code
String
True
The two letter ISO code for this contacts country
email_address
String
True
The email address for this contact
fax_number
String
False
The fax number for this contact
is_default
boolean
False
Indicates if this contact is the primary contact on the account
nickname
String
False
The nickname for this Contact object
organisation
String
False
The organisation name for this contact
phone_number
String
True
The phone number for this contact
state
String
True
The postal state or province for this contact
street_one
String
True
First line of the contacts postal address
street_three
String
False
Third line of the contacts postal address
street_two
String
False
Second line of the contacts postal address
zip
String
True
The postal code or ZIP code for this contact
JSON all-fields example:
{
"city" : "Guildford",
"contact_name" : "Jane Doe",
"country_code" : "GB",
"email_address" : "example@example.com",
"fax_number" : "+44.3301226000",
"is_default" : true,
"nickname" : "Default Example",
"organisation" : "ACME Ltd",
"phone_number" : "+44.3301226000",
"state" : "Surrey",
"street_one" : "Westbury House",
"street_three" : "",
"street_two" : "15 Bury Street",
"zip" : "GU2 4AW"
}
201 Response
{
"result" : {
"city" : "Guildford",
"contact_name" : "Jane Doe",
"country_code" : "GB",
"created_on" : "2023-06-07",
"email_address" : "example@example.com",
"fax_number" : "+44.3301226000",
"is_default" : true,
"is_validated" : false,
"nickname" : "Default Example",
"organisation" : "ACME Ltd",
"phone_number" : "+44.3301226000",
"state" : "Surrey",
"street_one" : "Westbury House",
"street_three" : "",
"street_two" : "15 Bury Street",
"uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
"zip" : "GU2 4AW"
},
"status_code" : 201,
"status_message" : "Created"
}
400 Response
{
"result" : {},
"status_code" : 400,
"status_message" : "Bad Request"
}
Updates an existing Contact
Back to top
Request Details
Response Details
URL and Query String Parameters
Name
Type
Required
uuid
String
True
The UUID of the contact to be updated
PUT body
Name
Type
Required
city
String
True
The postal city for this contact
contact_name
String
True
The contact name
country_code
String
True
The two letter ISO code for this contacts country
email_address
String
True
The email address for this contact
fax_number
String
False
The fax number for this contact
is_default
boolean
False
Indicates if this contact is the primary contact on the account
nickname
String
False
The nickname for this Contact object
organisation
String
False
The organisation name for this contact
phone_number
String
True
The phone number for this contact
state
String
True
The postal state or province for this contact
street_one
String
True
First line of the contacts postal address
street_three
String
False
Third line of the contacts postal address
street_two
String
False
Second line of the contacts postal address
zip
String
True
The postal code or ZIP code for this contact
JSON all-fields example:
{
"city" : "Guildford",
"contact_name" : "Jane Doe",
"country_code" : "GB",
"email_address" : "example@example.com",
"fax_number" : "+44.3301226000",
"is_default" : true,
"nickname" : "Default Example",
"organisation" : "ACME Ltd",
"phone_number" : "+44.3301226000",
"state" : "Surrey",
"street_one" : "Westbury House",
"street_three" : "",
"street_two" : "15 Bury Street",
"zip" : "GU2 4AW"
}
200 Response
{
"result" : {
"city" : "Guildford",
"contact_name" : "Jane Doe",
"country_code" : "GB",
"created_on" : "2023-06-07",
"email_address" : "example@example.com",
"fax_number" : "+44.3301226000",
"is_default" : true,
"is_validated" : false,
"nickname" : "Default Example",
"organisation" : "ACME Ltd",
"phone_number" : "+44.3301226000",
"state" : "Surrey",
"street_one" : "Westbury House",
"street_three" : "",
"street_two" : "15 Bury Street",
"updated_on" : "2023-06-07",
"uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
"zip" : "GU2 4AW"
},
"status_code" : 200,
"status_message" : "OK"
}
400 Response
{
"result" : {},
"status_code" : 400,
"status_message" : "Bad Request"
}
404 Response
{
"result" : {},
"status_code" : 404,
"status_message" : "Not Found"
}
Deletes an existing Contact
Back to top
Request Details
Response Details
URL and Query String Parameters
Name
Type
Required
uuid
String
True
The UUID of the contact to be deleted
204 Response
{
"result" : {},
"status_code" : 204,
"status_message" : "No Content"
}
404 Response
{
"result" : {},
"status_code" : 404,
"status_message" : "Not Found"
}
Validate an existing contact using the email validation code
Back to top
Request Details
Response Details
URL and Query String Parameters
Name
Type
Required
uuid
String
True
The UUID of the contact to be validated
POST body
Name
Type
Required
code
String
True
The validation code for this contact
JSON all-fields example:
{
"code" : "123456"
}
200 Response
{
"result" : {
"city" : "Guildford",
"contact_name" : "Jane Doe",
"country_code" : "GB",
"created_on" : "2023-06-07",
"email_address" : "example@example.com",
"fax_number" : "+44.3301226000",
"is_default" : true,
"is_validated" : false,
"nickname" : "Default Example",
"organisation" : "ACME Ltd",
"phone_number" : "+44.3301226000",
"state" : "Surrey",
"street_one" : "Westbury House",
"street_three" : "",
"street_two" : "15 Bury Street",
"uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
"zip" : "GU2 4AW"
},
"status_code" : 200,
"status_message" : "OK"
}
400 Response
{
"result" : {},
"status_code" : 400,
"status_message" : "Bad Request"
}
404 Response
{
"result" : {},
"status_code" : 404,
"status_message" : "Not Found"
}
Deletes any contacts that are not assigned to a domain
Back to top
Request Details
Response Details
This command has no URL/Query String parameters
204 Response
{
"result" : {},
"status_code" : 204,
"status_message" : "No Content"
}
Resend the validation email for the specific contact
Back to top
Request Details
Response Details
URL and Query String Parameters
Name
Type
Required
uuid
String
True
The UUID of the contact to be re-validated
200 Response
{
"result" : {
"city" : "Guildford",
"contact_name" : "Jane Doe",
"country_code" : "GB",
"created_on" : "2023-06-07",
"email_address" : "example@example.com",
"fax_number" : "+44.3301226000",
"is_default" : true,
"is_validated" : false,
"nickname" : "Default Example",
"organisation" : "ACME Ltd",
"phone_number" : "+44.3301226000",
"state" : "Surrey",
"street_one" : "Westbury House",
"street_three" : "",
"street_two" : "15 Bury Street",
"updated_on" : "2023-06-07",
"uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
"zip" : "GU2 4AW"
},
"status_code" : 200,
"status_message" : "OK"
}
404 Response
{
"result" : {},
"status_code" : 404,
"status_message" : "Not Found"
}
409 Response
{
"result" : {},
"status_code" : 409,
"status_message" : "Conflict"
}