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.