Dun and Bradstreet
Dun & Bradstreet (D&B) provides a service that takes an email address as input and returns detailed information about the associated company. This includes the D-U-N-S® Number (a unique business identifier), company name, address, and phone number.
If the request body also includes a company name and address, D&B performs a data validation and matching process, comparing the submitted information against its records. The service then returns a match evaluation, indicating how closely the provided data aligns with D&B’s authoritative company data.
API Integration
1. Get Access Token
(POST) https://api.preprod.iddataweb.com/v1/token
API Reference: https://docs.iddataweb.com/reference/auth
This access token is used to authenticate your requests.
Click here to locate your workflow's access keys
Then, to request an access token:
var axios = require('axios')
var user = 'Your Service API Key';
var password = 'Your Service Shared Secret';
var base64encodedData = Buffer.from(user + ':' + password).toString('base64');
var request = async () => {
var response = await axios({
url: 'https://api.preprod.iddataweb.com/v1/token',
method: 'post',
params: {
grant_type: 'client_credentials'
},
headers: {
'Content-Type': 'application/json',
'Cache-Control': 'no-cache',
Authorization: 'Basic ' + base64encodedData
}
})
console.log(response.data)
}
request();
Response
{
"errorCode": "",
"errorDescription": "",
"access_token": "TjZK7NSjw45AxGK9UhOE9uJDaZT23gKYuUC-9GMTAgLU", // your access token
"expires_in": "1800",
"token_type": "Bearer"
}
2. Collect Your Business Attributes
(POST) https://api.preprod.iddataweb.com/v1/slverify
/slverify
collects a business’s public information and phone number, then matches them to a single identity using data from Dun & Bradstreet and other third-party vendors.
API Reference: https://docs.iddataweb.com/v1.0/reference/slverify
Request:
var axios = require('axios')
var token = 'YOUR_BEARER_TOKEN' // -- obtained from step 1 --
var data = {
"apikey": "YOUR_API_KEY",
"credential": "USERNAME/UNIQUE-ID",
"appID": "YOUR_APPLICATION_NAME",
"userAttributes": [
{
"attributeType": "Email",
"values": {
"email": "[email protected]"
}
},
{
"attributeType": "CompanyName",
"values": {
"alphanumeric": "IDDataweb"
}
},
{
"attributeType": "InternationalAddress",
"values": {
"country": "US",
"locality": "Vienna",
"route": "Boone Blvd",
"administrative_area_level_1": "VA",
"street_number": "8330",
"postal_code": "22182"
}
},
{
"attributeType": "InternationalTelephone",
"values": {
"dialCode": "1",
"telephone": "7039425800"
}
}
]
}
var request = async () => {
var response = await axios({
url: 'https://api.preprod.iddataweb.com/v1/slverify',
method: 'post',
data: data,
headers: {
'Content-Type': 'application/json',
'Cache-Control': 'no-cache',
Authorization: 'Bearer ' + token
}
})
console.log(response.data)
}
request();
Response:
{
"errorCode": "",
"errorDescription": "",
"transaction_id": "1be7abc3-ec72-4c9a-82fc-c52d50364f13",
"userAttributes": [
{
"attributeType": "CompanyName",
"dateCreated": "03/12/2024 20:00:31",
"values": {
"alphanumeric": "Iddataweb"
}
},
{
"attributeType": "InternationalAddress",
"dateCreated": "03/12/2024 20:00:31",
"values": {
"country": "US",
"sublocality": null,
"locality": "Tysons",
"subpremise": null,
"sublocality_level_2": null,
"route": "Boone Blvd",
"administrative_area_level_2": null,
"premise": null,
"sublocality_level_5": null,
"administrative_area_level_3": null,
"sublocality_level_4": null,
"sublocality_level_3": null,
"administrative_area_level_1": "VA",
"street_number": "8330",
"neighborhood": null,
"postal_code": "22182"
}
},
{
"dateCreated": "09/02/2025 16:38:12 UTC",
"attributeType": "Email",
"values": {
"email": "[email protected]"
}
}
],
"acquiredAttributes": [
{
"provider": "Dun and Bradstreet",
"serviceOffering": "Dnb Direct Plus Cleanse Match",
"attributeType": "AcquiredCompanyAddress",
"dateCreated": "03/12/2024 20:00:31",
"values": {
"country": "United States",
"address": "8330 Boone Blvd Ste 400",
"locality": "Vienna",
"postal_code": "22182"
}
},
{
"provider": "Dun and Bradstreet",
"serviceOffering": "Dnb Direct Plus Cleanse Match",
"attributeType": "DUNSNumber",
"dateCreated": "03/12/2024 20:00:31",
"values": {
"dunsNumber": "078402094"
}
},
{
"provider": "Dun and Bradstreet",
"serviceOffering": "Dnb Direct Plus Cleanse Match",
"attributeType": "isPhoneUnreachable",
"dateCreated": "03/12/2024 20:00:31",
"values": {
"isPhoneUnreachable": "false"
}
},
{
"provider": "Dun and Bradstreet",
"serviceOffering": "Dnb Direct Plus Cleanse Match",
"attributeType": "dunsControlStatusDnbCode",
"dateCreated": "03/12/2024 20:00:31",
"values": {
"dunsControlStatusDnbCode": "9074"
}
},
{
"provider": "Dun and Bradstreet",
"serviceOffering": "Dnb Direct Plus Cleanse Match",
"attributeType": "dunsControlStatusOperatingStatus",
"dateCreated": "03/12/2024 20:00:31",
"values": {
"dunsControlStatusOperatingStatus": "Active"
}
},
{
"provider": "Dun and Bradstreet",
"serviceOffering": "Dnb Direct Plus Cleanse Match",
"attributeType": "confidenceCode",
"dateCreated": "03/12/2024 20:00:31",
"values": {
"confidenceCode": "10"
}
},
{
"provider": "Dun and Bradstreet",
"serviceOffering": "Dnb Direct Plus Cleanse Match",
"attributeType": "AcquiredCompanyName",
"dateCreated": "03/12/2024 20:00:31",
"values": {
"acquiredCompanyName": "ID Dataweb, Inc."
}
},
{
"provider": "Dun and Bradstreet",
"serviceOffering": "Dnb Direct Plus Cleanse Match",
"attributeType": "isMailUndeliverable",
"dateCreated": "03/12/2024 20:00:31",
"values": {
"isMailUndeliverable": "false"
}
},
{
"provider": "Dun and Bradstreet",
"serviceOffering": "Dnb Direct Plus Cleanse Match",
"attributeType": "AcquiredCompanyPhone",
"dateCreated": "03/12/2024 20:00:31",
"values": {
"acquiredCompanyPhone": "7039425800"
}
},
{
"provider": "Dun and Bradstreet",
"serviceOffering": "Dnb Direct Plus Cleanse Match",
"attributeType": "mostSeniorPrincipals",
"dateCreated": "03/12/2024 20:00:31",
"values": {
"mostSeniorPrincipals": "DAVE COXE"
}
},
{
"provider": "Dun and Bradstreet",
"serviceOffering": "Dnb Direct Plus Cleanse Match",
"attributeType": "matchGrade",
"dateCreated": "03/12/2024 20:00:31",
"values": {
"matchGrade": "AAAAAZZAFAZ"
}
}
],
"userAssertionList": [
{
"provider": "Dun and Bradstreet",
"serviceOffering": "Dnb Direct Plus Cleanse Match",
"dateAsserted": "03/12/2024 20:00:31",
"assertions": {
"test.companyPOBoxVerified": "fail",
"test.companyStreetNameVerified": "pass",
"test.companyZipCodeVerified": "pass",
"test.companyStreetNumberVerified": "pass",
"test.companyDomainVerified": "pass",
"test.companyCityVerified": "pass",
"test.companyNameVerified": "pass"
}
}
],
"mbun": "569082a1-9973-4460-b354-af8851e8b006",
"forwardApiKey": "",
"policyObligation": false,
"policyDecision": "approve"
}
Assertions
Assertion | Description |
---|---|
test.companyDomainVerified | Pass if the minimum threshold set up in config set or property is met; else, fail |
test.companyStreetNumberVerified | Does the provided Street Number match the Street Number on file? |
test.companyStreetNameVerified | Does the provided Street Name match the Street Name on file? |
test.companyCityVerified | Does the provided City match the City on file? |
test.companyZipCodeVerified | Does the provided Postal Code match the Postal Code on file? |
test.companyPOBoxVerified | Does the provided PO Box match the PO Box on file? |
Acquired Attributes
Acquired Attribute | Description |
---|---|
Acquired Company Address | The company address as registered with Dun & Bradstreet. |
Acquired Company Phone | The company phone as registered with Dun & Bradstreet. |
Acquired Company Name | The company name as registered with Dun & Bradstreet. |
Confidence Score | Indicates the reliability of a matched customer record, on a scale of 00 to 10. |
DUNS Control Status DNB Code | An identifier used by Dun & Bradstreet to represent or categorize a business within its systems. |
DUNS Control Status | A unique nine-digit identifier that anchors all data related to a specific business entity in the D&B Data Cloud |
DUNS Number | The DUNS number belonging to the Company |
Is Phone Reachable? | True / False: Can the phone number be reached when dialed? |
Is Mail Delivarable? | True / False: Can mail be delivered to the provider address? |
Most Senior Principals | Returns the Company's most senior principals (list of names) |
Updated 15 days ago