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

AssertionDescription
test.companyDomainVerifiedPass if the minimum threshold set up in config set or property is met; else, fail
test.companyStreetNumberVerifiedDoes the provided Street Number match the Street Number on file?
test.companyStreetNameVerifiedDoes the provided Street Name match the Street Name on file?
test.companyCityVerifiedDoes the provided City match the City on file?
test.companyZipCodeVerifiedDoes the provided Postal Code match the Postal Code on file?
test.companyPOBoxVerifiedDoes the provided PO Box match the PO Box on file?


Acquired Attributes

Acquired AttributeDescription
Acquired Company AddressThe company address as registered with Dun & Bradstreet.
Acquired Company PhoneThe company phone as registered with Dun & Bradstreet.
Acquired Company NameThe company name as registered with Dun & Bradstreet.
Confidence ScoreIndicates the reliability of a matched customer record, on a scale of 00 to 10.
DUNS Control Status DNB CodeAn identifier used by Dun & Bradstreet to represent or categorize a business within its systems.
DUNS Control StatusA unique nine-digit identifier that anchors all data related to a specific business entity in the D&B Data Cloud
DUNS NumberThe 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 PrincipalsReturns the Company's most senior principals (list of names)