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.

Best Practices and How to Interpret Your Results

👍
Recommended: Use Strong Attributes.
Examples:

✅ DUNS Number

✅ Company Registration Number

For confidence, you can focus on:

Assertion: test.companyDomainVerified

Acquired Attribute: confidenceCode

📘
Using Combinations of other Business-related Attributes.
Examples (used in combination):

Name

Address

Phone

Email

Users in this case should primarily rely on:

Assertion:test.companyDomainVerified

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. Place this token in the header of each subsequent request. See the postman project above for examples.

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 personal 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

📘
For guidance on which assertions to prioritize, see: best practices

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

📘
For guidance on which acquired attributes to prioritize, see: best practices

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)