Dun & Bradstreet Direct+ API
dnb.com · Company
Business data and analytics APIs from Dun & Bradstreet. Key products for insurance: DUNS Number lookup, business verification, financial strength scores, industry classification, and risk indicators. Used in Guidewire PolicyCenter for commercial lines underwriting — verifying business legitimacy and risk characteristics.
Authentication
Bearer Token
Bearer token obtained by exchanging D&B API key and secret. Token expires in 24 hours. Requires D&B Direct+ subscription.
Sample Requests
GET
Search for a business
Returns matching businesses by name and location. First step to obtain a DUNS Number for detailed lookup.
https://plus.dnb.com/v1/search/companyList?searchTerm=Acme Corporation&addressRegion=TX&addressCountry=US
Hover any highlighted part to learn what it does
Headers — extra info sent with the request
| Authorization | Bearer YOUR_ACCESS_TOKEN |
curl -X GET "https://plus.dnb.com/v1/search/companyList?searchTerm=Acme%20Corporation&addressRegion=TX&addressCountry=US" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
import requests
params = {
"searchTerm": "Acme Corporation",
"addressRegion": "TX",
"addressCountry": "US"
}
headers = {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
response = requests.get(
"https://plus.dnb.com/v1/search/companyList",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://plus.dnb.com/v1/search/companyList');
url.searchParams.set('searchTerm', 'Acme Corporation');
url.searchParams.set('addressRegion', 'TX');
url.searchParams.set('addressCountry', 'US');
const response = await fetch(url, {
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://plus.dnb.com/v1/search/companyList")
q := baseURL.Query()
q.Set("searchTerm", "Acme Corporation")
q.Set("addressRegion", "TX")
q.Set("addressCountry", "US")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
req.Header.Set("Authorization", "Bearer YOUR_ACCESS_TOKEN")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://plus.dnb.com/v1/search/companyList")
uri.query = URI.encode_www_form({
"searchTerm" => "Acme Corporation",
"addressRegion" => "TX",
"addressCountry" => "US"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer YOUR_ACCESS_TOKEN"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://plus.dnb.com/v1/search/companyList?" . http_build_query([
"searchTerm" => "Acme Corporation",
"addressRegion" => "TX",
"addressCountry" => "US"
]);
$opts = ["http" => [
"method" => "GET",
"header" => implode("\r\n", [
"Authorization: Bearer YOUR_ACCESS_TOKEN"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
GET
Get company financial strength
Returns full business profile including D&B Rating, financial strength indicator, and risk scores.
https://plus.dnb.com/v1/data/duns/{dunsNumber}?productId=cmptcs&versionId=v1
Hover any highlighted part to learn what it does
Headers — extra info sent with the request
| Authorization | Bearer YOUR_ACCESS_TOKEN |
curl -X GET "https://plus.dnb.com/v1/data/duns/{dunsNumber}?productId=cmptcs&versionId=v1" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"import requests
params = {
"productId": "cmptcs",
"versionId": "v1"
}
headers = {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
response = requests.get(
"https://plus.dnb.com/v1/data/duns/{dunsNumber}",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://plus.dnb.com/v1/data/duns/{dunsNumber}');
url.searchParams.set('productId', 'cmptcs');
url.searchParams.set('versionId', 'v1');
const response = await fetch(url, {
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://plus.dnb.com/v1/data/duns/{dunsNumber}")
q := baseURL.Query()
q.Set("productId", "cmptcs")
q.Set("versionId", "v1")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
req.Header.Set("Authorization", "Bearer YOUR_ACCESS_TOKEN")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://plus.dnb.com/v1/data/duns/{dunsNumber}")
uri.query = URI.encode_www_form({
"productId" => "cmptcs",
"versionId" => "v1"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer YOUR_ACCESS_TOKEN"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://plus.dnb.com/v1/data/duns/{dunsNumber}?" . http_build_query([
"productId" => "cmptcs",
"versionId" => "v1"
]);
$opts = ["http" => [
"method" => "GET",
"header" => implode("\r\n", [
"Authorization: Bearer YOUR_ACCESS_TOKEN"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- Subscribe to D&B Direct+ at https://www.dnb.com/en-us/solutions/direct.html
- Get API key and secret from D&B Developer portal
- Authenticate: POST https://plus.dnb.com/v2/token with your key:secret as Basic auth
- Use returned access_token as Bearer in subsequent requests
- DUNS Number is the unique identifier — search first, then look up by DUNS
- Products (productId) control which data is returned — cmptcs = company profile
- Guidewire PolicyCenter commercial lines: use D&B for business verification rules
What can you build with Dun & Bradstreet Direct+ API?
Dun & Bradstreet Direct+ API is a Company API. Developers commonly use company APIs for:
- enriching CRM records with company firmographics
- building lead-generation and prospecting tools
- verifying business identity and registration details
- monitoring competitors and market intelligence
- powering B2B data enrichment pipelines
Bearer token. Your app exchanges credentials for a short-lived token, then sends it as an Authorization header. Tokens expire, so your code needs to handle renewal. Dun & Bradstreet Direct+ API is a paid API — check the provider's pricing page before building a production integration.
New to APIs? Read our beginner's guide · Learn about API keys · What is REST?