Fetch Dun & Bradstreet details

curl --request POST \
  --url https://api.example.com/v1/dnb \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "url": "https://www.example.com",
  "company_name": "Acme Inc",
  "address": "123 Main St, Springfield, IL 62701",
  "dnb_link": "https://www.dnb.com/business-directory/company-profiles.acme_inc.html",
  "encrypted_duns": "abc123",
  "duns_number": "123456789",
  "industry": "Manufacturing",
  "industries": [
    "Manufacturing",
    "Industrial Equipment"
  ],
  "city": "Springfield",
  "state": "IL",
  "zip_code": "62701",
  "country": "United States",
  "contact_name": "Jane Smith",
  "contact_first_name": "Jane",
  "contact_last_name": "Smith",
  "contact_title": "President",
  "contact_suffix": "Jr",
  "location_type": "Headquarters",
  "private_company": true,
  "address_unverified": false,
  "annual_revenue": ">1000000",
  "annual_revenue_year": ">=2024",
  "number_of_employees_this_site": ">50",
  "number_of_employees_consolidated": ">250",
  "total_contacts": ">0",
  "total_principals": ">0"
}
'

{
  "success": true,
  "records": [
    {
      "record_id": "abc123",
      "company_name": "Acme Inc",
      "dnb_link": "dnb.com/business-directory/company-profiles.acme_inc.html",
      "duns_number": "123456789",
      "encrypted_duns": "encrypted-id",
      "base_url": "example.com",
      "website_url": "example.com",
      "industry": "Manufacturing",
      "industries": [
        "Manufacturing"
      ],
      "address": "123 Main St",
      "city": "Springfield",
      "state": "IL",
      "zip_code": "62701",
      "country": "United States",
      "annual_revenue": 2500000,
      "contact_name": "Jane Smith",
      "contact_title": "President"
    }
  ],
  "total_records": 1
}

Dun & Bradstreet

Fetch Dun & Bradstreet details

Fetch Dun & Bradstreet (D&B) company and contact details.

You can search by any combination of the following fields, but at least one field is required:

url
company_name
address
dnb_link
encrypted_duns
duns_number
industry / industries
city, state, zip_code, country
contact fields
revenue, employee, and record-count filters

The response includes a records array of matching D&B records. The total_records field specifies the number of matches returned.

POST

dnb

Fetch Dun & Bradstreet details

curl --request POST \
  --url https://api.example.com/v1/dnb \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "url": "https://www.example.com",
  "company_name": "Acme Inc",
  "address": "123 Main St, Springfield, IL 62701",
  "dnb_link": "https://www.dnb.com/business-directory/company-profiles.acme_inc.html",
  "encrypted_duns": "abc123",
  "duns_number": "123456789",
  "industry": "Manufacturing",
  "industries": [
    "Manufacturing",
    "Industrial Equipment"
  ],
  "city": "Springfield",
  "state": "IL",
  "zip_code": "62701",
  "country": "United States",
  "contact_name": "Jane Smith",
  "contact_first_name": "Jane",
  "contact_last_name": "Smith",
  "contact_title": "President",
  "contact_suffix": "Jr",
  "location_type": "Headquarters",
  "private_company": true,
  "address_unverified": false,
  "annual_revenue": ">1000000",
  "annual_revenue_year": ">=2024",
  "number_of_employees_this_site": ">50",
  "number_of_employees_consolidated": ">250",
  "total_contacts": ">0",
  "total_principals": ">0"
}
'

{
  "success": true,
  "records": [
    {
      "record_id": "abc123",
      "company_name": "Acme Inc",
      "dnb_link": "dnb.com/business-directory/company-profiles.acme_inc.html",
      "duns_number": "123456789",
      "encrypted_duns": "encrypted-id",
      "base_url": "example.com",
      "website_url": "example.com",
      "industry": "Manufacturing",
      "industries": [
        "Manufacturing"
      ],
      "address": "123 Main St",
      "city": "Springfield",
      "state": "IL",
      "zip_code": "62701",
      "country": "United States",
      "annual_revenue": 2500000,
      "contact_name": "Jane Smith",
      "contact_title": "President"
    }
  ],
  "total_records": 1
}

Authorizations

X-API-Key

string

header

required

Body

application/json

url

string | null

Company URL (may include or omit the http/https prefix)

Example:

"https://www.example.com"

company_name

string | null

Company name

Example:

"Acme Inc"

address

string | null

Company address

Example:

"123 Main St, Springfield, IL 62701"

dnb_link

string | null

Direct D&B profile link

Example:

"https://www.dnb.com/business-directory/company-profiles.acme_inc.html"

encrypted_duns

string | null

Encrypted D-U-N-S identifier

Example:

"abc123"

duns_number

string | null

D-U-N-S number

Example:

"123456789"

industry

string | null

Primary industry

Example:

"Manufacturing"

industries

string[] | null

List of industries to match

Example:

["Manufacturing", "Industrial Equipment"]

city

string | null

City

Example:

"Springfield"

state

string | null

State or province

Example:

"IL"

zip_code

string | null

ZIP or postal code

Example:

"62701"

country

string | null

Country

Example:

"United States"

contact_name

string | null

Contact name

Example:

"Jane Smith"

contact_first_name

string | null

Contact first name

Example:

"Jane"

contact_last_name

string | null

Contact last name

Example:

"Smith"

contact_title

string | null

Contact title

Example:

"President"

contact_suffix

string | null

Contact suffix

Example:

"Jr"

location_type

string | null

Location type

Example:

"Headquarters"

private_company

boolean | null

If true, only return private companies

Example:

true

address_unverified

boolean | null

If true, only return records with unverified addresses

Example:

false

annual_revenue

string | null

Annual revenue filter. Supports exact values or >, >=, <, <= comparisons.

Example:

">1000000"

annual_revenue_year

string | null

Annual revenue year filter. Supports exact values or >, >=, <, <= comparisons.

Example:

">=2024"

number_of_employees_this_site

string | null

This-site employee count filter. Supports exact values or >, >=, <, <= comparisons.

Example:

">50"

number_of_employees_consolidated

string | null

Consolidated employee count filter. Supports exact values or >, >=, <, <= comparisons.

Example:

">250"

total_contacts

string | null

Total contacts filter. Supports exact values or >, >=, <, <= comparisons.

Example:

">0"

total_principals

string | null

Total principals filter. Supports exact values or >, >=, <, <= comparisons.

Example:

">0"

Response

Successful Response

Last modified on June 8, 2026

Bulk Enrich Contacts Fetch Dun & Bradstreet details

⌘I