Loading

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.

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.