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.