This documentation has moved

XML API documentation can now be found at developer.openprovider.com. This page will remain available until September 2026, but will no longer be updated.

The XML API itself is not changing. Your existing integration continues to work.

API Module Domain searchDomainRequest

From Openprovider API documentation

(Difference between revisions)
Jump to: navigation, search
(Module Domain > Search)
 
(9 intermediate revisions not shown)
Line 21: Line 21:
*[[API Format Domain Status|status]]
*[[API Format Domain Status|status]]
*withAdditionalData (''default value: 0'')
*withAdditionalData (''default value: 0'')
 +
*isAbusive (''default value: 0'', if value: 1 then returns only abusive domains)
 +
*withAbuseDetails (''default value: 0'')
 +
*orderBy (orders output by chosen parameter's value, i.e.: id, domainName, status, orderDate, etc.)
 +
*order (desc or asc)
|- style="vertical-align:top;"
|- style="vertical-align:top;"
|'''Output'''
|'''Output'''
Line 28: Line 32:
*activeDate
*activeDate
*[[API Format expirationDate|expirationDate]]
*[[API Format expirationDate|expirationDate]]
-
*[[API Format expirationDateOpenprovider|expirationDateOpenprovider]]
+
*[[API Format expirationDateOpenprovider|expirationDateOpenprovider]] - Same as renewalDate.
 +
*[[API Format renewalDate|renewalDate]] - Date when a domain expires at Openprovider. This date should be referred for domain expiration and renewals.
*[[API Format Handle|ownerHandle]]
*[[API Format Handle|ownerHandle]]
*[[API Format Handle|adminHandle]]
*[[API Format Handle|adminHandle]]
Line 39: Line 44:
*[[API Format Domain Status|status]]
*[[API Format Domain Status|status]]
*[[API Format autorenew|autorenew]]
*[[API Format autorenew|autorenew]]
-
*locked
+
*[[API Format isLocked|isLocked]]
-
*type
+
*[[API Format useDomicile|useDomicile]]
*[[API Format useDomicile|useDomicile]]
*[[API Format Transfer At|at]]
*[[API Format Transfer At|at]]
-
*[[API Format Additional Data Domain|additionalData]] (if withAdditionalData = true)
+
*[[API Format Additional Data|additionalData]] (if withAdditionalData = true)
 +
*registryDetails (if withRegistryDetails = true)
 +
*abuseDetails (if withAbuseDetails = true)
 +
*softQuarantineExpiryDate (if status=DEL or RRQ)
 +
*hardQuarantineExpiryDate (if status=DEL or RRQ)
 +
*restorableUntil (if status=DEL or RRQ)
|}
|}
Line 55: Line 64:
     'limit'  => 25,
     'limit'  => 25,
     'contactHandle' => 'AH009176-US',
     'contactHandle' => 'AH009176-US',
-
     'domainNamePattern' => 'openprovider'
+
     'domainNamePattern' => 'openprovider',
 +
    'orderBy' => 'domainName',
 +
    'order' => 'desc'
   ));
   ));
Line 78: Line 89:
  <openXML>
  <openXML>
   <reply>
   <reply>
-
     < code>0</code>
+
     <nowiki><code>0</code></nowiki>
     <desc>
     <desc>
     </desc>
     </desc>

Current revision as of 10:52, 12 November 2025

Contents

Module Domain > Search

Module domain
Command name searchDomainRequest
Use Returns a list of domain objects matching search criteria
Input
  • limit (default value: 100, maximum value: 1000)
  • offset (default value: 0)
  • extension
  • domainNamePattern
  • contactHandle (will return domains with customer handle match of any handle type: owner, admin, tech or billing)
  • nsGroupPattern (nameservers group name pattern)
  • status
  • withAdditionalData (default value: 0)
  • isAbusive (default value: 0, if value: 1 then returns only abusive domains)
  • withAbuseDetails (default value: 0)
  • orderBy (orders output by chosen parameter's value, i.e.: id, domainName, status, orderDate, etc.)
  • order (desc or asc)
Output Result set of domain details:

Examples

Using PHP class

$request = new OP_Request;
$request->setCommand('searchDomainRequest')
 ->setAuth(array('username' => 'username', 'password' => 'password'))
 ->setArgs(array(
   'offset' => 50, //Will only return results if more than 50 domains found
   'limit'  => 25,
   'contactHandle' => 'AH009176-US',
   'domainNamePattern' => 'openprovider',
   'orderBy' => 'domainName',
   'order' => 'desc'
 ));

Raw XML

Please note that newlines and leading spaces are added only for readability. Those whitespaces should be excluded from your XML command before sending it to Openprovider.

<?xml version="1.0" encoding="UTF-8"?>
<openXML>
  <credentials>
    <username>username</username>
    <password>password</password>
  </credentials>
  <searchDomainRequest>
    <extension>nl</extension>
    <limit>10</limit>
    <offset>0</offset>
    <orderBy>domainName</orderBy>
    <order>desc</order>
  </searchDomainRequest>
</openXML>
<?xml version="1.0" encoding="UTF-8"?>
<openXML>
  <reply>
    <code>0</code>
    <desc>
    </desc>
    <data>
      <results>
        <array>
          <item>
            <domain>
              <name>test-free-registration</name>
              <extension>nl</extension>
            </domain>
            <nameServers />
            <id>353146</id>
            <isLockable>0</isLockable>
            <isLocked>0</isLocked>
            <comments></comments>
            <orderDate>2010-04-20 16:16:26</orderDate>
            <activeDate>2010-04-20 16:16:29</activeDate>
            <expirationDate>2011-04-20 14:16:28</expirationDate>
            <expirationDateOpenprovider>2011-04-20 14:16:28</expirationDateOpenprovider>
            <status>ACT</status>
            <canRenew>0</canRenew>
            <autoRenew>1</autoRenew>
            <ownerHandle>NL000115-NL</ownerHandle>
            <adminHandle>NL000115-NL</adminHandle>
            <techHandle>NL000115-NL</techHandle>
            <billingHandle>SR003891-NL</billingHandle>
            <nsGroup>dns-openprovider</nsGroup>
            <type>NEW</type>
            <authCode>sad08dfdsf</authCode>
            <authorizationCodeRequired>0</authorizationCodeRequired>
            <tradeAllowed>1</tradeAllowed>
            <restorePrice>70</restorePrice>
            <useDomicile>0</useDomicile>
            <ownerName>
              <initials>N</initials>
              <firstName>Nigel</firstName>
              <prefix />
              <lastName>Jones</lastName>
            </ownername>
            <ownerCompanyName>Company Ltd</ownerCompanyName>
          </item>
          <item>
            <domain>
              <name>test-free-domain</name>
              <extension>nl</extension>
            </domain>
            <nameServers />
            <id>353163</id>
            <isLockable>0</isLockable>
            <isLocked>0</isLocked>
            <comments />
            <orderDate>2010-04-20 17:12:47</orderDate>
            <activeDate>2010-04-20 17:12:51</activeDate>
            <expirationDate>2011-04-20 15:12:50</expirationDate>
            <expirationDateOpenprovider>2011-04-20 15:12:50</expirationDateOpenprovider>
            <status>ACT</status>
            <canRenew>0</canRenew>
            <autoRenew>1</autoRenew>
            <ownerHandle>GB000002-GB</ownerHandle>
            <adminHandle>GB000002-GB</adminHandle>
            <techHandle>GB000002-GB</techHandle>
            <billingHandle>SR003891-NL</billingHandle>
            <nsGroup>dns-openprovider</nsGroup>
            <type>NEW</type>
            <authCode>sad08dfdsf</authCode>
            <authorizationCodeRequired>0</authorizationCodeRequired>
            <tradeAllowed>1</tradeAllowed>
            <restorePrice>70</restorePrice>
            <useDomicile>0</useDomicile>
            <ownerName>
              <initials>UK</initials>
              <firstName>Great</firstName>
              <prefix />
              <lastName>Britain</lastName>
            </ownerName>
            <ownerCompanyName></ownerCompanyName>
          </item>
          <item>
            <domain>
              <name>abcdefg</name>
              <extension>nl</extension>
            </domain>
            <nameServers />
            <id>341105</id>
            <isLockable>0</isLockable>
            <isLocked>0</isLocked>
            <comments />
            <orderDate>2010-03-15 16:50:19</orderDate>
            <activeDate />
            <expirationDate>2011-03-15 16:50:19</expirationDate>
            <expirationDateOpenprovider />
            <status>FAI</status>
            <canRenew>0</canRenew>
            <autoRenew>0</autoRenew>
            <ownerHandle>OH002766-NL</ownerHandle>
            <adminHandle>OH002766-NL</adminHandle>
            <techHandle>OH002766-NL</techHandle>
            <billingHandle>SR003891-NL</billingHandle>
            <nsGroup>opdrs4</nsGroup>
            <type>NEW</type>
            <authCode>88sdkjhf7</authCode>
            <authorizationCodeRequired>0</authorizationCodeRequired>
            <tradeAllowed>1</tradeAllowed>
            <restorePrice>70</restorePrice>
            <useDomicile>0</useDomicile>
            <ownerName>
              <initials>I.</initials>
              <firstName>Ibrahim</firstName>
              <prefix />
              <lastName>Smith</lastName>
            </ownerName>
            <ownerCompanyName></ownerCompanyName>
          </item>
        </array>
      </results>
      <total>3</total>
    </data>
  </reply>
</openXML>
Views
Personal tools