Request parameters for get_domain
Standard Parameters
- action = get
- object = domain
- registrant_ip = valid IP address of the registrant
NOTE:
The get_domain command may be used without end-user credentials when type=admin, all_info, billing, expire_action, forwarding_email (.NAME only), list, tech, owner, nameservers, status, rsp_whois_info, ced_info, nexus_info, or whois_privacy_state. For more information, see "SubmittingAPI commandswithoutcredentials". ADD IN LINK
Attributes
Parameters within the attributes associative array are described below.
| Parameter name | Obligation | Definition / Value |
|---|---|---|
| active_contacts_only | Optional | Retrieves the currently active contact information for owner, admin, billing and tech, as they are currently set on the domain. This info will be returned regardless of whether there is a pending trade in progress. |
| clean_ca_subset | Optional | Determines the type of contact_set values that are returned for .CA domains when type = admin or tech. If clean_ca_subset = 1, the address data is returned in the standard address fields (address1, address2, and address3). If clean_ca_subset is not specified, the query returns the values addr_address_number, addr_corporative, addr_office, addr_orientation, addr_street_cat, and addr_street_name along with the standard address fields (address1, address2, and address3). |
| domain | Required | The relevant domain. |
| limit | Optional | The maximum number of domains to return per page. |
| max_to_expiry | Required when type = list | Defines the expiration range (in days): to fetch the list of domains that are between max_to_expiry and min_to_expiry before expiration date. If min_to_expiry is not provided, it defaults to 0. If min_to_expiry > max_to_expiry, the list is empty. These parameters can have negative values, which means days past the expiration date. For example, -5 means 5 days past the expiration date. |
| min_to_expiry | Required when type = list | Defines the expiration range (in days): to fetch the list of domains that are between max_to_expiry and min_to_expiry before expiration date. If min_to_expiry is not provided, it defaults to 0. If min_to_expiry > max_to_expiry, the list is empty. These parameters can have negative values, which means days past the expiration date. For example, -5 means 5 days past the expiration date. |
| page | Optional | Determines which page to retrieve, using the page number. The page index starts at 0 (zero). |
| type | Required | Type of query. Allowed values are: admin—Returns admin contact information. all_info—Returns all information. billing— Returns billing contact information. ca_whois_display_setting—Returns the current CIRA Whois Privacy setting for .CA domains. domain_auth_info— Returns domain authorization code, if applicable. expire_action— Returns the action to be taken upon domain expiry, specifically whether to auto-renew the domain, or let it expire silently. forwarding_email— Returns forwarding email for .NAME 2nd level. list— Returns list of domains in the same profile or returns list of domains for user using cookie method. nameservers— Returns nameserver information. owner— Returns owner contact information. rsp_whois_info— Returns name and contact information for RSP. status— Returns lock or escrow status of the domain. tech— Returns tech contact information. tld_data—Returns additional information that is required by some registries, such as the residency of the registrant. waiting history— Returns information on asynchronous requests. whois_privacy_state— Returns the state for the WHOIS Privacy feature: enabled, disabled, enabling, or disabling. Note: If the TLD does not allow WHOIS Privacy, always returns Disabled. whois_publicity_state— Returns the state for the WHOIS Publicity feature: enabled, disabled. Note: If the TLD does not allow WHOIS Privacy, always returns Disabled. xpack_waiting_history— Returns the state of completed/cancelled requests not yet deleted from the database for .DKdomains. All completed/cancelled requests are deleted from the database two weeks after they move to final state. |
Response parameters for get_domain
Standard parameters
- action = reply
- object = domain
- is_success = a Boolean is returned, indicating success or failure of the request
- response_code = response code indicating outcome of the request response_text = message describing the outcome of the request
Attributes
The response message returned varies depending on the value of the type field that was used to send the request.
Return details for type = admin, billing, owner, or tech
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| contact_set | Returned when type = owner, admin, billing, or tech and is_success = true | An associative array containing the contact information of the requested type. For details on contact fields, see "ContactSet". |
| gdpr_consent_status | Returned when type = all_info or type=owner | Displays whether or not the registrant has completed the GDPR consent requirements. Detailed status descriptions available at: https://help.opensrs.com/hc/en-us/articles/360004140233 Possible values are: NONE, PENDING PENDING_ASYNC ACCEPTED_CONTRACTUAL_MINIMUM ACCEPTED_FULL DENIED * FORCED_ALL_CONTRACTUAL |
| descr | Returned when type = owner, admin, billing, or tech and is_success = true | The domain description. |
| status | Always returned | The status of the contact. Possible values are: active pending_current_registrant - waiting on action from the current owner/registrant of the domain * pending_new_registrant - waiting on action from the registrant/owner to whom the domain is pending transfer Note: When a pending_current_registrant or pending_new_registrant value is displayed, the contact information included in the response is that which will be displayed in whois once the trade is complete. Both pending_current_registrant and pending_new_registrant will only ever be returned for gTLDs. |
Return details for type = all_info
The response message consists of a combination of the fields used for type = nameserver, and type = owner, admin, tech, or billing. The contact_set contains a type for each possible contact type.
Also returns the fields: auto_renew, expiredate, let_expire, sponsoring_rsp as per the Extended Results of type = list.
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| affiliate_id | Returned if applicable and is_success = 1 | The affiliate id associated with the domain. |
| descr | Returned when type = all_info and is_success = true | The text of the domain description. |
| dns_errors | Returned when type = all_info and is_success = true | The text of the DNS errors. |
| nameserver_list | Returned when type = all_info and is_success = true | A list of nameservers. Each nameserver is represented as an anonymous associative array. For more information, see the Nameserver_List table below. |
| registry_createdate | Returned when type = all_info and is_success = true | The date that the domain was created at the Registry. |
| registry_expiredate | Returned when type = all_info only if the Registry provides this information. | The domain's expiry date as recorded at the Registry. |
| registry_transferdate | Returned when type = all_info only if the Registry provides this information and the domain was transferred. | The Registry's record of when the domain was transferred. |
| registry_updatedate | Returned when type = all_info only if the Registry provides this information. | The date the domain was last updated at the Registry. |
| sponsoring_rsp | Returned when type = all_info and is_success = true | Indicates if the domain is under your reseller profile: 0—Domain is provisioned by a different reseller 1—Domain is under your reseller profile (logged- in reseller) |
| tld_data | Returned for: .ASIA, .AR, .AU, .BR, .CL, .COOP, .DK, .FI, .HK, .HU, .IT, .JOBS, .LV, .MX, .NO, .PM, .PRO, .PL, .PT, .RE, .RO, .RU, .SE, .TF, .US, .WF, .XXX, .YT, and .ZA domains when type = all_info and is_success = true | An associative array containing registrant information. For more information, see “tld_data”. |
Nameserver_List
Parameters within the nameserver_list associative array are described below.
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| ip_address | Returned if the nameserver has an IPv4 address. | The IPv4 address of the nameserver. |
| ipv6 | Returned if the nameserver has an IPv6 address. | The IPv6 address of the nameserver. |
| name | Returned when type = all_info | The name of the nameserver. |
| sort_order | Returned when type = all_info | The nameserver sort order. |
Return details for type = ca_whois_display_setting
Parameters within the ca_whois_display_setting associative array are described below.
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| display | Returned if is_success = true | Indicates the current setting for the CIRA WHOIS Privacy setting. Allowed values are: PRIVATE — Personal information is not displayed on WHOIS lookups. FULL — Personal information such as name, address, telephone number and email address is displayed on WHOIS lookups. |
| individual | Returned if is_success = true | Indicates whether the domain owner is an individual registrant. Only individual registrants (Canadian citizens, Permanent residents, Legal representatives, Aboriginal peoples) can change their CIRA Whois Privacy setting. Allowed values are Y or N. For more information, see “.CA registrations”. |
Return details for type = domain_auth_info
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| domain_auth_info | Returned when type = domain_auth_info and is_success = true | Authentication password for the domain. This facilitates transfers to others domain_auth_info registrars. |
Return details for type = expire_action
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| auto_renew | Returned when type = expire_action and is_success = true | Indicates domain auto-renew setting: 0—Do not auto-renew 1—Auto-renew. |
| expiredate | Returned when type = expire_action and is_success = true | The date that the domain is set to expire, in the format YYYY-MM-DD HH24:MM:SS. |
| let_expire | Returned when type = expire_action and is_success = true | Indicates whether the domain is set to expire silently: 0—Do not expire silently. 1—Expire silently For more information, see “Renewing domains”. |
Return details for type = forwarding_email
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| forwarding_email | Returned when type = forwarding_email and is_success = true | The domain's e-mail address that is used for forwarding purposes. |
Return details for type = list
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| count | Returned when type = list and is_success = true | The count (total number) of domain names in the current user profile. |
| domain_list | Returned when type = list and is_success = true | An array of domain name hashes. For compatibility reasons, if you set with_encoding_types attribute in the request to 0 or don't set it at all, then you get an array of scalars, domain names. For more information, see “Domain_List” table below. |
| ext_results | Returned when type = list and is_success = true | An array of extended results that indicate the domains and their expiry dates. For more information, see the Ext_Results table below. |
| remainder | Returned when type = list and is_success = true | A Boolean variable indicating whether there are more domains in the list: 0—No more domains. 1—More domains to be listed |
Domain_List
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| domain | Returned when type = list and is_success = true | Fully qualified domain name. |
| encoding_type | Returned when type = list and is_success = true | The three-character tag that represents the language encoding type for the domain. For a list of languages and codes, see “AppendixC: Encoding Types for IDNs”. |
Ext_Results
Parameters within the ext_results associative array are described below.
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| auto_renew | Returned when type = list and is_success = true | Status of the auto-renew flag: 0—Do not auto-renew 1—Auto-renew |
| expiredate | Returned when type = list and is_success = true | Expiration date of the domain. |
| has_whois_privacy | Returned when type = list and is_success = true | Indicates whether WHOIS Privacy is enabled: 0—Disabled 1—Enabled |
| let_expire | Returned when type = list and is_success = true | Status of the let-expire flag: 0—Don't expire domain silently 1—Expire domain silently |
| lock_state | Returned when type = list and is_success = true | Flag indicating if the domain is locked to prevent transfers: 0—Not locked 1—Locked |
| sponsoring_rsp | Returned when type = list and is_success = true | Flag indicating if the domain is sponsored by the reseller making the call: 0—Not sponsoring RSP 1—Sponsoring RSP |
Return details for type = nameservers
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| nameserver_list | Returned when type = nameservers and is_success = true | A list of nameservers. Each nameserver is represented as an anonymous associative array. For more information, see the Nameserver_List table below. |
Nameserver_List
Parameters within the nameserver_list associative array are described below.
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| ipaddress | Returned when type = nameservers | IP address of the nameserver |
| name | Returned when type = nameservers | Fully qualified domain name of the nameserver. |
| sortorder | Returned when type = nameservers | Sort order of this nameserver. The sortorder does not necessarily start at 0 and there may be gaps between nameserver entries. It does indicate the relative sorting order of the nameservers. The sort order value must be preserved for nameserver modification commands. |
Return details for type = rsp_whois_info
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| business | Returned when type = rsp_whois_info and is_success = true | The business name of the RSP. |
| domain_enabled | Returned when type = rsp_whois_info and is_success = true | Indicates whether this feature enabled for given domain: Y—Enabled N—Disabled |
| Returned when type = rsp_whois_info and is_success = true | Email address of the RSP. | |
| phone | Returned when type = rsp_whois_info and is_success = true | Phone number of the RSP. |
| rsp_enabled | Returned when type = rsp_whois_info and is_success = true | Indicates whether this feature is enabled or disabled by RSP: Y—Enabled N—Disabled |
| url | Returned when type = rsp_whois_info and is_success = true | The URL of the RSP. |
Return details for type = status
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| auctionescrow | Returned when type = status and domain is in auction escrow. | Indicates whether the domain has been placed in auction escrow. If in auction escrow, the domain cannot be renewed. 0—Not in escrow. 1—In escrow. |
| can_modify | Returned when type = status and is_success = true | Indicates whether the lock state can be modified during this session: 0—Cannot be modified. 1—Can be modified. |
| domain_supports | Returned when type = status and is_success = true | Indicates whether the TLD is one that supports domain locking: 0—Does not support domain locking. 1—Supports domain locking |
| lock_state | Returned when type = status and is_success = true | Indicates whether the domain is locked: 0—Not locked. 1—Locked. |
| parkp_status | Optional | Indicates if the domain is enabled for the Parked Pages service. Values are Enabled, Activating, or blank. If returned but left blank, the domain is not enabled. |
| transfer_away_in_progress | Optional | If returned, indicates that the domain is in the process of being transferred away. Value is 1. |
Note:
The domain_supports and can_modify attributes are different in that a
TLD from a registry that supports domain locking always returns 1 for
domain_supports, but the state of the current session as well as the internal
state of the domain at OpenSRS affects can_modify. This is only true when
all of the following conditions are met:
- Request is done through the sponsoring reseller for the domain.
- The TLD for the domain is one that supports locking at the registry level.
- The domain is not locked internally by OpenSRS.
Return details for type = tld_data
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| tld_data | Returned for: .ASIA, .AR, .AU, .BR, .CL, .COOP, .DE, .DK, .FI, .HK, .HU, .IT, .JOBS, .LV, .MX, .NO, .PM, .PRO, .PT, .RE, .RO, .RU, .SE, .TF, .US, .WF, .XXX, .YT, and .ZA domains when type tld_data and is_success = true | An associative array containing registrant information. For more information, see “tld_data”. |
Return details for type = whois_privacy_state
| Parameter name | Obligation | Definition / Value |
|---|---|---|
| state | Returned when type = whois_privacy_state and is_success = true | WHOIS Privacy state: enabled, disabled, enabling (in process), or disabling (in process). |
Return details for type = whois_publicity_state
| Parameter name | Obligation | Definition / Value |
|---|---|---|
| state | Returned when type = whois_publicity_state and is_success = true | WHOIS Publicity state: enabled, disabled. |
Return details for type = xpack_waiting_history
| Parameter name | Obligation | Definition / Value |
|---|---|---|
| record_count | Returned when type = xpack_waiting_history and is_success = true | The number of completed/cancelled requests not yet deleted from the database for xpack domains. |
| waiting_history | Returned when type = xpack_waiting_history and is_success = true | The history of the request. For more information, see the waiting_history table below. |
Waiting_History
| Parameter name | Obligation | Definition / Value |
|---|---|---|
| create_time | Returned when type = xpack_waiting_history and is_success = true | The date and time the request was initiated, in the format DD-MMM-YYYY hh:mm:ss. |
| current_state | Returned when type = xpack_waiting_history and is_success = true | The current state of the request. |
| reg_type | Returned when type = xpack_waiting_history and is_success = true | Type of request. Completed and cancelled requests are deleted from the database two weeks after they move to final state. |
| xpack_req_id | Returned when type = xpack_waiting_history and is_success = true | The identification number of the request. |
Get domain examples
For type = admin or tech
Example 1
Including the clean_ca_subset parameter
Request
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="object">DOMAIN</item>
<item key="domain">yourdomain.com</item>
<item key="action">GET</item>
<item key="attributes">
<dt_assoc>
<item key="clean_ca_subset">1</item>
<item key="type">admin</item>
</dt_assoc>
</item>
<item key="registrant_ip">10.0.62.128</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="response_text">Query Successful</item>
<item key="action">REPLY</item>
<item key="attributes">
<dt_assoc>
<item key="contact_set">
<dt_assoc>
<item key="admin">
<dt_assoc>
<item key="address1">32 Oak Street</item>
<item key="address2"></item>
<item key="address3"></item>
<item key="status">active</item>
<item key="city">Toronto</item>
<item key="state">ON</item>
<item key="postal_code">M1M1M1</item>
<item key="country">CA</item>
<item key="org_name">Example Company</item>
<item key="phone">+1.4165551212</item>
<item key="fax"></item>
<item key="first_name">Marlin</item>
<item key="last_name">Wilk</item>
<item key="email">[email protected]</item>
<item key="lang">EN</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Example 2
Without the clean_ca_subset parameter
Request
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">GET</item>
<item key="object">DOMAIN</item>
<item key="registrant_ip">10.0.62.128</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">admin</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="object">DOMAIN</item>
<item key="response_text">Query Successful</item>
<item key="action">REPLY</item>
<item key="attributes">
<dt_assoc>
<item key="contact_set">
<dt_assoc>
<item key="admin">
<dt_assoc>
<item key="addr_address_number"></item>
<item key="addr_corporative"></item>
<item key="addr_office"></item>
<item key="addr_orientation"></item>
<item key="addr_street_cat"></item>
<item key="addr_street_name">32 Oak Street</item>
<item key="address1">32 Oak Street</item>
<item key="address2"></item>
<item key="address3"></item>
<item key="status">active</item>
<item key="city">Toronto</item>
<item key="state">ON</item>
<item key="postal_code">M1M1M1</item>
<item key="country">CA</item>
<item key="org_name">Example Company</item>
<item key="first_name">Marlin</item>
<item key="last_name">Wilk</item>
<item key="lang">EN</item>
<item key="email">[email protected]</item>
<item key="phone">+1.4165551212</item>
<item key="fax"></item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
<item key="response_code">200</item>
<item key="is_success">1</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Example 3
Without end-user credentials
Request
<?xml version="1.0" encoding="UTF-8" standalone='yes'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">GET</item>
<item key="object">DOMAIN</item>
<item key="attributes">
<dt_assoc>
<item key="domain">mydomain.com</item>
<item key="type">admin</item>
<item key="limit">10</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version="1.0" encoding="UTF-8" standalone='yes'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="response_code">200</item>
<item key="response_text">Query Successful</item>
<item key="is_success">1</item>
<item key="attributes">
<dt_assoc>
<item key="contact_set">
<dt_assoc>
<item key="billing">
<dt_assoc>
<item key="org_name">Empire Limited Inc.</item>
<item key="first_name">George</item>
<item key="last_name">Walsh</item>
<item key="address1">44 Hemlock St.</item>
<item key="address2"></item>
<item key="address3"></item>
<item key="status">active</item>
<item key="city">Tampa</item>
<item key="state">Florida</item>
<item key="country">US</item>
<item key="postal_code">90211</item>
<item key="phone">+1.4165551122</item>
<item key="fax"></item>
<item key="email">[email protected]</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = all_info
Example 1
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="registrant_ip">111.121.121.121</item>
<item key="attributes">
<dt_assoc>
<item key="type">all_info</item>
<item key="limit">10</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="object">DOMAIN</item>
<item key="response_text">Query Successful</item>
<item key="action">REPLY</item>
<item key="attributes">
<dt_assoc>
<item key="auto_renew">1</item>
<item key="contact_set">
<dt_assoc>
<item key="admin">
<dt_assoc>
<item key="country">US</item>
<item key="address3">Admin</item>
<item key="org_name">Example Inc.</item>
<item key="phone">+1.4165550123x1812</item>
<item key="last_name">Adams</item>
<item key="address2">Suite 100</item>
<item key="status">active</item>
<item key="state">CA</item>
<item key="email">[email protected]</item>
<item key="city">Santa Clara</item>
<item key="postal_code">90210</item>
<item key="fax">+1.4165550125</item>
<item key="address1">32 Oak Street</item>
<item key="first_name">Adler</item>
</dt_assoc>
</item>
<item key="owner">
<dt_assoc>
<item key="country">US</item>
<item key="address3">Owner</item>
<item key="status">active</item>
<item key="org_name">Example Inc.</item>
<item key="phone">+1.4165550123x1902</item>
<item key="last_name">Ottway</item>
<item key="address2">Suite 500</item>
<item key="state">CA</item>
<item key="email">[email protected]</item>
<item key="city">SomeCity</item>
<item key="postal_code">90210</item>
<item key="fax">+1.4165550124</item>
<item key="address1">32 Oak Street</item>
<item key="first_name">Owen</item>
</dt_assoc>
</item>
<item key="billing">
<dt_assoc>
<item key="country">US</item>
<item key="address3">Billing</item>
<item key="org_name">Example Inc.</item>
<item key="phone">+1.4165550123x1248</item>
<item key="last_name">Burton</item>
<item key="address2">Suite 200</item>
<item key="status">active</item>
<item key="state">CA</item>
<item key="email">[email protected]</item>
<item key="city">Santa Clara</item>
<item key="postal_code">90210</item>
<item key="fax">+1.4165550136</item>
<item key="address1">32 Oak Street</item>
<item key="first_name">Bill</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
<item key="registry_updatedate">2016-04-22 05:36:05</item>
<item key="sponsoring_rsp">1</item>
<item key="registry_createdate">2010-01-03 06:48:18</item>
<item key="affiliate_id"></item>
<item key="expiredate">2017-01-03 06:48:18</item>
<item key="let_expire">0</item>
<item key="tld_data"></item>
<item key="registry_expiredate">2017-01-03 06:48:18</item>
<item key="nameserver_list">
<dt_array>
<item key="0">
<dt_assoc>
<item key="ipaddress">21.40.33.21</item> <item key="sortorder">1</item>
<item key="name">ns1.systemdns.com</item>
</dt_assoc>
</item>
<item key="1">
<dt_assoc>
<item key="ipaddress">207.136.100.142</item>
<item key="sortorder">2</item>
<item key="name">ns2.systemdns.com</item>
</dt_assoc>
</item>
<item key="2">
<dt_assoc>
<item key="ipaddress">24.22.23.28</item>
<item key="sortorder">3</item>
<item key="name">patrick.example.com</item>
</dt_assoc>
</item>
<item key="3">
<dt_assoc>
<item key="ipaddress">24.22.23.24</item>
<item key="sortorder">4</item>
<item key="name">qa1.example.com</item>
</dt_assoc>
</item>
<item key="4">
<dt_assoc>
<item key="ipaddress">24.22.23.25</item>
<item key="sortorder">5</item>
<item key="name">qa2.example.com</item>
</dt_assoc>
</item>
</dt_array>
</item>
</dt_assoc>
</item>
<item key="response_code">200</item>
<item key="is_success">1</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Example 2
For .CA domains
Request
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">GET</item>
<item key="object">DOMAIN</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="limit">10</item>
<item key="type">all_info</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_text">Query Successful</item>
<item key="response_code">200</item>
<item key="attributes">
<dt_assoc>
<item key="registry_createdate">2009-10-26 00:00:00</item>
<item key="fqdn2">ns3.systemdns.com</item>
<item key="legal_type">CCT</item>
<item key="fqdn1">ns2.systemdns.com</item>
<item key="sponsoring_rsp">1</item>
<item key="expiredate">2010-10-26 00:00:00</item>
<item key="auto_renew">0</item>
<item key="registry_expiredate">2010-10-26 00:00:00</item>
<item key="nameserver_list">
<dt_array>
<item key="0">
<dt_assoc>
<item key="name">ns2.systemdns.com</item>
<item key="sortorder">1</item>
<item key="ipaddress"></item>
</dt_assoc>
</item>
<item key="1">
<dt_assoc>
<item key="name">ns3.systemdns.com</item>
<item key="sortorder">2</item>
<item key="ipaddress"></item>
</dt_assoc>
</item>
<item key="2">
<dt_assoc>
<item key="name">ns1.systemdns.com</item>
<item key="sortorder">3</item>
<item key="ipaddress"></item>
</dt_assoc>
</item>
</dt_array>
</item>
<item key="let_expire">0</item>
<item key="contact_set">
<dt_assoc>
<item key="owner">
<dt_assoc>
<item key="org_name">Setter Sanctuary</item>
<item key="first_name">Owen</item>
<item key="last_name">Ottway</item>
<item key="address1">32 Oak St.</item>
<item key="address2">Suite 100</item>
<item key="address3" />
<item key="status">active</item>
<item key="city">Toronto</item>
<item key="state">ON</item>
<item key="postal_code">M1M1M1</item>
<item key="country">CA</item>
<item key="phone">+14165551212</item>
<item key="fax"></item>
<item key="email">[email protected]</item>
</dt_assoc>
</item>
<item key="admin">
<dt_assoc>
<item key="country">CA</item>
<item key="org_name">Setter Sanctuary</item>
<item key="phone">+14165551212</item>
<item key="state">ON</item>
<item key="last_name">Wilk</item>
<item key="address2"></item>
<item key="email">[email protected]</item>
<item key="status">active</item>
<item key="lang">EN</item>
<item key="city">Toronto</item>
<item key="postal_code">M1M1M1</item>
<item key="fax"></item>
<item key="address1"> 123 Oak St.</item>
<item key="first_name">Marlin</item>
</dt_assoc>
</item>
<item key="tech">
<dt_assoc>
<item key="country">CA</item>
<item key="org_name">Setter Sanctuary</item>
<item key="phone">+14165551212</item>
<item key="state">ON</item>
<item key="last_name">Wilk</item>
<item key="address2"></item>
<item key="email">[email protected]</item>
<item key="status">active</item>
<item key="lang">EN</item>
<item key="city">Toronto</item>
<item key="postal_code">M1M1M1</item>
<item key="fax"></item>
<item key="address1"> 123 Oak St.</item>
<item key="first_name">Robson</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
<item key="domain_description"></item>
<item key="fqdn3">ns1.systemdns.com</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Example 3
For .AU domains
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">all_info</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="response_text">Query Successful</item>
<item key="action">REPLY</item>
<item key="attributes">
<dt_assoc>
<item key="tld_data">
<dt_assoc>
<item key="au_registrant_info">
<dt_assoc>
<item key="eligibility_type">Charity</item>
<item key="registrant_id">38 144 482 002</item>
<item key="registrant_id_type">ABN</item>
<item key="registrant_name">Example Company Ltd</item>
<item key="policy_reason">1</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
<item key="registry_createdate">2010-09-22 18:29:35</item>
<item key="auto_renew">1</item>
<item key="sponsoring_rsp">1</item>
<item key="expiredate">2012-09-22 18:29:35</item>
<item key="registry_expiredate">2012-09-22 18:29:35</item>
<item key="nameserver_list">
<dt_array>
<item key="0">
<dt_assoc>
<item key="name">ns1.systemdns.com</item>
<item key="sortorder">1</item>
<item key="ipaddress"></item>
</dt_assoc>
</item>
<item key="1">
<dt_assoc>
<item key="name">ns2.systemdns.com</item>
<item key="sortorder">2</item>
<item key="ipaddress"></item>
</dt_assoc>
</item>
</dt_array>
</item>
<item key="contact_set">
<item key="contact_set">
<dt_assoc>
<item key="owner">
<dt_assoc>
<item key="country">US</item>
<item key="address3">Owner</item>
<item key="org_name">Example Inc.</item>
<item key="phone">+1.4165550123x1902</item>
<item key="last_name">Ottway</item>
<item key="address2">Suite 500</item>
<item key="status">active</item>
<item key="state">CA</item>
<item key="email">[email protected]</item>
<item key="city">SomeCity</item>
<item key="postal_code">90210</item>
<item key="fax">+1.4165550124</item>
<item key="address1">32 Oak Street</item>
<item key="first_name">Owen</item>
</dt_assoc>
</item>
<item key="admin">
<dt_assoc>
<item key="country">US</item>
<item key="address3">Admin</item>
<item key="status">active</item>
<item key="org_name">Example Inc.</item>
<item key="phone">+1.4165550123x1812</item>
<item key="last_name">Adams</item>
<item key="address2">Suite 100</item>
<item key="state">CA</item>
<item key="email">[email protected]</item>
<item key="city">Santa Clara</item>
<item key="postal_code">90210</item>
<item key="fax">+1.4165550125</item>
<item key="address1">32 Oak Street</item>
<item key="first_name">Adler</item>
</dt_assoc>
</item>
<item key="billing">
<dt_assoc>
<item key="country">US</item>
<item key="address3">Billing</item>
<item key="status">active</item>
<item key="org_name">Example Inc.</item>
<item key="phone">+1.4165550123x1248</item>
<item key="last_name">Burton</item>
<item key="address2">Suite 200</item>
<item key="state">CA</item>
<item key="email">[email protected]</item>
<item key="city">Santa Clara</item>
<item key="postal_code">90210</item>
<item key="fax">+1.4165550136</item>
<item key="address1">32 Oak Street</item>
<item key="first_name">Bill</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</item>
<item key="let_expire">0</item>
<item key="registry_updatedate">2010-09-22 18:30:05</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Example 4
For .XXX domains
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">all_info</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="response_text">Query Successful</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="attributes">
<dt_assoc>
<item key="auto_renew">1</item>
<item key="ipr_data">
<dt_assoc>
<item key="icm_membership_id">123456</item>
</dt_assoc>
</item>
<item key="contact_set">
<item key="contact_set">
<dt_assoc>
<item key="owner">
<dt_assoc>
<item key="country">US</item>
<item key="address3">Owner</item>
<item key="status">active</item>
<item key="org_name">Example Inc.</item>
<item key="phone">+1.4165550123x1902</item>
<item key="last_name">Ottway</item>
<item key="address2">Suite 500</item>
<item key="state">CA</item>
<item key="email">[email protected]</item>
<item key="city">SomeCity</item>
<item key="postal_code">90210</item>
<item key="fax">+1.4165550124</item>
<item key="address1">32 Oak Street</item>
<item key="first_name">Owen</item>
</dt_assoc>
</item>
<item key="admin">
<dt_assoc>
<item key="country">US</item>
<item key="address3">Admin</item>
<item key="status">active</item>
<item key="org_name">Example Inc.</item>
<item key="phone">+1.4165550123x1812</item>
<item key="last_name">Adams</item>
<item key="address2">Suite 100</item>
<item key="state">CA</item>
<item key="email">[email protected]</item>
<item key="city">Santa Clara</item>
<item key="postal_code">90210</item>
<item key="fax">+1.4165550125</item>
<item key="address1">32 Oak Street</item>
<item key="first_name">Adler</item>
</dt_assoc>
</item>
<item key="billing">
<dt_assoc>
<item key="country">US</item>
<item key="address3">Billing</item>
<item key="status">active</item>
<item key="org_name">Example Inc.</item>
<item key="phone">+1.4165550123x1248</item>
<item key="last_name">Burton</item>
<item key="address2">Suite 200</item>
<item key="state">CA</item>
<item key="email">[email protected]</item>
<item key="city">Santa Clara</item>
<item key="postal_code">90210</item>
<item key="fax">+1.4165550136</item>
<item key="address1">32 Oak Street</item>
<item key="first_name">Bill</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</item>
<item key="registry_updatedate">2011-11-29 21:16:04</item>
<item key="sponsoring_rsp">1</item>
<item key="registry_createdate">2011-11-29 21:11:25</item>
<item key="expiredate">2012-11-29 21:11:25</item>
<item key="let_expire">0</item>
<item key="registry_expiredate">2012-11-29 21:11:25</item>
<item key="nameserver_list">
<dt_array>
<item key="0">
<dt_assoc>
<item key="name">ns1.systemdns.com</item>
<item key="sortorder">1</item>
<item key="ipaddress" />
</dt_assoc>
</item>
<item key="1">
<dt_assoc>
<item key="name">ns2.systemdns.com</item>
<item key="sortorder">2</item>
<item key="ipaddress" />
</dt_assoc>
</item>
</dt_array>
</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = ca_whois_display_setting
Request
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">GET</item>
<item key="object">DOMAIN</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">ca_whois_display_setting</item>
<item key="registrant_ip">10.0.62.142</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="response_text">OK</item>
<item key="attributes">
<dt_assoc>
<item key="individual">Y</item>
<item key="display">FULL</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = domain_auth_info
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">domain_auth_info</item>
<item key="limit">10</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="response_text">Query Successful</item>
<item key="attributes">
<dt_assoc>
<item key="domain_auth_info">ewgnRwnH</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = expire_action
This command returns the action that occurs on domain expiry, in particular
whether the domain will renew automatically, or silently expires.
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">expire_action</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="object">DOMAIN</item>
<item key="response_text">Query Successful</item>
<item key="action">REPLY</item>
<item key="attributes">
<dt_assoc>
<item key="let_expire">0</item>
<item key="expiredate">2017-01-01 06:48:18</item>
<item key="auto_renew">1</item>
</dt_assoc>
</item>
<item key="response_code">200</item>
<item key="is_success">1</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = forwarding_email
This type is currently for use with .NAME domains which have been bundled
or which have been upgraded with email forwarding.
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.name</item>
<item key="attributes">
<dt_assoc>
<item key="type">forwarding_email</item>
<item key="limit">10</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="response_text">Query Successful</item>
<item key="attributes">
<dt_assoc>
<item key="forwarding_email">[email protected]</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = list
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">list</item>
<item key="limit">10</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="object">DOMAIN</item>
<item key="response_text">Command Successful</item>
<item key="action">REPLY</item>
<item key="attributes">
<dt_assoc>
<item key="ext_results">
<dt_array>
<item key="0">
<dt_assoc>
<item key="firstdomain.net">
<dt_assoc>
<item key="wp_service">0</item>
<item key="wp_expiredate">0</item>
<item key="auto_renew">1</item>
<item key="expiredate">2016-10-05 21:59:59</item>
<item key="sponsoring_rsp">1</item>
<item key="lock_state">0</item>
<item key="let_expire">0</item>
<item key="has_whois_privacy">0</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
<item key="1">
<dt_assoc>
<item key="seconddomain.co.nz">
<dt_assoc>
<item key="wp_service">0</item>
<item key="wp_expiredate">0</item>
<item key="auto_renew">1</item>
<item key="expiredate">2016-09-21 21:52:19</item>
<item key="sponsoring_rsp">1</item>
<item key="lock_state">1</item>
<item key="let_expire">0</item>
<item key="has_whois_privacy">0</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
<item key="2">
<dt_assoc>
<item key="yourdomain.com">
<dt_assoc>
<item key="wp_service">0</item>
<item key="wp_expiredate">0</item>
<item key="auto_renew">1</item>
<item key="expiredate">2017-01-03 06:48:18</item>
<item key="sponsoring_rsp">1</item>
<item key="lock_state">1</item>
<item key="let_expire">0</item>
<item key="has_whois_privacy">0</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
<item key="3">
<dt_assoc>
<item key="thirddomain.org.uk">
<dt_assoc>
<item key="wp_service">0</item>
<item key="wp_expiredate">0</item>
<item key="auto_renew">1</item>
<item key="expiredate">2016-09-18 15:01:10</item>
<item key="sponsoring_rsp">1</item>
<item key="lock_state">0</item>
<item key="let_expire">0</item>
<item key="has_whois_privacy">0</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_array>
</item>
<item key="count">4</item>
<item key="remainder">0</item>
<item key="domain_list">
<dt_array>
<item key="0">firstdomain.net</item>
<item key="1">seconddomain.co.nz</item>
<item key="2">yourdomain.com</item>
<item key="3">thirddomain.org.uk</item>
</dt_array>
</item>
</dt_assoc>
</item>
<item key="response_code">200</item>
<item key="is_success">1</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = nameservers
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="registrant_ip">111.121.121.121</item>
<item key="attributes">
<dt_assoc>
<item key="type">nameservers</item>
<item key="limit">10</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="response_text">Query Successful</item>
<item key="attributes">
<dt_assoc>
<item key="type">nameservers</item>
<item key="nameserver_list">
<dt_array>
<item key="0">
<dt_assoc>
<item key="ipaddress">21.40.33.21</item>
<item key="sortorder">1</item>
<item key="name">ns1.systemdns.com</item>
</dt_assoc>
</item>
<item key="1">
<dt_assoc>
<item key="ipaddress">207.136.100.142</item>
<item key="sortorder">2</item>
<item key="name">ns2.systemdns.com</item>
</dt_assoc>
</item>
</dt_array>
</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = owner, admin, billing, or tech
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">owner</item>
<item key="limit">10</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="object">DOMAIN</item>
<item key="response_text">Query Successful</item>
<item key="action">REPLY</item>
<item key="attributes">
<dt_assoc>
<item key="contact_set">
<dt_assoc>
<item key="owner">
<dt_assoc>
<item key="country">CA</item>
<item key="address3"></item>
<item key="status">active</item>
<item key="org_name">Widgets Co</item>
<item key="phone">+1.8885555555</item>
<item key="last_name">Smith</item>
<item key="address2"></item>
<item key="state">ON</item>
<item key="email">[email protected]</item>
<item key="city">Toronto</item>
<item key="postal_code">M6K 3M1</item>
<item key="fax"></item>
<item key="address1">96 Mowat Avenue</item>
<item key="first_name">Ralph</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
<item key="response_code">200</item>
<item key="is_success">1</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = rsp_whois_info
Example 1
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">rsp_whois_info</item>
<item key="limit">10</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="response_text">Command successful</item>
<item key="attributes">
<dt_assoc>
<item key="url" />
<item key="domain_enabled">Y</item>
<item key="rsp_enabled">Y</item>
<item key="fax" />
<item key="business">Example</item>
<item key="opt_info">This company may be contacted
for domain login/passwords, DNS/Nameserver changes, and general domain
support questions.</item>
<item key="email">[email protected]</item>
<item key="phone">+1.4165350123</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = status
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">status</item>
<item key="limit">10</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="response_text">Command successful</item>
<item key="attributes">
<dt_assoc>
<item key="can_modify">0</item>
<item key="domain_supports">1</item>
<item key="auctionescrow">1</item>
<item key="parkp_status">enabled</item>
<item key="lock_state">0</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response if domain is being transferred away
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="response_text">Command successful</item>
<item key="attributes">
<dt_assoc>
<item key="can_modify">0</item>
<item key="domain_supports">1</item>
<item key="parkp_status" />
<item key="lock_state">0</item>
<item key="transfer_away_in_progress">1</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = tld_data
Example 1
For a .ASIA domain
Request
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">tld_data</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="response_text">Query Successful</item>
<item key="response_code">200</item>
<item key="is_success">1</item>
<item key="attributes">
<dt_assoc>
<item key="tld_data">
<dt_assoc>
<item key="ced_info">
<dt_assoc>
<item key="legal_entity_type_info">proprietorship</item>
<item key="locality_state_prov">NSW</item>
<item key="id_type">other</item>
<item key="contact_type">tech</item>
<item key="locality_city">Sydney</item>
<item key="locality_country">AU</item>
<item key="id_type_info">driver\'s license</item>
<item key="legal_entity_type">other</item>
<item key="id_number">AB1234567</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Example 2
For a .COOP domain
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">tld_data</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="response_code">200</item>
<item key="is_success">1</item>
<item key="response_text">Query Successful</item>
<item key="attributes">
<dt_assoc>
<item key="tld_data">
<dt_assoc>
<item key="registrant_extra_info">
<dt_assoc>
<item key="coop_verification_code">123456789</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Example 3
For a .DK domain
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">tld_data</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="response_code">200</item>
<item key="is_success">1</item>
<item key="response_text">Query Successful</item>
<item key="attributes">
<dt_assoc>
<item key="tld_data">
<dt_assoc>
<item key="registrant_extra_info">
<dt_assoc>
<item key="registrant_type">organization</item>
<item key="registrant_vat_id">123456789</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Example 4
For a .JOBS domain
Request
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">tld_data</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="response_code">200</item>
<item key="is_success">1</item>
<item key="response_text">Query Successful</item>
<item key="attributes">
<dt_assoc>
<item key="tld_data">
<dt_assoc>
<item key="registrant_extra_info">
<dt_assoc>
<item key="jobs_admin_type">Yes</item>
<item key="jobs_industry_type">Supply Chain
Management</item>
<item key="jobs_title">HR Generalist</item>
<item key="jobs_association_member">Yes</item>
<item key="jobs_website">http://www.example.com</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Example 5
For .LV and .COM.LV domains
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">tld_data</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="response_code">200</item>
<item key="is_success">1</item>
<item key="response_text">Query Successful</item>
<item key="attributes">
<dt_assoc>
<item key="tld_data">
<dt_assoc>
<item key="registrant_extra_info">
<dt_assoc>
<item key="registrant_type">individual</item>
<item key="id_card_number">987654321</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Example 6
For a .PRO domain
Request
<?xml version='1.0' encoding='UTF-8'?>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="attributes">
<dt_assoc>
<item key="type">tld_data</item>
</dt_assoc>
</item>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key='protocol'>XCP</item>
<item key='action'>REPLY</item>
<item key='object'>DOMAIN</item>
<item key='response_text'>Query Successful</item>
<item key='response_code'>200</item>
<item key='is_success'>1</item>
<item key='attributes'>
<dt_assoc>
<item key='tld_data'>
<dt_assoc>
<item key='professional_data'>
<dt_assoc>
<item key='profession'>Dentist</item>
<item key='license_number'>123456789</item>
<item key='authority_website'>http://www.cda-
adc.ca/</item> Association</item>
<item key='authority'>Canadian Dental
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = waiting history
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">get</item>
<item key="object">domain</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">waiting_history</item>
<item key="limit">10</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="response_text">Query Successful</item>
<item key="attributes">
<dt_assoc>
<item key="record_count">0</item>
<item key="waiting_history">
<dt_array />
</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = whois_privacy_state
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">GET</item>
<item key="object">DOMAIN</item>
<item key="domain">yourdomain.com</item>
<item key="registrant_ip" />
<item key="attributes">
<dt_assoc>
<item key="type">whois_privacy_state</item>
<item key="limit">10</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="response_text">Query Successful</item>
<item key="attributes">
<dt_assoc>
<item key="state">enabled</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = whois_publicity_state
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">GET</item>
<item key="object">DOMAIN</item>
<item key="domain">yourdomain.com</item>
<item key="registrant_ip" />
<item key="attributes">
<dt_assoc>
<item key="type">whois_publicity_state</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="response_text">Query Successful</item>
<item key="attributes">
<dt_assoc>
<item key="state">enabled</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
For type = xpack_waiting_history
Request
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">GET</item>
<item key="object">DOMAIN</item>
<item key="domain">yourdomain.com</item>
<item key="attributes">
<dt_assoc>
<item key="type">xpack_waiting_history</item>
<item key="limit">10</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
<item key="response_text">Query Successful</item>
<item key="attributes">
<dt_assoc>
<item key="record_count">1</item>
<item key="waiting_history">
<dt_array>
<item key="0">
<dt_assoc>
<item key="xpack_req_id">156013</item>
<item key="current_state">INITIATE</item>
<item key="create_time">05-JAN-2006
03:25:18</item>
<item key="req_type">domain_change</item>
</dt_assoc>
</item>
</dt_array>
</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Updated about a year ago