Cookies Settings

Loading

dnb-logo
Direct 2.0
Collapse

Welcome to D&B Direct 2.0

D&B Direct is an application programming interface that allows you to stream reliable, on-demand business information into enterprise-wide systems, such as Customer Relationship Management (CRM) systems, corporate intranets and web forms, and supply chain management systems or commercial software and web applications.

IMPORTANT: Please see the new Online Services Security Enhancement Release, effective November 09, 2020.

Quick Start using SOAP

Two of the most common uses of the D&B Direct API are locating a D&B D-U-N-S Number, and then obtaining a Detailed Company Profile for a company.

D&B Direct API calls must be made using Secured Socket Layers (SSL).

NOTE: To make either of these calls, you will need D&B Direct credentials. You can obtain sandbox (test environment) credentials by completing a online form.

Before making calls to any D&B Direct function using SOAP, you should download the WSDL file for the respective service. Simply copy the userid/password into the SOAP header.

You'll also need to know what the latest version is for the respective service.

Locating a D-U-N-S Number (often called Match)

This function is part of the Company Service (download WSDL), which is currently at {version} "5.0".

The correct endpoint for this service is https://direct.dnb.com/Company/V{version}.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:com="http://services.dnb.com/CompanyServiceV2.0">
   <soapenv:Header>
      <wsse:Security soapenv:mustUnderstand="0" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
         <wsse:UsernameToken wsu:Id="UsernameToken-11">
            <wsse:Username>MyUserName</wsse:Username>
            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">MyPassword</wsse:Password>
         </wsse:UsernameToken>
      </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
      <com:MatchRequest ServiceVersionNumber="{version}">
         <MatchRequestDetail>
            <InquiryDetail>
               <DUNSNumber>804735132</DUNSNumber>
            </InquiryDetail>
            <MatchSpecification>
               <MatchTypeText>Basic</MatchTypeText>
            </MatchSpecification>
         </MatchRequestDetail>
      </com:MatchRequest>
   </soapenv:Body>
</soapenv:Envelope>

The XML response for this function will return a static response in the sandbox (test environment). Did you try it? Here's what you should have received.

Obtaining a Detailed Company Profile

This function is part of the Firmographic Product Service (download WSDL), which is currently at {version} "5.0".

The correct endpoint for this service is https://direct.dnb.com/FirmographicsProduct/V{version}.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:fir="http://services.dnb.com/FirmographicsProductServiceV2.0">
   <soapenv:Header>
      <wsse:Security soapenv:mustUnderstand="0" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
         <wsse:UsernameToken wsu:Id="UsernameToken-11">
            <wsse:Username>MyUserName</wsse:Username>
            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">MyPassword</wsse:Password>
         </wsse:UsernameToken>
      </wsse:Security> 
   </soapenv:Header>
   <soapenv:Body>
      <fir:OrderProductRequest ServiceVersionNumber="{version}">
         <OrderProductRequestDetail>
            <InquiryDetail>
               <DUNSNumber>804735132</DUNSNumber>
            </InquiryDetail>
            <ProductSpecification>
               <DNBProductID>DCP_ENH</DNBProductID>              
            </ProductSpecification>
            <InquiryReferenceDetail>
               <CustomerReferenceText>Sample SG Request</CustomerReferenceText>
            </InquiryReferenceDetail>            
         </OrderProductRequestDetail>
      </fir:OrderProductRequest>
   </soapenv:Body>
</soapenv:Envelope>

The XML response for this function will return the profile for Gorman Manufacturing Company, Inc. (D&B's fictional test company) in the sandbox (test environment). Did you try it? Here's what you should have received.

NOTE: A set of D-U-N-S Numbers is available to D&B Direct 2.0 customers for performing non-billable transactions in the production environment.

Disclaimer

The copyright of the report on Chinese businesses in this product belongs to Shanghai Dun & Bradstreet and this product shall only be internally used by the customer who subscribes for this report. Without prior written consent of Shanghai Dun & Bradstreet, this product may not be reproduced, extracted, provided or resold in whole or in part in any form. This product can only be used for legitimate purposes and shall not be used for illegal purposes such as endangering national security and public interests and infringing on the legitimate rights and interests of citizens or organizations. This product shall not be used for personal, family or household credit or insurance, or for employment. Due to the limitation of information sources and the fact that some information cannot be controlled and verified by Shanghai Dun & Bradstreet, Shanghai Dun & Bradstreet cannot guarantee the accuracy, completeness, or timeliness of the information provided. This product is for customer's reference only. Shanghai Dun & Bradstreet does not bear any commercial risks of customers and shall not be liable for any loss or injury whatsoever resulting from contingencies beyond its control or from negligence.