API Home
Guides & Flows
Core API Overview
name.com Core API Reference
- GETList Domains
- POSTCreate Domain
- GETGet Domain
- PATCHUpdate a domain
- GETGet Auth Code For Domain
- GETGet Pricing For Domain
- POSTPurchase Privacy
- POSTRenew Domain
- POSTSet Contacts
- POSTSet Nameservers
- POSTCheck Availability
- POSTSearch
- POSTZone Check
- POSTDisable Autorenewdeprecated
- POSTDisable Whois Privacydeprecated
- POSTEnable Autorenewdeprecated
- POSTEnable Whois Privacydeprecated
- POSTLock Domaindeprecated
- POSTUnlock Domaindeprecated
- GET
Resources
curl --request POST \
--url https://api.dev.name.com/core/v1/domains \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"domain": {
"domainName": "example.com"
}
}
'{
"domain": {
"domainName": "example.com",
"createDate": "2023-01-15T14:30:00Z",
"expireDate": "2025-01-15T14:30:00Z",
"autorenewEnabled": true,
"locked": true,
"privacyEnabled": true,
"contacts": {
"admin": {
"firstName": "John",
"lastName": "Doe",
"companyName": "Example Inc.",
"address1": "123 Main Street",
"address2": "Suite 400",
"city": "New York",
"state": "NY",
"zip": "10001",
"country": "US",
"email": "[email protected]",
"phone": "+15551234567",
"fax": "+15557654321",
"isVerified": true
},
"billing": {
"firstName": "John",
"lastName": "Doe",
"companyName": "Example Inc.",
"address1": "123 Main Street",
"address2": "Suite 400",
"city": "New York",
"state": "NY",
"zip": "10001",
"country": "US",
"email": "[email protected]",
"phone": "+15551234567",
"fax": "+15557654321",
"isVerified": true
},
"registrant": {
"firstName": "John",
"lastName": "Doe",
"companyName": "Example Inc.",
"address1": "123 Main Street",
"address2": "Suite 400",
"city": "New York",
"state": "NY",
"zip": "10001",
"country": "US",
"email": "[email protected]",
"phone": "+15551234567",
"fax": "+15557654321",
"isVerified": true
},
"tech": {
"firstName": "John",
"lastName": "Doe",
"companyName": "Example Inc.",
"address1": "123 Main Street",
"address2": "Suite 400",
"city": "New York",
"state": "NY",
"zip": "10001",
"country": "US",
"email": "[email protected]",
"phone": "+15551234567",
"fax": "+15557654321",
"isVerified": true
}
},
"nameservers": [
"ns1.example.com",
"ns2.example.com"
],
"renewalPrice": 12.99
},
"order": 123,
"totalPaid": 123
}Create Domain
Registers a new domain under your account. You must provide the domain.domainName at a bare minimum to register.
For premium or special-priced domains, the purchase_price must also be included to confirm cost.
This endpoint is commonly used to programmatically onboard new domains through user signup flows or checkout experiences.
If no contacts are passed in this request, the default contacts for your name.com account will be used.
Best Practices For Domain Creates
In general, you should check that a domain is available prior to attempting to purchase a domain. You can use either the checkAvailability endpoint, or the Search endpoint to confirm that a domain is purchasable.
Important Note on Dropcatching and Abuse Prevention
The createDomain endpoint is designed for standard domain registrations and is not intended for automated dropcatching (i.e., mass or high-frequency attempts to register domains the moment they become available after expiration). The use of drop-catching tools or services to acquire expired domains is strictly prohibited. All domain acquisitions must go through approved channels to ensure fair and transparent access.
Contact Verification
When a new domain registration is created and a contact is submitted, name.com may need to validate the contact’s email address in accordance with ICANN policy. This validation involves sending an email to the provided address, prompting the recipient to click a link to verify their email address.
curl --request POST \
--url https://api.dev.name.com/core/v1/domains \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"domain": {
"domainName": "example.com"
}
}
'{
"domain": {
"domainName": "example.com",
"createDate": "2023-01-15T14:30:00Z",
"expireDate": "2025-01-15T14:30:00Z",
"autorenewEnabled": true,
"locked": true,
"privacyEnabled": true,
"contacts": {
"admin": {
"firstName": "John",
"lastName": "Doe",
"companyName": "Example Inc.",
"address1": "123 Main Street",
"address2": "Suite 400",
"city": "New York",
"state": "NY",
"zip": "10001",
"country": "US",
"email": "[email protected]",
"phone": "+15551234567",
"fax": "+15557654321",
"isVerified": true
},
"billing": {
"firstName": "John",
"lastName": "Doe",
"companyName": "Example Inc.",
"address1": "123 Main Street",
"address2": "Suite 400",
"city": "New York",
"state": "NY",
"zip": "10001",
"country": "US",
"email": "[email protected]",
"phone": "+15551234567",
"fax": "+15557654321",
"isVerified": true
},
"registrant": {
"firstName": "John",
"lastName": "Doe",
"companyName": "Example Inc.",
"address1": "123 Main Street",
"address2": "Suite 400",
"city": "New York",
"state": "NY",
"zip": "10001",
"country": "US",
"email": "[email protected]",
"phone": "+15551234567",
"fax": "+15557654321",
"isVerified": true
},
"tech": {
"firstName": "John",
"lastName": "Doe",
"companyName": "Example Inc.",
"address1": "123 Main Street",
"address2": "Suite 400",
"city": "New York",
"state": "NY",
"zip": "10001",
"country": "US",
"email": "[email protected]",
"phone": "+15551234567",
"fax": "+15557654321",
"isVerified": true
}
},
"nameservers": [
"ns1.example.com",
"ns2.example.com"
],
"renewalPrice": 12.99
},
"order": 123,
"totalPaid": 123
}Authorizations
Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.
Headers
A unique string (e.g., a UUID v4) to make the request idempotent. This key ensures that if the request is retried, the operation will not be performed multiple times. Subsequent requests with the same key will return the original result.
"083910ef-04e4-4bd1-a0bf-3737fe005ca8"
Body
CreateDomainRequest has the information that is needed to create a domain with the CreateDomain function.
CreateDomainRequest has the information that is needed to create a domain with the CreateDomain function.
The payload to be sent for when making a request to purchase a domain.
Show child attributes
Show child attributes
The punycode-encoded value of the domain name.
"example.com"
Indicates whether the domain is set to renew automatically before expiration.
true
Indicates if the domain is locked, preventing transfers to another registrar.
true
Indicates if Whois Privacy is enabled for this domain.
true
Contacts stores the contact information for the roles related to domains. Contacts stores the contact information for the roles related to domains. This schema is used for requests.
Show child attributes
Show child attributes
Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use ContactRequest which enforces all validation requirements.
Contact contains all relevant contact data for a domain registrant. This schema is used for creating and updating contacts (POST/PUT requests) and includes all validation requirements. All fields listed in the required array must be provided and cannot be null or empty.
Show child attributes
Show child attributes
First name of the contact. First name of the contact. First name of the contact.
1"John"
Last name of the contact. Last name of the contact. Last name of the contact.
1"Doe"
The first line of the contact's address. The first line of the contact's address. The first line of the contact's address.
1"123 Main Street"
City of the contact's address. City of the contact's address. City of the contact's address.
1"New York"
State or Province of the contact's address. State or Province of the contact's address. State or Province of the contact's address.
1"NY"
ZIP or Postal Code of the contact's address. ZIP or Postal Code of the contact's address. ZIP or Postal Code of the contact's address. This field is required and must be a non-empty string.
1"10001"
Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code. Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code. Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.
"US"
Email address of the contact. Must be a valid email format. The validation is performed against the addr-spec syntax in RFC 822
Email address of the contact. Must be a valid email format. The validation is performed against the addr-spec syntax in RFC 822
Email address of the contact. Must be a valid email format. The validation is performed against the addr-spec syntax in RFC 822
Phone number of the contact. Should follow the E.164 international format: "+[country code][number]". Phone number of the contact. Should follow the E.164 international format: "+[country code][number]". Phone number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15551234567"
Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise. Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.
"Example Inc."
The second line of the contact's address (optional). The second line of the contact's address (optional).
"Suite 400"
Fax number of the contact. Should follow the E.164 international format: "+[country code][number]". Fax number of the contact. Should follow the E.164 international format: "+[country code][number]". Fax number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15557654321"
Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use ContactRequest which enforces all validation requirements.
Contact contains all relevant contact data for a domain registrant. This schema is used for creating and updating contacts (POST/PUT requests) and includes all validation requirements. All fields listed in the required array must be provided and cannot be null or empty.
Show child attributes
Show child attributes
First name of the contact. First name of the contact. First name of the contact.
1"John"
Last name of the contact. Last name of the contact. Last name of the contact.
1"Doe"
The first line of the contact's address. The first line of the contact's address. The first line of the contact's address.
1"123 Main Street"
City of the contact's address. City of the contact's address. City of the contact's address.
1"New York"
State or Province of the contact's address. State or Province of the contact's address. State or Province of the contact's address.
1"NY"
ZIP or Postal Code of the contact's address. ZIP or Postal Code of the contact's address. ZIP or Postal Code of the contact's address. This field is required and must be a non-empty string.
1"10001"
Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code. Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code. Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.
"US"
Email address of the contact. Must be a valid email format. The validation is performed against the addr-spec syntax in RFC 822
Email address of the contact. Must be a valid email format. The validation is performed against the addr-spec syntax in RFC 822
Email address of the contact. Must be a valid email format. The validation is performed against the addr-spec syntax in RFC 822
Phone number of the contact. Should follow the E.164 international format: "+[country code][number]". Phone number of the contact. Should follow the E.164 international format: "+[country code][number]". Phone number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15551234567"
Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise. Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.
"Example Inc."
The second line of the contact's address (optional). The second line of the contact's address (optional).
"Suite 400"
Fax number of the contact. Should follow the E.164 international format: "+[country code][number]". Fax number of the contact. Should follow the E.164 international format: "+[country code][number]". Fax number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15557654321"
Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use RegistrantContactRequest which enforces all validation requirements.
Contact contains all relevant contact data for a domain registrant. This schema is used for creating and updating contacts (POST/PUT requests) and includes all validation requirements. All fields listed in the required array must be provided and cannot be null or empty.
Show child attributes
Show child attributes
First name of the contact. First name of the contact. First name of the contact.
1"John"
Last name of the contact. Last name of the contact. Last name of the contact.
1"Doe"
The first line of the contact's address. The first line of the contact's address. The first line of the contact's address.
1"123 Main Street"
City of the contact's address. City of the contact's address. City of the contact's address.
1"New York"
State or Province of the contact's address. State or Province of the contact's address. State or Province of the contact's address.
1"NY"
ZIP or Postal Code of the contact's address. ZIP or Postal Code of the contact's address. ZIP or Postal Code of the contact's address. This field is required and must be a non-empty string.
1"10001"
Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code. Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code. Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.
"US"
Email address of the contact. Must be a valid email format. The validation is performed against the addr-spec syntax in RFC 822
Email address of the contact. Must be a valid email format. The validation is performed against the addr-spec syntax in RFC 822
Email address of the contact. Must be a valid email format. The validation is performed against the addr-spec syntax in RFC 822
Phone number of the contact. Should follow the E.164 international format: "+[country code][number]". Phone number of the contact. Should follow the E.164 international format: "+[country code][number]". Phone number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15551234567"
Company name of the contact. Leave blank if the contact is an individual. Please be advised that ICANN policy links the "Company Name" field (Organization) in your domain's contact details to its legal ownership. If this field contains information, the listed organization is considered the legal "Registered Name Holder" (domain owner). Company name of the contact. Leave blank if the contact is an individual. Please be advised that ICANN policy links the "Company Name" field (Organization) in your domain's contact details to its legal ownership. If this field contains information, the listed organization is considered the legal "Registered Name Holder" (domain owner).
"Example Inc."
The second line of the contact's address (optional). The second line of the contact's address (optional).
"Suite 400"
Fax number of the contact. Should follow the E.164 international format: "+[country code][number]". Fax number of the contact. Should follow the E.164 international format: "+[country code][number]". Fax number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15557654321"
Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use ContactRequest which enforces all validation requirements.
Contact contains all relevant contact data for a domain registrant. This schema is used for creating and updating contacts (POST/PUT requests) and includes all validation requirements. All fields listed in the required array must be provided and cannot be null or empty.
Show child attributes
Show child attributes
First name of the contact. First name of the contact. First name of the contact.
1"John"
Last name of the contact. Last name of the contact. Last name of the contact.
1"Doe"
The first line of the contact's address. The first line of the contact's address. The first line of the contact's address.
1"123 Main Street"
City of the contact's address. City of the contact's address. City of the contact's address.
1"New York"
State or Province of the contact's address. State or Province of the contact's address. State or Province of the contact's address.
1"NY"
ZIP or Postal Code of the contact's address. ZIP or Postal Code of the contact's address. ZIP or Postal Code of the contact's address. This field is required and must be a non-empty string.
1"10001"
Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code. Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code. Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.
"US"
Email address of the contact. Must be a valid email format. The validation is performed against the addr-spec syntax in RFC 822
Email address of the contact. Must be a valid email format. The validation is performed against the addr-spec syntax in RFC 822
Email address of the contact. Must be a valid email format. The validation is performed against the addr-spec syntax in RFC 822
Phone number of the contact. Should follow the E.164 international format: "+[country code][number]". Phone number of the contact. Should follow the E.164 international format: "+[country code][number]". Phone number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15551234567"
Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise. Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.
"Example Inc."
The second line of the contact's address (optional). The second line of the contact's address (optional).
"Suite 400"
Fax number of the contact. Should follow the E.164 international format: "+[country code][number]". Fax number of the contact. Should follow the E.164 international format: "+[country code][number]". Fax number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15557654321"
The list of nameservers assigned to this domain. If unspecified, it defaults to the account's default nameservers.
["ns1.example.com", "ns2.example.com"]PurchasePrice is the price in USD for purchasing this domain for the minimum time period (typically 1 year). PurchasePrice is required if purchaseType is not "registration" or if it is a premium domain. If privacyEnabled is set, the regular price for Whois Privacy protection will be added automatically. If VAT tax applies, it will also be added automatically.
PurchaseType defaults to "registration" but should be copied from the result of either a Search or checkAvailability request.
TLDRequirements is a way to pass additional data that is required by some registries. You can check before registration by using the Domain Info API. As these requirements vary wildly between registries and TLDs, we are not attempting to document them here.
IDN Domains
This parameter is required for registering domains that contain non-ASCII characters. The value should be the specific code for the character set, such as ES for Spanish, or CYRL for Cyrillic. These abbreviations can vary between TLDs, and it is highly recommended that you use Domain Info API to ensure that the TLD allows for the specific IDN table, as well as the correct abbreviation.
Show child attributes
Show child attributes
Claims acknowledgement data is required if trademark claims exist for requested domain. This data is obtained from a Domain Claims Check response and includes the claim identifier and validity dates.
Show child attributes
Show child attributes
The claim identifier from TMCH (Trademark Clearinghouse)
"8c3027d30000000000382500785"
The date before which the claim acknowledgment is not valid
"2024-01-15T10:30:00Z"
The date after which the claim acknowledgment expires
"2024-01-15T10:30:00Z"
Years specifies how many years to register the domain for. Years defaults to the minimum time period (typically 1 year) if not passed and cannot be more than 10. Some TLDs default to longer initial periods (e.g. .AI requires a 2 year registration). If passing purchasePrice make sure to adjust it accordingly.
1
Response
A successful response.
CreateDomainResponse contains the domain info as well as the order info for the created domain.
The response format for a domain.
Show child attributes
Show child attributes
The punycode-encoded value of the domain name. The punycode-encoded value of the domain name.
"example.com"
The date and time when the domain was created at the registry. The date and time when the domain was created at the registry.
"2023-01-15T14:30:00Z"
The date and time when the domain will expire. The date and time when the domain will expire.
"2025-01-15T14:30:00Z"
Indicates whether the domain is set to renew automatically before expiration. Indicates whether the domain is set to renew automatically before expiration.
true
Indicates if the domain is locked, preventing transfers to another registrar. Indicates if the domain is locked, preventing transfers to another registrar.
true
Indicates if Whois Privacy is enabled for this domain. Indicates if Whois Privacy is enabled for this domain.
true
Contacts stores the contact information for the roles related to domains. Contacts stores the contact information for the roles related to domains.
Show child attributes
Show child attributes
Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use ContactRequest which enforces all validation requirements. Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use ContactRequest which enforces all validation requirements.
Show child attributes
Show child attributes
First name of the contact. First name of the contact.
"John"
Last name of the contact. Last name of the contact.
"Doe"
Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise. Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.
"Example Inc."
The first line of the contact's address. The first line of the contact's address.
"123 Main Street"
The second line of the contact's address (optional). The second line of the contact's address (optional).
"Suite 400"
City of the contact's address. City of the contact's address.
"New York"
State or Province of the contact's address. State or Province of the contact's address.
"NY"
ZIP or Postal Code of the contact's address. ZIP or Postal Code of the contact's address.
"10001"
Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code. Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.
"US"
Phone number of the contact. Should follow the E.164 international format: "+[country code][number]". Phone number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15551234567"
Fax number of the contact. Should follow the E.164 international format: "+[country code][number]". Fax number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15557654321"
Indicates if the contact has been verified as per ICANN requirements. If the value is false it indicates that the contact has not completed the required verification process. This property is read-only and will be included in responses but should not be included in requests.
Indicates if the contact has been verified as per ICANN requirements. If the value is false it indicates that the contact has not completed the required verification process. This property is read-only and will be included in responses but should not be included in requests.
true
Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use ContactRequest which enforces all validation requirements. Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use ContactRequest which enforces all validation requirements.
Show child attributes
Show child attributes
First name of the contact. First name of the contact.
"John"
Last name of the contact. Last name of the contact.
"Doe"
Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise. Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.
"Example Inc."
The first line of the contact's address. The first line of the contact's address.
"123 Main Street"
The second line of the contact's address (optional). The second line of the contact's address (optional).
"Suite 400"
City of the contact's address. City of the contact's address.
"New York"
State or Province of the contact's address. State or Province of the contact's address.
"NY"
ZIP or Postal Code of the contact's address. ZIP or Postal Code of the contact's address.
"10001"
Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code. Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.
"US"
Phone number of the contact. Should follow the E.164 international format: "+[country code][number]". Phone number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15551234567"
Fax number of the contact. Should follow the E.164 international format: "+[country code][number]". Fax number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15557654321"
Indicates if the contact has been verified as per ICANN requirements. If the value is false it indicates that the contact has not completed the required verification process. This property is read-only and will be included in responses but should not be included in requests.
Indicates if the contact has been verified as per ICANN requirements. If the value is false it indicates that the contact has not completed the required verification process. This property is read-only and will be included in responses but should not be included in requests.
true
Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use RegistrantContactRequest which enforces all validation requirements. Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use RegistrantContactRequest which enforces all validation requirements.
Show child attributes
Show child attributes
First name of the contact. First name of the contact.
"John"
Last name of the contact. Last name of the contact.
"Doe"
Company name of the contact. Leave blank if the contact is an individual. Please be advised that ICANN policy links the "Company Name" field (Organization) in your domain's contact details to its legal ownership. If this field contains information, the listed organization is considered the legal "Registered Name Holder" (domain owner). Company name of the contact. Leave blank if the contact is an individual. Please be advised that ICANN policy links the "Company Name" field (Organization) in your domain's contact details to its legal ownership. If this field contains information, the listed organization is considered the legal "Registered Name Holder" (domain owner).
"Example Inc."
The first line of the contact's address. The first line of the contact's address.
"123 Main Street"
The second line of the contact's address (optional). The second line of the contact's address (optional).
"Suite 400"
City of the contact's address. City of the contact's address.
"New York"
State or Province of the contact's address. State or Province of the contact's address.
"NY"
ZIP or Postal Code of the contact's address. ZIP or Postal Code of the contact's address.
"10001"
Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code. Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.
"US"
Phone number of the contact. Should follow the E.164 international format: "+[country code][number]". Phone number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15551234567"
Fax number of the contact. Should follow the E.164 international format: "+[country code][number]". Fax number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15557654321"
Indicates if the contact has been verified as per ICANN requirements. If the value is false it indicates that the contact has not completed the required verification process. This property is read-only and will be included in responses but should not be included in requests.
Indicates if the contact has been verified as per ICANN requirements. If the value is false it indicates that the contact has not completed the required verification process. This property is read-only and will be included in responses but should not be included in requests.
true
Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use ContactRequest which enforces all validation requirements. Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use ContactRequest which enforces all validation requirements.
Show child attributes
Show child attributes
First name of the contact. First name of the contact.
"John"
Last name of the contact. Last name of the contact.
"Doe"
Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise. Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.
"Example Inc."
The first line of the contact's address. The first line of the contact's address.
"123 Main Street"
The second line of the contact's address (optional). The second line of the contact's address (optional).
"Suite 400"
City of the contact's address. City of the contact's address.
"New York"
State or Province of the contact's address. State or Province of the contact's address.
"NY"
ZIP or Postal Code of the contact's address. ZIP or Postal Code of the contact's address.
"10001"
Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code. Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.
"US"
Phone number of the contact. Should follow the E.164 international format: "+[country code][number]". Phone number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15551234567"
Fax number of the contact. Should follow the E.164 international format: "+[country code][number]". Fax number of the contact. Should follow the E.164 international format: "+[country code][number]".
"+15557654321"
Indicates if the contact has been verified as per ICANN requirements. If the value is false it indicates that the contact has not completed the required verification process. This property is read-only and will be included in responses but should not be included in requests.
Indicates if the contact has been verified as per ICANN requirements. If the value is false it indicates that the contact has not completed the required verification process. This property is read-only and will be included in responses but should not be included in requests.
true
The list of nameservers assigned to this domain. If unspecified, it defaults to the account's default nameservers. The list of nameservers assigned to this domain. If unspecified, it defaults to the account's default nameservers.
["ns1.example.com", "ns2.example.com"]The cost to renew the domain. This may be required for the RenewDomain operation. The cost to renew the domain. This may be required for the RenewDomain operation.
12.99
Order is an identifier for this purchase.
TotalPaid is the total amount paid, including VAT and Whois privacy protection.
Was this page helpful?