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
 
(24 intermediate revisions not shown)
Line 13: Line 13:
|'''Input'''
|'''Input'''
|
|
-
*limit ''default value: 100''
+
*[[API Format Limit|limit]] (''default value: 100, maximum value: 1000'')
-
*offset ''default value: 0''
+
*[[API Format Offset|offset]] (''default value: 0'')
-
*extension
+
*[[API Format Domain extension|extension]]
*domainNamePattern
*domainNamePattern
-
*contactHandle
+
*[[API Format Handle|contactHandle]] (will return domains with customer handle match of any handle type: owner, admin, tech or billing)
-
*nsGroupPattern
+
*nsGroupPattern (nameservers group name pattern)
-
*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 27: Line 31:
*orderDate
*orderDate
*activeDate
*activeDate
-
*expirationDate
+
*[[API Format expirationDate|expirationDate]]
-
*renewalDate
+
*[[API Format expirationDateOpenprovider|expirationDateOpenprovider]] - Same as renewalDate.
-
*ownerHandle
+
*[[API Format renewalDate|renewalDate]] - Date when a domain expires at Openprovider. This date should be referred for domain expiration and renewals.
-
*adminHandle
+
*[[API Format Handle|ownerHandle]]
-
*techHandle
+
*[[API Format Handle|adminHandle]]
-
*billingHandle
+
*[[API Format Handle|techHandle]]
-
*resellerHandle
+
*[[API Format Handle|billingHandle]]
-
*nsGroup
+
*[[API Format Handle|resellerHandle]]
 +
*[[API Format nsGroup|nsGroup]]
*[[API Format Nameservers|nameServers]]
*[[API Format Nameservers|nameServers]]
-
*authCode
+
*[[API Format authCode|authCode]]
-
*status
+
*[[API Format Domain Status|status]]
-
*autoRenew
+
*[[API Format autorenew|autorenew]]
-
*locked
+
*[[API Format isLocked|isLocked]]
-
*type
+
*[[API Format useDomicile|useDomicile]]
-
*useDomicile
+
*[[API Format Transfer At|at]]
-
*at
+
*[[API Format Additional Data|additionalData]] (if withAdditionalData = true)
-
*[[API Format Additional Data Domain|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>
Line 97: Line 108:
             <activeDate>2010-04-20 16:16:29</activeDate>
             <activeDate>2010-04-20 16:16:29</activeDate>
             <expirationDate>2011-04-20 14:16:28</expirationDate>
             <expirationDate>2011-04-20 14:16:28</expirationDate>
-
             <renewalDate>2011-04-20 14:16:28</renewalDate>
+
             <expirationDateOpenprovider>2011-04-20 14:16:28</expirationDateOpenprovider>
             <status>ACT</status>
             <status>ACT</status>
             <canRenew>0</canRenew>
             <canRenew>0</canRenew>
Line 133: Line 144:
             <activeDate>2010-04-20 17:12:51</activeDate>
             <activeDate>2010-04-20 17:12:51</activeDate>
             <expirationDate>2011-04-20 15:12:50</expirationDate>
             <expirationDate>2011-04-20 15:12:50</expirationDate>
-
             <renewalDate>2011-04-20 15:12:50</renewalDate>
+
             <expirationDateOpenprovider>2011-04-20 15:12:50</expirationDateOpenprovider>
             <status>ACT</status>
             <status>ACT</status>
             <canRenew>0</canRenew>
             <canRenew>0</canRenew>
Line 169: Line 180:
             <activeDate />
             <activeDate />
             <expirationDate>2011-03-15 16:50:19</expirationDate>
             <expirationDate>2011-03-15 16:50:19</expirationDate>
-
             <renewalDate />
+
             <expirationDateOpenprovider />
             <status>FAI</status>
             <status>FAI</status>
             <canRenew>0</canRenew>
             <canRenew>0</canRenew>

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