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 REST
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 REST, you need to obtain an authentication token, which lasts for twenty four hours. Simply place your userid/password into the header and make the following POST call:
POST https://direct.dnb.com/Authentication/V2.0/ x-dnb-user: MyUsername x-dnb-pwd: MyPassword [BODY] TransactionDetail: { "ApplicationTransactionID": "{user-defined}", "ServiceTransactionID": "{user-defined}", "TransactionTimestamp": "2001-12-17T09:30:47Z" }
Copy the Authorization: value in the response, and include it in the header of subsequent calls. 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, which is currently at {version} "5.0".
GET https://direct.dnb.com/V{version}/organizations?CountryISOAlpha2Code=US&SubjectName=GORMAN%20MANUFACTURING&match=true&MatchTypeText=Advanced&TerritoryName=CA Authorization: My Token
The JSON 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, which is currently at {version} "5.0".
GET https://direct.dnb.com/V{version}/organizations/804735132/products/DCP_STD Authorization: My Token
The JSON 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.