D&B Direct Documentation

REST Version 1.0

By D&B SparkLab - Customer Solutions Lab

Overview

Endpoints & WADL

Partially Scrambled Sandbox API (Use your "Sales and Marketing API - Sandbox" credentials)

WADL http://api.dnbdirectapps.com/dev/DnBAPI-10/rest/application.wadl
Endpoint http://api.dnbdirectapps.com/dev/DnBAPI-10/rest

Legacy Scrambled Sandbox API (Use your "Sales and Marketing API - Sandbox" credentials)

WADL http://dnbdirect-sandbox.dnb.com/DnBAPI-10/rest/application.wadl
Endpoint http://dnbdirect-sandbox.dnb.com/DnBAPI-10/rest

Production API (Use your "Sales and Marketing API - Production" credentials)

WADL http://dnbdirect-api.dnb.com/DnBAPI-10/rest/application.wadl
Endpoint http://dnbdirect-api.dnb.com/DnBAPI-10/rest

For SSL, substitute https for http in the endpoint URLs.

Services

Primary Entity Service Name Package REST Resource SOAP Method
Company Get Company Detail Add-on: Full Company Profile company/{unique_id} GetCompanyDetail
Company Get Company Financial Summary Add-on: Advanced Financial Information company/{unique_id}/financial/summary GetCompanyFinancialSummary
Company Get Family Tree Add-on: Family Tree Information company/familytree/{unique_id} GetFamilyTree
Company Find Company Cleanse Match Add-on: Match Service company/findcompanycleansematch FindCompanyCleanseMatch
Company Find Company by Keyword Base Package search/company/{keyword} FindCompanyByKeyword
Company Advanced Company Search Base Package search/company/advanced AdvancedCompanySearch
Person Get Person Detail Base Package person/{unique_company_id}/{co_official_id} GetPersonDetail

Sample Code

Sample code, which demonstrates how to consume the D&B Direct API, is available for multiple development environments.

Authentication

All API calls require the following credentials to be sent in the HTTP request header:

Name
API-KEY
username
password
CURL example
curl -H 'API-KEY:Enter_your_API_KEY_here'\
     -H 'username:Enter_your_API_username_here'\
     -H 'password:Enter_your_API_password_here'\
     'http://dnbdirect-api.dnb.com/DnBAPI-10/rest/company/884114609'
Python example
import urllib2
req = urllib2.Request('http://dnbdirect-api.dnb.com/DnBAPI-10/rest/company/884114609')
req.add_header('API-KEY', 'Enter_your_API_KEY_here')
req.add_header('username', 'Enter_your_API_username_here')
req.add_header('password', 'Enter_your_API_password_here')
req.add_header('Accept-Encoding', 'UTF-8')
req.add_header('Content-Type', 'application/json')
req.add_header('Accept', '*/*')
resp = urllib2.urlopen(req)
resp = resp.read()
print resp
PHP example
$opts = array(
  'http'=>array(
    'method'=>'GET',
    'ignore_errors' => true,
    'header'=>"API-KEY: Enter_your_API_KEY_here\r\nusername: Enter_your_API_username_here\r\npassword:Enter_your_API_password_here",
    )
  );
$fp = fopen('http://dnbdirect-api.dnb.com/DnBAPI-10/rest/company/884114609', 'rb', false, stream_context_create($opts));
$response = stream_get_contents($fp);
print $response;

Resources

/company/{unique_id} Available in Add-on: Full Company Profile

Returns detailed company information for a single company."

Representation

/company/{unique_id}
?view={view}

URL Parameters

Element Type Notes
unique_id Number Required D-U-N-S number or companyId
view String (full | simple | optional)

Sample Request

URL
GET /company/884114609

Sample Response

{
  "otherURLs": {
    "url": []
  }, 
  "manufacturingIndicator": "", 
  "bankName": "", 
  "marketingPreScreenScore": "L", 
  "phones": {
    "phoneNumber": [
      {
        "areaCode": "973", 
        "doNotCallRegistry": false, 
        "phoneNumber": "921-5500", 
        "countryCode": ""
      }, 
      {
        "areaCode": "800", 
        "doNotCallRegistry": false, 
        "phoneNumber": "234-3867", 
        "countryCode": ""
      }
    ], 
    "faxNumber": []
  }, 
  "nonMarketableCompany": null, 
  "parentName": "The Dun & Bradstreet Corporation", 
  "locations": {
    "location": [
      {
        "city": "Short Hills", 
        "addressType": "PRIMARY_ADDRESS", 
        "countryId": 76, 
        "stateOfIncorporation": "DE", 
        "zip": "07078", 
        "country": "United States", 
        "address2": "", 
        "longitude": -74.354241, 
        "county": "Essex County", 
        "state": "NJ", 
        "address1": "103 Jfk Pkwy.", 
        "latitude": 40.742396, 
        "metroArea": "New York-Northern New Jersey-Long Island NY-NJ-PA", 
        "latLongAccuracy": "0", 
        "zip4": ""
      }
    ]
  }, 
  "yearFounded": "1841", 
  "foreignTrades": null, 
  "keyNumbersHistory": {
    "quarterlyKeyNumbersHistory": {
      "keyNumbers": [
        {
          "salesAccuracy": null, 
          "employeesAtThisLocationAccuracy": null, 
          "employeesTotalAccuracy": null, 
          "sales": 383.9, 
          "periodEndMonth": "Jun 2012", 
          "employeesTotal": null, 
          "researchAndDevelopment": null, 
          "advertising": null, 
          "employeesAtThisLocation": null, 
          "totalEmployeeGrowthPercent": null, 
          "fiscalPeriod": "2Q2012"
        }, 
        {
          "salesAccuracy": null, 
          "employeesAtThisLocationAccuracy": null, 
          "employeesTotalAccuracy": null, 
          "sales": 402.8, 
          "periodEndMonth": "Mar 2012", 
          "employeesTotal": null, 
          "researchAndDevelopment": null, 
          "advertising": null, 
          "employeesAtThisLocation": null, 
          "totalEmployeeGrowthPercent": null, 
          "fiscalPeriod": "1Q2012"
        }, 
        ...
      ]
    }, 
    "annualKeyNumbersHistory": {
      "keyNumbers": [
        {
          "salesAccuracy": null, 
          "employeesAtThisLocationAccuracy": null, 
          "employeesTotalAccuracy": null, 
          "sales": null, 
          "periodEndMonth": "", 
          "employeesTotal": null, 
          "researchAndDevelopment": null, 
          "advertising": null, 
          "employeesAtThisLocation": 48, 
          "totalEmployeeGrowthPercent": null, 
          "fiscalPeriod": "FY"
        }, 
        {
          "salesAccuracy": null, 
          "employeesAtThisLocationAccuracy": null, 
          "employeesTotalAccuracy": null, 
          "sales": 1758.5, 
          "periodEndMonth": "Dec 2011", 
          "employeesTotal": 5100, 
          "researchAndDevelopment": null, 
          "advertising": null, 
          "employeesAtThisLocation": null, 
          "totalEmployeeGrowthPercent": -1.92, 
          "fiscalPeriod": "FY2011"
        }, 
        ...
      ]
    }
  }, 
  "fein": null, 
  "legalStatus": "Corporation", 
  "companyType": "PUBLIC", 
  "historicalText": "", 
  "industries": {
    "primaryDnBIC": "1849", 
    "primaryUKSIC": "74.871", 
    "allNAICS": {
      "item": [
        {
          "description": "Internet Publishing and Broadcasting and Web Searc...", 
          "naics": "519130"
        }, 
        {
          "description": "All Other Information Services", 
          "naics": "519190"
        }, 
        ...
      ]
    }, 
    "allUSSIC": {
      "item": [
        {
          "ussic": "87320000", 
          "description": "Commercial nonphysical research"
        }, 
        {
          "ussic": "73230000", 
          "description": "Credit reporting services"
        }, 
        ...
      ]
    }, 
    "lineOfBusiness": "Credit reporting services", 
    "primaryNAICS": "524298", 
    "allUKSIC": {
      "item": [
        {
          "uksic": "74.871", 
          "description": "Credit reporting and collection agency activities"
        }, 
        {
          "uksic": "72.300", 
          "description": "Data processing"
        }, 
        ...
      ]
    }, 
    "allDnBIC": {
      "item": [
        {
          "dnbic": "1058", 
          "description": "Market Research & Polling Services"
        }, 
        {
          "dnbic": "1424", 
          "description": "Insurance Agencies & Brokerages"
        }, 
        ...
      ]
    }, 
    "primaryUSSIC": "73230000"
  }, 
  "dbaNames": {
    "dba": [
      "D&B"
    ]
  }, 
  "legalStructureDescription": null, 
  "companyId": 10483000000000, 
  "rankings": {
    "rank": [
      {
        "definition": "S&P 500 (October 1, 2012)", 
        "rankNumber": null
      }, 
      {
        "definition": "FORTUNE 1000 (May 2012)", 
        "rankNumber": 996
      }
    ]
  }, 
  "ukSpecs": {
    "ukRegistration": null, 
    "ukVAT": null, 
    "numberOfSubsidiaries": null
  }, 
  "minorityOwned": false, 
  "ownershipYear": "1841", 
  "topExecutives": {
    "official": [
      {
        "person": {
          "suffix": "", 
          "firstName": "Sara", 
          "middleName": "S.", 
          "lastName": "Mathew", 
          "age": 56, 
          "prefix": "Ms.", 
          "fullName": "Sara S. Mathew"
        }, 
        "connectMail": {
          "connectMailEmailSource": true, 
          "connectMailSource": "D&B", 
          "connectMailNameSource": false, 
          "connectMailPhoneSource": false
        }, 
        "latestPosition": {
          "jobFunction": {
            "jobFunctionId": [
              15, 
              55
            ]
          }, 
          "endYear": "Present", 
          "startYear": "2010", 
          "title": "Chairman and CEO"
        }, 
        "coOfficialId": 1073021000000000, 
        "latestSalary": {
          "salary": 800000.0, 
          "bonus": null, 
          "totalSalary": 6666922.0, 
          "year": 2011
        }
      }, 
      {
        "person": {
          "suffix": "", 
          "firstName": "Richard", 
          "middleName": "H.", 
          "lastName": "Veldran", 
          "age": 45, 
          "prefix": "Mr.", 
          "fullName": "Richard H. Veldran"
        }, 
        "connectMail": {
          "connectMailEmailSource": true, 
          "connectMailSource": "D&B", 
          "connectMailNameSource": false, 
          "connectMailPhoneSource": false
        }, 
        "latestPosition": {
          "jobFunction": {
            "jobFunctionId": [
              195, 
              25
            ]
          }, 
          "endYear": "Present", 
          "startYear": "2011", 
          "title": "SVP and CFO"
        }, 
        "coOfficialId": 2301455000000000, 
        "latestSalary": {
          "salary": 361250.0, 
          "bonus": null, 
          "totalSalary": 1486303.0, 
          "year": 2011
        }
      }, 
      ...
    ]
  }, 
  "ethnicity": "Unknown", 
  "accountingFirm": "Pricewaterhousecoopers LLP", 
  "historicalIndicator": false, 
  "ultimateDomesticParentName": null, 
  "vat": null, 
  "spaceAtAddress": 123000, 
  "keyFinancials": {
    "incomeAssets": {
      "netIncome": 260.3, 
      "netIncomeGrowthPercent": 3.25, 
      "period": "FY2011", 
      "salesGrowthPercent": 4.88, 
      "assets": 1977.1
    }, 
    "marketValueInfo": {
      "marketValue": 3722.9619, 
      "marketValueDate": "2012-10-05"
    }
  }, 
  "numberOfPCs": null, 
  "primaryURLs": {
    "primaryUrl": [
      {
        "url": "http://www.dnb.com", 
        "sortOrder": 0
      }
    ]
  }, 
  "legalStructureCode": null, 
  "ultimateParentName": "The Dun & Bradstreet Corporation", 
  "ultimateDomesticParent": null, 
  "smallBusinessIndicator": null, 
  "subsidiaryStatus": false, 
  "duns": "884114609", 
  "spaceAtAddressUnitOfMeasurement": "sq ft", 
  "stocks": {
    "tickerUS": "DNB", 
    "exchangeInfoList": {
      "exchangeInfo": [
        {
          "country": "United States", 
          "exchangeName": "BATS", 
          "tickerSymbol": "DNB"
        }, 
        {
          "country": "United States", 
          "exchangeName": "BATS CTA", 
          "tickerSymbol": "DNB"
        }, 
        ...
      ]
    }, 
    "exchangePrimary": null
  }, 
  "spaceAtAddressAccuracy": 0, 
  "ultimateParentDuns": "884114609", 
  "name": "The Dun & Bradstreet Corporation", 
  "locationType": "HEADQUARTERS", 
  "fullDescription": "<p>For The Dun &amp; Bradstreet Corporation, there...", 
  "franchiseOperationType": "", 
  "synopsis": "<p>For The Dun &amp; Bradstreet Corporation, there...", 
  "parentDuns": "884114609", 
  "womenOwned": false, 
  "crn": null, 
  "ownedOrLeased": "Location Is Rented By This Company"
}

CURL Example

curl -H 'Accept: application/json'\
     -H 'Content-type: application/json'\
     -H 'API-KEY:YOUR-API-KEY-HERE'\
     -H 'username:YOUR-USERNAME-HERE'\
     -H 'password:YOUR-PASSWORD-HERE'\
     'http://dnbdirect-api.dnb.com/DnBAPI-10/rest/company/884114609'

/company/{unique_id}/financial/summary Available in Add-on: Advanced Financial Information

This call returns a summary of finalized financial data for a given company."

Representation

/company/{unique_id}/financial/summary

URL Parameters

none

Sample Request

URL
GET /company/884114609/financial/summary

Sample Response

{
  "quarterlyBalanceSheets": {
    "previousQuarters": [
      {
        "liabilities": {
          "currentLiabilities": {
            "otherCurrentLiabilities": 854.0, 
            "shortTermDebt": 1.0, 
            "accountsPayable": 40.7
          }, 
          "liabilitySummary": {
            "totalCurrentLiabilities": 895.7, 
            "totalLiabilities": 2536.1, 
            "otherNonCurrentLiabilities": 798.6, 
            "longTermDebt": 841.8
          }
        }, 
        "assets": {
          "assetSummary": {
            "otherNonCurrentAssets": 1225.5, 
            "totalCurrentAssets": 634.7, 
            "netFixedAssets": 43.6, 
            "totalAssets": 1903.8
          }, 
          "currentAssets": {
            "netReceivables": 442.6, 
            "inventories": null, 
            "cash": 117.7, 
            "otherIncomeAssets": 74.4
          }
        }, 
        "quarterYear": "2012", 
        "quarterMonth": "March", 
        "shareholdersEquity": {
          "equitySummary": {
            "totalEquity": -632.3, 
            "sharesOutstanding": 47.86
          }, 
          "equity": {
            "preferredStockEquity": 0.0, 
            "commonStockEquity": -632.3
          }
        }, 
        "year": null
      }, 
      {
        "liabilities": {
          "currentLiabilities": {
            "otherCurrentLiabilities": 916.0, 
            "shortTermDebt": 1.1, 
            "accountsPayable": 36.4
          }, 
          "liabilitySummary": {
            "totalCurrentLiabilities": 953.5, 
            "totalLiabilities": 2721.0, 
            "otherNonCurrentLiabilities": 803.6, 
            "longTermDebt": 963.9
          }
        }, 
        "assets": {
          "assetSummary": {
            "otherNonCurrentAssets": 1204.5, 
            "totalCurrentAssets": 726.9, 
            "netFixedAssets": 45.7, 
            "totalAssets": 1977.1
          }, 
          "currentAssets": {
            "netReceivables": 513.2, 
            "inventories": null, 
            "cash": 84.4, 
            "otherIncomeAssets": 129.3
          }
        }, 
        "quarterYear": "2011", 
        "quarterMonth": "December", 
        "shareholdersEquity": {
          "equitySummary": {
            "totalEquity": -743.9, 
            "sharesOutstanding": 47.7
          }, 
          "equity": {
            "preferredStockEquity": 0.0, 
            "commonStockEquity": -743.9
          }
        }, 
        "year": null
      }
    ], 
    "latestQuarter": {
      "liabilities": {
        "currentLiabilities": {
          "otherCurrentLiabilities": 771.8, 
          "shortTermDebt": 400.6, 
          "accountsPayable": 49.0
        }, 
        "liabilitySummary": {
          "totalCurrentLiabilities": 1221.4, 
          "totalLiabilities": 2621.3, 
          "otherNonCurrentLiabilities": 786.9, 
          "longTermDebt": 613.0
        }
      }, 
      "assets": {
        "assetSummary": {
          "otherNonCurrentAssets": 1189.8, 
          "totalCurrentAssets": 565.8, 
          "netFixedAssets": 40.0, 
          "totalAssets": 1795.6
        }, 
        "currentAssets": {
          "netReceivables": 374.5, 
          "inventories": null, 
          "cash": 118.6, 
          "otherIncomeAssets": 72.7
        }
      }, 
      "quarterYear": "2012", 
      "quarterMonth": "June", 
      "shareholdersEquity": {
        "equitySummary": {
          "totalEquity": -825.7, 
          "sharesOutstanding": 44.88
        }, 
        "equity": {
          "preferredStockEquity": 0.0, 
          "commonStockEquity": -825.7
        }
      }, 
      "year": null
    }
  }, 
  "quarterlyCashFlowStatements": {
    "previousQuarters": [
      {
        "netCashProvidedByInvestingActivities": -1.4, 
        "cashAndCashEquivalentsAtTheEndOfTheQuarter": 117.7, 
        "cashAndCashEquivalentsAtTheBeginningOfTheQuarter": 84.4, 
        "quarterYear": "2012", 
        "netCashProvidedByOperatingActivities": 167.3, 
        "quarterMonth": "March", 
        "netIncreaseDecreaseInCashAndCashEquivalents": 33.3, 
        "netCashProvidedByFinancingActivities": -134.0, 
        "capitalExpenditure": -15.3
      }, 
      {
        "netCashProvidedByInvestingActivities": -73.4, 
        "cashAndCashEquivalentsAtTheEndOfTheQuarter": 84.4, 
        "cashAndCashEquivalentsAtTheBeginningOfTheQuarter": 89.5, 
        "quarterYear": "2011", 
        "netCashProvidedByOperatingActivities": 312.9, 
        "quarterMonth": "December", 
        "netIncreaseDecreaseInCashAndCashEquivalents": 5.9, 
        "netCashProvidedByFinancingActivities": -238.0, 
        "capitalExpenditure": -53.4
      }, 
      ...
    ], 
    "latestQuarter": {
      "netCashProvidedByInvestingActivities": -24.4, 
      "cashAndCashEquivalentsAtTheEndOfTheQuarter": 118.6, 
      "cashAndCashEquivalentsAtTheBeginningOfTheQuarter": 117.7, 
      "quarterYear": "2012", 
      "netCashProvidedByOperatingActivities": 243.6, 
      "quarterMonth": "June", 
      "netIncreaseDecreaseInCashAndCashEquivalents": 34.2, 
      "netCashProvidedByFinancingActivities": -183.2, 
      "capitalExpenditure": -34.2
    }
  }, 
  "annualCashFlowStatements": {
    "latestYear": {
      "netCashProvidedByInvestingActivities": -73.4, 
      "year": "2011", 
      "cashAndCashEquivalentsAtTheEndOfTheYear": 84.4, 
      "netCashProvidedByOperatingActivities": 312.9, 
      "cashAndCashEquivalentsAtTheBeginningOfTheYear": 78.5, 
      "netIncreaseDecreaseInCashAndCashEquivalents": 5.9, 
      "netCashProvidedByFinancingActivities": -238.0, 
      "capitalExpenditure": -53.4
    }, 
    "previousYears": [
      {
        "netCashProvidedByInvestingActivities": -253.6, 
        "year": "2010", 
        "cashAndCashEquivalentsAtTheEndOfTheYear": 78.5, 
        "netCashProvidedByOperatingActivities": 319.4, 
        "cashAndCashEquivalentsAtTheBeginningOfTheYear": 222.9, 
        "netIncreaseDecreaseInCashAndCashEquivalents": -144.4, 
        "netCashProvidedByFinancingActivities": -192.9, 
        "capitalExpenditure": -65.9
      }, 
      {
        "netCashProvidedByInvestingActivities": -120.7, 
        "year": "2009", 
        "cashAndCashEquivalentsAtTheEndOfTheYear": 222.9, 
        "netCashProvidedByOperatingActivities": 369.5, 
        "cashAndCashEquivalentsAtTheBeginningOfTheYear": 164.2, 
        "netIncreaseDecreaseInCashAndCashEquivalents": 58.7, 
        "netCashProvidedByFinancingActivities": -213.1, 
        "capitalExpenditure": -65.3
      }, 
      ...
    ]
  }, 
  "topCompetitors": {
    "competitor1": {
      "marketCap": 5897.3088, 
      "employees": 6500, 
      "annualSales": 1959.8, 
      "companyName": "Equifax Inc."
    }, 
    "competitor3": {
      "marketCap": 9985.716, 
      "employees": 6100, 
      "annualSales": 2280.7, 
      "companyName": "Moody's Corporation"
    }, 
    "competitor2": {
      "marketCap": 463.68, 
      "employees": 2100, 
      "annualSales": 152.8, 
      "companyName": "Infogroup Inc."
    }
  }, 
  "marketAnalysis": {
    "morningStar": {
      "bullsSay": "Management's increased use of debt is appropriate,...", 
      "bearsSay": "The company's pension plan is significantly underf..."
    }
  }, 
  "basicFinancialInformation": {
    "fiscalYearEnd": "December", 
    "oneYearSalesGrowthPct": 4.88, 
    "latestYearSales": {
      "salesAccuracy": null, 
      "sales": 1758.5, 
      "year": "2011"
    }, 
    "auditor": "PricewaterhouseCoopers LLP", 
    "exchanges": [
      {
        "exchangeName": "BATS", 
        "tickerSymbol": "DNB"
      }, 
      {
        "exchangeName": "BATS CTA", 
        "tickerSymbol": "DNB"
      }, 
      ...
    ], 
    "oneYearNetIncomeGrowthPct": 3.25, 
    "latestYearNetIncome": {
      "netIncome": 260.3, 
      "year": "2011"
    }, 
    "companyType": "PUBLIC", 
    "location": "HEADQUARTERS"
  }, 
  "comparisonToIndustryAndMarket": {
    "company": {
      "priceSalesRatio": 2.32, 
      "priceEarningRatio": 14.71, 
      "priceCashFlowRatio": 11.68, 
      "priceBookRatio": -4.51
    }, 
    "marketMedian": {
      "priceSalesRatio": 1.21, 
      "priceEarningRatio": 17.3, 
      "priceCashFlowRatio": 7.96, 
      "priceBookRatio": 1.96
    }, 
    "industryMedian": {
      "priceSalesRatio": 1.55, 
      "priceEarningRatio": 35.34, 
      "priceCashFlowRatio": 11.27, 
      "priceBookRatio": 2.89
    }
  }, 
  "annualBalanceSheets": {
    "latestYear": {
      "liabilities": {
        "currentLiabilities": {
          "otherCurrentLiabilities": 916.0, 
          "shortTermDebt": 1.1, 
          "accountsPayable": 36.4
        }, 
        "liabilitySummary": {
          "totalCurrentLiabilities": 953.5, 
          "totalLiabilities": 2721.0, 
          "otherNonCurrentLiabilities": 803.6, 
          "longTermDebt": 963.9
        }
      }, 
      "assets": {
        "assetSummary": {
          "otherNonCurrentAssets": 1204.5, 
          "totalCurrentAssets": 726.9, 
          "netFixedAssets": 45.7, 
          "totalAssets": 1977.1
        }, 
        "currentAssets": {
          "netReceivables": 513.2, 
          "inventories": null, 
          "cash": 84.4, 
          "otherIncomeAssets": 129.3
        }
      }, 
      "quarterYear": null, 
      "quarterMonth": null, 
      "shareholdersEquity": {
        "equitySummary": {
          "totalEquity": -743.9, 
          "sharesOutstanding": 47.7
        }, 
        "equity": {
          "preferredStockEquity": 0.0, 
          "commonStockEquity": -743.9
        }
      }, 
      "year": "2011"
    }, 
    "previousYears": [
      {
        "liabilities": {
          "currentLiabilities": {
            "otherCurrentLiabilities": 891.4, 
            "shortTermDebt": 1.5, 
            "accountsPayable": 34.8
          }, 
          "liabilitySummary": {
            "totalCurrentLiabilities": 927.7, 
            "totalLiabilities": 2559.9, 
            "otherNonCurrentLiabilities": 660.2, 
            "longTermDebt": 972.0
          }
        }, 
        "assets": {
          "assetSummary": {
            "otherNonCurrentAssets": 1184.1, 
            "totalCurrentAssets": 668.3, 
            "netFixedAssets": 53.1, 
            "totalAssets": 1905.5
          }, 
          "currentAssets": {
            "netReceivables": 512.6, 
            "inventories": null, 
            "cash": 78.5, 
            "otherIncomeAssets": 77.2
          }
        }, 
        "quarterYear": null, 
        "quarterMonth": null, 
        "shareholdersEquity": {
          "equitySummary": {
            "totalEquity": -654.4, 
            "sharesOutstanding": 49.6
          }, 
          "equity": {
            "preferredStockEquity": 0.0, 
            "commonStockEquity": -654.4
          }
        }, 
        "year": "2010"
      }, 
      {
        "liabilities": {
          "currentLiabilities": {
            "otherCurrentLiabilities": 821.0, 
            "shortTermDebt": 1.7, 
            "accountsPayable": 36.4
          }, 
          "liabilitySummary": {
            "totalCurrentLiabilities": 859.1, 
            "totalLiabilities": 2495.1, 
            "otherNonCurrentLiabilities": 674.2, 
            "longTermDebt": 961.8
          }
        }, 
        "assets": {
          "assetSummary": {
            "otherNonCurrentAssets": 936.2, 
            "totalCurrentAssets": 759.6, 
            "netFixedAssets": 53.6, 
            "totalAssets": 1749.4
          }, 
          "currentAssets": {
            "netReceivables": 472.1, 
            "inventories": null, 
            "cash": 222.9, 
            "otherIncomeAssets": 64.6
          }
        }, 
        "quarterYear": null, 
        "quarterMonth": null, 
        "shareholdersEquity": {
          "equitySummary": {
            "totalEquity": -745.7, 
            "sharesOutstanding": 51.2
          }, 
          "equity": {
            "preferredStockEquity": null, 
            "commonStockEquity": -745.7
          }
        }, 
        "year": "2009"
      }
    ]
  }, 
  "annualIncomeStatements": {
    "latestYear": {
      "incomeTaxes": null, 
      "revenue": 1758.5, 
      "incomeBeforeTax": null, 
      "interestExpense": null, 
      "dilutedEPS": 5.28, 
      "nonOperatingExpense": null, 
      "grossProfit": 1171.4, 
      "year": "2011", 
      "revenueAccuracy": null, 
      "operatingIncome": 424.8, 
      "totalNetIncome": 260.3
    }, 
    "previousYears": [
      {
        "incomeTaxes": null, 
        "revenue": 1676.6, 
        "incomeBeforeTax": null, 
        "interestExpense": null, 
        "dilutedEPS": 4.98, 
        "nonOperatingExpense": null, 
        "grossProfit": 1118.8999999999999, 
        "year": "2010", 
        "revenueAccuracy": null, 
        "operatingIncome": 409.1, 
        "totalNetIncome": 252.1
      }, 
      {
        "incomeTaxes": null, 
        "revenue": 1687.0, 
        "incomeBeforeTax": null, 
        "interestExpense": null, 
        "dilutedEPS": 5.99, 
        "nonOperatingExpense": null, 
        "grossProfit": 1186.7, 
        "year": "2009", 
        "revenueAccuracy": null, 
        "operatingIncome": 464.5, 
        "totalNetIncome": 319.4
      }
    ]
  }, 
  "quarterlyIncomeStatements": {
    "previousQuarters": [
      {
        "incomeTaxes": null, 
        "revenue": 402.8, 
        "incomeBeforeTax": null, 
        "quarterYear": "2012", 
        "dilutedEPS": 1.32, 
        "nonOperatingExpense": null, 
        "grossProfit": 258.20000000000005, 
        "quarterMonth": "March", 
        "interestExpense": null, 
        "operatingIncome": 74.4, 
        "totalNetIncome": 63.4
      }, 
      {
        "incomeTaxes": null, 
        "revenue": 498.7, 
        "incomeBeforeTax": null, 
        "quarterYear": "2011", 
        "dilutedEPS": 1.93, 
        "nonOperatingExpense": null, 
        "grossProfit": 342.7, 
        "quarterMonth": "December", 
        "interestExpense": null, 
        "operatingIncome": 145.1, 
        "totalNetIncome": 93.5
      }
    ], 
    "latestQuarter": {
      "incomeTaxes": null, 
      "revenue": 383.9, 
      "incomeBeforeTax": null, 
      "quarterYear": "2012", 
      "dilutedEPS": 1.2, 
      "nonOperatingExpense": null, 
      "grossProfit": 257.5, 
      "quarterMonth": "June", 
      "interestExpense": null, 
      "operatingIncome": 89.3, 
      "totalNetIncome": 56.5
    }
  }
}

CURL Example

curl -H 'Accept: application/json'\
     -H 'Content-type: application/json'\
     -H 'API-KEY:YOUR-API-KEY-HERE'\
     -H 'username:YOUR-USERNAME-HERE'\
     -H 'password:YOUR-PASSWORD-HERE'\
     'http://dnbdirect-api.dnb.com/DnBAPI-10/rest/company/884114609/financial/summary'

/company/familytree/{unique_id} Available in Add-on: Family Tree Information

Returns ultimate parent of the given company and all its children or descendants. Access to this service is restricted - please contact your sales representative for access.

Representation

/company/familytree/{unique_id}

URL Parameters

Element Type Notes
unique_id Number Required D-U-N-S number or companyId

Body Representation

Element Type Notes
depthLimit Number The number of layers or levels of the family tree structure to return.
locationType Array of String Company Location Type such as Single Location (0), Headquarters (1), Branch (2), Branch/Division (4), Subsidiary (5)
city Array of String City
state Array of String (1-30 characters) State
country Array of String Country
includeUndeliverableAddress Boolean
includeOutOfBusiness Boolean
includeIncompleteData Boolean If true, will return all the unmarketable company records which have incomplete data.
includeDoNotMarketTo Boolean If true, will return all the unmarketable company records which indicated do not market to.

Sample Request

URL
POST /company/familytree/884114609
Body
{}

Sample Response

{
  "city": "Short Hills", 
  "name": "The Dun & Bradstreet Corporation", 
  "companyId": 10483000000000, 
  "country": "United States", 
  "revenue": 1758.5, 
  "number": null, 
  "currencyType": "USD", 
  "state": "NJ", 
  "additionalData": {
    "outOfBusiness": false, 
    "incompleteData": false, 
    "undeliverableAddress": false, 
    "doNotMarketTo": false
  }, 
  "parentDuns": "884114609", 
  "locationType": "HEADQUARTERS", 
  "duns": "884114609", 
  "dbaNames": null, 
  "totalChildren": 84, 
  "ultimateDomesticParent": null, 
  "children": {
    "child": [
      {
        "city": "Short Hills", 
        "name": "Dun & Bradstreet International, Ltd.", 
        "companyId": 49977515, 
        "country": "United States", 
        "revenue": 110.5, 
        "number": 1, 
        "currencyType": "USD", 
        "state": "NJ", 
        "additionalData": {
          "outOfBusiness": false, 
          "incompleteData": false, 
          "undeliverableAddress": false, 
          "doNotMarketTo": false
        }, 
        "parentDuns": "884114609", 
        "locationType": "HEADQUARTERS", 
        "duns": "049977515", 
        "dbaNames": null, 
        "totalChildren": null, 
        "ultimateDomesticParent": null, 
        "children": {
          "child": [
            {
              "city": "Taipei City", 
              "name": "DUN & BRADSTREET INTERNATIONAL, LTD. TAIWAN BRANCH", 
              "companyId": 657215901, 
              "country": "Taiwan", 
              "revenue": null, 
              "number": 2, 
              "currencyType": null, 
              "state": "Taipei", 
              "additionalData": {
                "outOfBusiness": false, 
                "incompleteData": false, 
                "undeliverableAddress": false, 
                "doNotMarketTo": false
              }, 
              "parentDuns": "049977515", 
              "locationType": "BRANCH", 
              "duns": "657215901", 
              "dbaNames": null, 
              "totalChildren": null, 
              "ultimateDomesticParent": null, 
              "children": null, 
              "ultimateParentDuns": "884114609"
            }, 
            {
              "city": "Marlow", 
              "name": "D & B HOLDINGS (UK)", 
              "companyId": 220034438, 
              "country": "England", 
              "revenue": null, 
              "number": 3, 
              "currencyType": null, 
              "state": "Buckinghamshire", 
              "additionalData": {
                "outOfBusiness": false, 
                "incompleteData": false, 
                "undeliverableAddress": false, 
                "doNotMarketTo": false
              }, 
              "parentDuns": "049977515", 
              "locationType": "HEADQUARTERS", 
              "duns": "220034438", 
              "dbaNames": null, 
              "totalChildren": null, 
              "ultimateDomesticParent": null, 
              "children": {
                "child": [
                  {
                    "city": "Short Hills", 
                    "name": "D & B Group, Ltd.", 
                    "companyId": 19644983, 
                    "country": "United States", 
                    "revenue": 0.33, 
                    "number": 4, 
                    "currencyType": "USD", 
                    "state": "NJ", 
                    "additionalData": {
                      "outOfBusiness": false, 
                      "incompleteData": false, 
                      "undeliverableAddress": false, 
                      "doNotMarketTo": false
                    }, 
                    "parentDuns": "220034438", 
                    "locationType": "HEADQUARTERS", 
                    "duns": "019644983", 
                    "dbaNames": null, 
                    "totalChildren": null, 
                    "ultimateDomesticParent": null, 
                    "children": {
                      "child": [
                        {
                          "city": "Marlow", 
                          "name": "D & B GROUP LTD", 
                          "companyId": 291762474, 
                          "country": "England", 
                          "revenue": null, 
                          "number": 5, 
                          "currencyType": null, 
                          "state": "Buckinghamshire", 
                          "additionalData": {
                            "outOfBusiness": false, 
                            "incompleteData": false, 
                            "undeliverableAddress": false, 
                            "doNotMarketTo": false
                          }, 
                          "parentDuns": "019644983", 
                          "locationType": "BRANCH", 
                          "duns": "291762474", 
                          "dbaNames": null, 
                          "totalChildren": null, 
                          "ultimateDomesticParent": null, 
                          "children": null, 
                          "ultimateParentDuns": "884114609"
                        }
                      ]
                    }, 
                    "ultimateParentDuns": "884114609"
                  }
                ]
              }, 
              "ultimateParentDuns": "884114609"
            }, 
            ...
          ]
        }, 
        "ultimateParentDuns": "884114609"
      }, 
      {
        "city": "Short Hills", 
        "name": "Dun & Bradstreet Ventures, Inc.", 
        "companyId": 158134655, 
        "country": "United States", 
        "revenue": 1.1, 
        "number": 38, 
        "currencyType": "USD", 
        "state": "NJ", 
        "additionalData": {
          "outOfBusiness": false, 
          "incompleteData": false, 
          "undeliverableAddress": false, 
          "doNotMarketTo": false
        }, 
        "parentDuns": "884114609", 
        "locationType": "SINGLE_LOCATION", 
        "duns": "158134655", 
        "dbaNames": null, 
        "totalChildren": null, 
        "ultimateDomesticParent": null, 
        "children": null, 
        "ultimateParentDuns": "884114609"
      }, 
      ...
    ]
  }, 
  "ultimateParentDuns": "884114609"
}

CURL Example

curl -H 'Accept: application/json'\
     -H 'Content-type: application/json'\
     -H 'API-KEY:YOUR-API-KEY-HERE'\
     -H 'username:YOUR-USERNAME-HERE'\
     -H 'password:YOUR-PASSWORD-HERE'\
     -d '{}'\
     'http://dnbdirect-api.dnb.com/DnBAPI-10/rest/company/familytree/884114609'

/company/findcompanycleansematch Available in Add-on: Match Service

The Cleanse Match Service acts as an interface for matching a name and address of a business for identity resolution. The response typically consists of response candidates that are identified as the best matches for the input criteria based on D&B's match algorithms. This service seeks a single known entity, typically based on a combination of name, address, and phone number or a unique identifier. Use the Cleanse Match service to retrieve an organization's DUNS Number. Once the DUNS Number is obtained, a user can retrieve the D&B data for that organization by invoking other services. Once the DUNS Number is obtained, a user can retrieve more information from GetCompanyDetail and GetFamilyTree. Enter the required Cleanse Match fields such as organization name, state, and country. The service cleanses the output to perform a match. If the match returns candidates below a Confidence Code 8 using the cleansed information, the Cleanse Match performs the match again using actual user input. The service returns the highest confidence candidates by merging both matches (cleansed input and actual user input) into a result. Users can retrieve the D&B DUNS Number of the organization, using the following match types: Match using Business Name, Match using Organization Name and Organization Address, Match using Organization Address, Match using Telephone Number, For USA and Canada search Organizations nationwide. It is default for all other countries.

Representation

/company/findcompanycleansematch

URL Parameters

none

Body Representation

Element Type Notes
dataAreaRequest Object Required
dataAreaRequest​.orderRequest Object Required
dataAreaRequest​.orderRequest​.primaryName String (1-90 characters) Required Required Primary Company Name
dataAreaRequest​.orderRequest​.address String (1-64 characters) Physical street address of the business
dataAreaRequest​.orderRequest​.city String (1-30 characters) City
dataAreaRequest​.orderRequest​.state String (1-30 characters) State
dataAreaRequest​.orderRequest​.postalCode String (1-10 characters) Postal Code
dataAreaRequest​.orderRequest​.country String (2 characters) Required The two-letter country code, defined in the ISO 3166-1 scheme published by International Organization for Standardization (ISO), identifying the country for this address. Refer to Country Codes - ISO 3166 for a complete list.
dataAreaRequest​.orderRequest​.phone String (1-16 characters) Telephone Number
dataAreaRequest​.orderRequest​.confidenceCode Number (1-10 characters) Confidence Codes range from 00 (no match) to 10 in order of increasing confidence that the customer record was matched to the correct D&B record. A score of 10 is the highest confidence code.

Sample Request

URL
POST /company/findcompanycleansematch
Body
{
  "optionalResponseFields": {
    "includeMatchQualityInformation": true
  }, 
  "dataAreaRequest": {
    "matchSpecification": {
      "exclusionCriteria": [
        "Exclude Non HeadQuarters"
      ], 
      "candidateMaximumQuantity": "25"
    }, 
    "inquiryReferenceDetail": {
      "customerReferenceText": [
        "case number 123"
      ]
    }, 
    "orderRequest": {
      "city": "Fort Worth", 
      "phone": "817-963-1234", 
      "country": "US", 
      "internationalDialingCode": "1", 
      "confidenceCode": "9", 
      "state": "TX", 
      "primaryName": "AMR Corporation", 
      "address": "4333 Amon Carter Blvd.", 
      "postalCode": "76155"
    }
  }
}

Sample Response

{
  "dataAreaResponse": {
    "orderResponse": {
      "inquiryReferenceDetail": null, 
      "candidates": {
        "candidate": [
          {
            "physicalAddressLine": "4333 AMON CARTER BLVD", 
            "matchQualityInformation": null, 
            "countryCode": "US", 
            "matchBasis": [
              {
                "matchBasisCode": "11801100"
              }, 
              {
                "matchBasisCode": "118011140"
              }, 
              ...
            ], 
            "tradeStyle": null, 
            "internationalDialingCode": 0, 
            "primaryBusinessName": "AMR CORPORATION", 
            "countryName": "UNITED STATES OF AMERICA", 
            "phone": "8179631234", 
            "matchGradeString": "AAAAAZAAFFZ", 
            "subjectDetails": "ParentHeadquarters", 
            "mdpprofile": "0000000000980000000000009898", 
            "webPageAddress": null, 
            "duns": "072560154", 
            "confidenceCode": 10, 
            "physicalPostalCode": "761552605", 
            "physicalCity": "FORT WORTH", 
            "bestMatchFlag": "true", 
            "physicalState": "TX"
          }, 
          {
            "physicalAddressLine": "4333 AMON CARTER BLVD", 
            "matchQualityInformation": null, 
            "countryCode": "US", 
            "matchBasis": [
              {
                "matchBasisCode": "11801090"
              }, 
              {
                "matchBasisCode": "118011140"
              }, 
              ...
            ], 
            "tradeStyle": "A M R", 
            "internationalDialingCode": 0, 
            "primaryBusinessName": "A M R TRAINING GROUP INC", 
            "countryName": "UNITED STATES OF AMERICA", 
            "phone": "8179672000", 
            "matchGradeString": "AAAAAZFAFFZ", 
            "subjectDetails": "ParentHeadquarters", 
            "mdpprofile": "0200000000980000000000009898", 
            "webPageAddress": null, 
            "duns": "788138980", 
            "confidenceCode": 10, 
            "physicalPostalCode": "761552605", 
            "physicalCity": "FORT WORTH", 
            "bestMatchFlag": null, 
            "physicalState": "TX"
          }, 
          ...
        ]
      }, 
      "candidatesReturned": 15
    }, 
    "orderResponseHeader": {
      "status": {
        "code": 1, 
        "description": "Success - good call"
      }, 
      "tranID": "3E90AD43-0598-4E89-BE4E-54148BD819A5"
    }
  }
}

CURL Example

curl -H 'Accept: application/json'\
     -H 'Content-type: application/json'\
     -H 'API-KEY:YOUR-API-KEY-HERE'\
     -H 'username:YOUR-USERNAME-HERE'\
     -H 'password:YOUR-PASSWORD-HERE'\
     -d '{
  "optionalResponseFields": {
    "includeMatchQualityInformation": true
  }, 
  "dataAreaRequest": {
    "matchSpecification": {
      "exclusionCriteria": [
        "Exclude Non HeadQuarters"
      ], 
      "candidateMaximumQuantity": "25"
    }, 
    "inquiryReferenceDetail": {
      "customerReferenceText": [
        "case number 123"
      ]
    }, 
    "orderRequest": {
      "city": "Fort Worth", 
      "phone": "817-963-1234", 
      "country": "US", 
      "internationalDialingCode": "1", 
      "confidenceCode": "9", 
      "state": "TX", 
      "primaryName": "AMR Corporation", 
      "address": "4333 Amon Carter Blvd.", 
      "postalCode": "76155"
    }
  }
}'\
     'http://dnbdirect-api.dnb.com/DnBAPI-10/rest/company/findcompanycleansematch'

/search/company/{keyword} Included in Base Package

Returns a set of companies based on keyword, along with basic identifying data for each company.

Representation

/search/company/{keyword}
?duns_from={duns_from}
&duns_to={duns_to}
&hit_offset={hit_offset}
&max_records={max_records}
&sort_direction={sort_direction}
&search_by={search_by}
&order_by={order_by}
&return_search_navigation={return_search_navigation}

URL Parameters

Element Type Notes
keyword String Required
duns_from Number
duns_to Number
hit_offset Number
max_records Number
sort_direction String (ascending | descending)
search_by String (companyName | stockSymbol | companyNameORstockSymbol)
order_by String (CompanyName | CompanyType | CountryName | CityName | StateName | PhoneNumber | FaxNumber | SalesGrowth12Mon | TotalAssets | SalesUS | EmployeesTotal | EmployeesHere | FiscalYearEndMonth | MarketCap | NetIncomeGrowth12Mon | EmployeeGrowth12Mon | ROE | ROA | EarningsComparison | BookValueComparison | NetIncome | PersonFirstName | PersonLastName | PersonTitle | None)
return_search_navigation String (true | false)

Sample Request

URL
GET /search/company/hoovers

Sample Response

{
  "navigators": {
    "locationNavigators": {
      "countryNavigators": {
        "countryNavigator": [
          {
            "stateProvinceNavigators": {
              "stateProvinceNavigator": [
                {
                  "stateProvinceNavigatorDescription": "AK~76 (372)", 
                  "cityNavigators": {
                    "cityNavigator": [
                      {
                        "cityNavigatorValue": "Anchorage~AK~76", 
                        "cityNavigatorDescription": "Anchorage, AK United States (218)"
                      }, 
                      {
                        "cityNavigatorValue": "Fairbanks~AK~76", 
                        "cityNavigatorDescription": "Fairbanks, AK United States (30)"
                      }, 
                      ...
                    ]
                  }, 
                  "stateProvinceNavigatorValue": "AK~76"
                }, 
                {
                  "stateProvinceNavigatorDescription": "AL~76 (1878)", 
                  "cityNavigators": {
                    "cityNavigator": [
                      {
                        "cityNavigatorValue": "Birmingham~AL~76", 
                        "cityNavigatorDescription": "Birmingham, AL United States (294)"
                      }, 
                      {
                        "cityNavigatorValue": "Huntsville~AL~76", 
                        "cityNavigatorDescription": "Huntsville, AL United States (153)"
                      }, 
                      ...
                    ]
                  }, 
                  "stateProvinceNavigatorValue": "AL~76"
                }, 
                ...
              ]
            }, 
            "countryNavigatorValue": "76", 
            "countryNavigatorDescription": "United States (137675)"
          }, 
          {
            "stateProvinceNavigators": {
              "stateProvinceNavigator": [
                {
                  "stateProvinceNavigatorDescription": "AB~14 (1932)", 
                  "cityNavigators": {
                    "cityNavigator": [
                      {
                        "cityNavigatorValue": "Calgary~AB~14", 
                        "cityNavigatorDescription": "Calgary, AB Canada (823)"
                      }, 
                      {
                        "cityNavigatorValue": "Edmonton~AB~14", 
                        "cityNavigatorDescription": "Edmonton, AB Canada (548)"
                      }, 
                      ...
                    ]
                  }, 
                  "stateProvinceNavigatorValue": "AB~14"
                }, 
                {
                  "stateProvinceNavigatorDescription": "BC~14 (1764)", 
                  "cityNavigators": {
                    "cityNavigator": [
                      {
                        "cityNavigatorValue": "Vancouver~BC~14", 
                        "cityNavigatorDescription": "Vancouver, BC Canada (486)"
                      }, 
                      {
                        "cityNavigatorValue": "Burnaby~BC~14", 
                        "cityNavigatorDescription": "Burnaby, BC Canada (143)"
                      }, 
                      ...
                    ]
                  }, 
                  "stateProvinceNavigatorValue": "BC~14"
                }, 
                ...
              ]
            }, 
            "countryNavigatorValue": "14", 
            "countryNavigatorDescription": "Canada (15429)"
          }, 
          ...
        ]
      }
    }, 
    "employeeNavigators": {
      "employeeNavigator": [
        {
          "employeeNavigatorDescription": "&lt; 4 (0)", 
          "employeeNavigatorValue": "[;4]"
        }, 
        {
          "employeeNavigatorDescription": "5-10 (0)", 
          "employeeNavigatorValue": "[5;10]"
        }, 
        ...
      ]
    }, 
    "ownershipTypeNavigators": {
      "ownershipTypeNavigator": [
        {
          "ownershipTypeNavigatorDescription": "Subsidiary/Branch Location of a Public Company (72...", 
          "ownershipTypeNavigatorValue": "21"
        }, 
        {
          "ownershipTypeNavigatorDescription": "Public (10708)", 
          "ownershipTypeNavigatorValue": "1"
        }, 
        ...
      ]
    }, 
    "salesNavigators": {
      "salesNavigator": [
        {
          "salesNavigatorValue": "[;1>", 
          "salesNavigatorDescription": "&lt; $1 million (51105)"
        }, 
        {
          "salesNavigatorValue": "[1;5>", 
          "salesNavigatorDescription": "$1 - less than $5 million (139058)"
        }, 
        ...
      ]
    }, 
    "locationTypeNavigators": {
      "locationTypeNavigator": [
        {
          "locationTypeNavigatorValue": "2", 
          "locationTypeNavigatorDescription": "Branch (229)"
        }, 
        {
          "locationTypeNavigatorValue": "1", 
          "locationTypeNavigatorDescription": "Headquarters (318144)"
        }, 
        ...
      ]
    }, 
    "industryNavigators": {
      "ussicNavigator": [
        {
          "ussicNavigatorDescription": "01110000 Wheat (55)", 
          "ussicNavigatorValue": "^01110000$"
        }, 
        {
          "ussicNavigatorDescription": "01120000 Rice (54)", 
          "ussicNavigatorValue": "^01120000$"
        }, 
        ...
      ], 
      "naicsNavigator": [
        {
          "naicsNavigatorDescription": "111110 Soybean Farming (18)", 
          "naicsNavigatorValue": "^111110$"
        }, 
        {
          "naicsNavigatorDescription": "111120 Oilseed (except Soybean) Farming (8)", 
          "naicsNavigatorValue": "^111120$"
        }, 
        ...
      ], 
      "industryNavigator": [
        {
          "industryNavigatorValue": "1113", 
          "industryNavigatorDescription": "ATM & Other Self-Service Terminal Manufacturing (4..."
        }, 
        {
          "industryNavigatorValue": "1801", 
          "industryNavigatorDescription": "Abrasives Manufacturing (588)"
        }, 
        ...
      ]
    }
  }, 
  "companies": {
    "lastHit": 20, 
    "totalHits": 1004884, 
    "hits": 20, 
    "hit": [
      {
        "hitNumber": 1, 
        "companyResults": {
          "city": "Sungai Petani", 
          "countryId": 49, 
          "dbas": {
            "dba": []
          }, 
          "address1": "Plot 102 Jalan 4", 
          "companyName": "EG INDUSTRIES BERHAD", 
          "country": "Malaysia", 
          "nonMarketableCompany": null, 
          "exchanges": null, 
          "familyTreeSize": null, 
          "sales": 181739.38677, 
          "duns": "652149394", 
          "doNotCallRegistry": false, 
          "primaryUrl": "", 
          "hqPhone": "44219881", 
          "companyId": 652149394, 
          "parentDuns": "652149394", 
          "locationType": "Headquarters", 
          "postalCode": "08000 08000", 
          "stateOrProvince": "Kdh", 
          "historicalIndicator": false, 
          "ultimateParentDuns": "652149394"
        }
      }, 
      {
        "hitNumber": 2, 
        "companyResults": {
          "city": "Santa Rosa J\u00e1uregui", 
          "countryId": 50, 
          "dbas": {
            "dba": []
          }, 
          "address1": "Av. Industrial De La Construcci\u00f3n No. 601", 
          "companyName": "Troquelados Quer\u00e9taro, S. de R.L. de C.V.", 
          "country": "Mexico", 
          "nonMarketableCompany": null, 
          "exchanges": null, 
          "familyTreeSize": null, 
          "sales": 133616.41653843, 
          "duns": "815332853", 
          "doNotCallRegistry": false, 
          "primaryUrl": "", 
          "hqPhone": "4422945446", 
          "companyId": 815332853, 
          "parentDuns": "828480884", 
          "locationType": "Single Location", 
          "postalCode": "76220 76220", 
          "stateOrProvince": "Qro.", 
          "historicalIndicator": false, 
          "ultimateParentDuns": "132117636"
        }
      }, 
      ...
    ], 
    "firstHit": 1
  }
}

CURL Example

curl -H 'Accept: application/json'\
     -H 'Content-type: application/json'\
     -H 'API-KEY:YOUR-API-KEY-HERE'\
     -H 'username:YOUR-USERNAME-HERE'\
     -H 'password:YOUR-PASSWORD-HERE'\
     'http://dnbdirect-api.dnb.com/DnBAPI-10/rest/search/company/hoovers'

/search/company/advanced/ Included in Base Package

Returns search result of companies based on various criteria.

Representation

/search/company/advanced
?hit_offset={hit_offset}
&max_records={max_records}
&sort_direction={sort_direction}
&return_search_navigation={return_search_navigation}
&order_by={order_by}

URL Parameters

Element Type Notes
hit_offset Number
max_records Number
sort_direction String (ascending | descending)
return_search_navigation Boolean (true | false)
order_by String (CompanyName | CompanyType | CountryName | CityName | StateName | PhoneNumber | FaxNumber | SalesGrowth12Mon | TotalAssets | SalesUS | EmployeesTotal | EmployeesHere | FiscalYearEndMonth | MarketCap | NetIncomeGrowth12Mon | EmployeeGrowth12Mon | ROE | ROA | EarningsComparison | BookValueComparison | NetIncome | PersonFirstName | PersonLastName | PersonTitle | None)

Body Representation

Element Type Notes
companySize Object
companySize​.employeesFrom Number Employees Lower Bound. The definition of employee depends on which part of the organization is referenced in the family tree.
companySize​.employeesTo Number Employees Upper Bound. The definition of employee depends on which part of the organization is referenced in the family tree.
companySize​.employeesGrowthFrom Number Total Employees Growth Percentage Lower Bound
companySize​.employeesGrowthTo Number Total Employees Growth Percentage Upper Bound
companySize​.employeesThisLocationFrom Number Employees at this Location Lower Bound
companySize​.employeesThisLocationTo Number Employees at this Location Upper Bound
companySize​.marketCapFrom Number Market Cap (Capitalization) lower bound expressed in USD millions is the value of a company. Convert local currency into millions of US Dollars. To find a company's Market Cap, multiply the last closing price of a share by the number of shares outstanding.
companySize​.marketCapTo Number Market Cap (Capitalization) upper bound expressed in USD millions is the value of a company. Convert local currency into millions of US Dollars. To find a company's Market Cap, multiply the last closing price of a share by the number of shares outstanding.
companySize​.salesFrom Number Annual Sales ($ mil) Lower Bound
companySize​.salesTo Number Annual Sales ($ mil) Upper Bound
companySize​.salesGrowthFrom Number Annual Sales Growth (%) Lower Bound
companySize​.salesGrowthTo Number Annual Sales Growth (%) Upper Bound
companyType Object Company Types include Public (1), Private (2), Private_Association (3), Private_Consortium (4), Private_Cooperative (5), or Subsidiary (15); OR available as a container element for locationType, ownershipType, subsidiaryStatus, and franchiseStatus.
companyType​.locationType Array of Number Company Location Type such as Single Location (0), Headquarters (1), Branch (2), Branch/Division (4), Subsidiary (5)
companyType​.ownershipType Array of Number Ownership Type. A code value which describes the legal ownership status of the company. Indicates whether or not a company without its own stock information has a parent company that receives stock information. Values are 1 (Public), 21 (Owned by a Public Company or Public_By_Association) or 0 (Unknown).
companyType​.subsidiaryStatus Array of Number Subsidiary status is entered either as 0 = not a subsidiary or 1 = is a subsidiary: subsidiaryStatus [#] These integers indicate whether or not the corporate stock of the site location is at least 50% owned by another company. A subsidiary company is controlled by another company or corporation that owns more than 50% of its stock and may own all of it (called a parent company).
companyType​.franchiseStatus Boolean Franchise Status: If set to true, If set to false. Franchises are independently owned and operated businesses granted the right to use a brand owner's (franchisor's) name, products, and trademarks in exchange for a fee.
financialData Object
financialData​.advertisingExpenseFrom Number Advertising Expense (expressed in millions of US Dollars) Lower Bound
financialData​.advertisingExpenseTo Number Advertising Expense (expressed in millions of US Dollars) Upper Bound
financialData​.assetsFrom Number Assets (expressed in millions of US Dollars) Lower Bound
financialData​.assetsTo Number Assets (expressed in millions of US Dollars) Upper Bound
financialData​.filingDateFrom String Filing Date Lower Bound
financialData​.filingDateTo String Filing Date Upper Bound
financialData​.fiscalYearEnd Array of Number The month the fiscal year ends. Not all financial fiscal year ranges end in December, for example.
financialData​.incomeFrom Number Net Income (expressed in millions of US Dollars) Lower Bound
financialData​.incomeGrowthFrom Number Net Income Growth (%) Lower Bound
financialData​.incomeGrowthTo Number Net Income Growth (%) Upper Bound
financialData​.incomeTo Number Net Income (expressed in millions of US Dollars) Upper Bound
financialData​.offerFrom Number US IPO Data - Offer Amount (expressed in milions of USD) Lower Bound
financialData​.offerTo Number US IPO Data - Offer Amount (expressed in milions of USD) Upper Bound
financialData​.priceRangeFrom Number US IPO Data - Price Range ($) Lower Bound
financialData​.priceRangeTo Number US IPO Data - Price Range ($) Upper Bound
financialData​.researchExpenseFrom Number R&D Expense ($ mil) Lower Bound
financialData​.researchExpenseTo Number R&D Expense ($ mil) Upper Bound
financialData​.tradingDateFrom String Trading Date Lower Bound
financialData​.tradingDateTo String Trading Date Upper Bound
financialData​.underwriterId Array of Number Underwriter ID. A brokerage firm that buys shares from the company and sells them to the public in the IPO. We provide almost 900 of these organizations.
financialData​.marketingPreScreenScore Array of String Max array length: 3 Available Values:
L
L stands for Low
M
M stands for Medium
H
H stands for High
industry Object
industry​.dnbIndustryCode Array of Number D&B Industry Code
industry​.primaryOnly Boolean Restricts the search to only the primary company industry
industry​.nAICS Array of String NAICS Code: "NAICS" (North American Industry Classification System) was jointly created by Canada, Mexico and the US in the 1990s. Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified.
industry​.nAICSRange Array of Object
industry​.nAICSRange[]​.from String NAICS Code Range Lower Bound
industry​.nAICSRange[]​.to String NAICS Code Range Upper Bound
industry​.uSSIC Array of String US SIC Code: "SIC" (Standard Industrial Classification) is an industry code system developed by the US Government.
industry​.uSSICRange Array of Object
industry​.uSSICRange[]​.from String SIC Code Range Lower Bound
industry​.uSSICRange[]​.to String SIC Code Range Upper Bound
industry​.uKSIC Array of String UK SIC Code: The United Kingdom's Standard Industrial Classification (SIC) was first introduced in 1948 for use in classifying business establishments and other statistical units by the type of economic activity in which they are engaged. The classification provides a framework for the collection, tabulation, presentation and analysis of data, and its use promotes uniformity. In addition, it can be used for administrative purposes and by non-government bodies as a convenient way of classifying industrial activities into a common structure. Since 1948 the classification has been revised in 1958, 1968, 1980, 1992, 1997, and 2003.
industry​.uKSICRange Array of Object
industry​.uKSICRange[]​.from String UKSIC Code Range Lower Bound
industry​.uKSICRange[]​.to String UKSIC Code Range Upper Bound
location Object Type of location for the company; headquarters, branch office, etc.
location​.areaCode Array of String US or Canadian Phone Number Area Code
location​.streetAddress Array of String Street Address
location​.county Array of Object Company County
location​.county[]​.countyId String County ID
location​.county[]​.state String State
location​.county[]​.countryId Number Country ID - D&B-assigned code which identifies the country where the business is located.
location​.city Array of String City
location​.countryId Array of Number Country ID - D&B-assigned code which identifies the country where the business is located.
location​.globalState Array of String Global State/Province
location​.metropolitanId Array of Number US Metropolitan Area
location​.regionId Array of Number D&B world region code which identifies the region where the business is located.
location​.usStateCanadaProvince Array of String US State/Canada Province
location​.postalCode Array of String Postal Code
location​.usZipCodeRange Array of Object
location​.usZipCodeRange[]​.from Number US ZIP Code Range Lower Bound
location​.usZipCodeRange[]​.to Number US ZIP Code Range Upper Bound
location​.zipAreaSearch Object
location​.zipAreaSearch​.scale String Units to search in: miles or kilometers Available Values:
miles
kilometers
location​.zipAreaSearch​.radius Number Number of miles or kilometers to search within
location​.zipAreaSearch​.zipCode String Zipcode to search within (78745 in the example)
location​.latLongSearch Object
location​.latLongSearch​.scale String Units to search in: miles or kilometers Available Values:
miles
kilometers
location​.latLongSearch​.radius Number Number of miles or kilometers to search within
location​.latLongSearch​.latitude Number
location​.latLongSearch​.longitude Number Longitude component of geo location
location​.allAny String Denotes whether all or any company location criteria are matched Available Values:
all
any
location​.ukCounty Array of String UK County name
specialtyCriteria Object
specialtyCriteria​.auditorId Array of Number Obtain the Auditors ID value from the GetAdvancedSearchLookups call. Example: 'id' 1551 corresponds to PricewaterhouseCoopers AB
specialtyCriteria​.companyKeyword String Company Keyword
specialtyCriteria​.duns Array of Number D-U-N-S Number. The Data Universal Numbering System (DUNS) Number is a non-indicative, nine-digit number assigned to each business location in the D&amp;B database having a unique, separate, and distinct operation, and is maintained solely by D&amp;B. The D&amp;B D-U-N-S Number is used by industries and organizations around the world as a global standard for business identification and tracking. Pattern Value: "([0-9a-zA-Z]*)".
specialtyCriteria​.dunsFrom Number D-U-N-S Number lower limit
specialtyCriteria​.dunsTo Number D-U-N-S Number upper limit
specialtyCriteria​.exchangeId Array of Number The ID associated with the exchange where the company's stock is traded.
specialtyCriteria​.rankingId Array of Number Ranking ID
specialtyCriteria​.ukRegistration Array of String UK Registration Number. Unique identifier assigned to UK companies by the government's Companies House. Example: 3443456
specialtyCriteria​.ukVat Array of String United Kingdom's Value Added Tax Number. Example: 906565610
specialtyCriteria​.yearFoundingFrom Number Year of Founding or Change in Control Lower Bound
specialtyCriteria​.yearFoundingTo Number Year of Founding or Change in Control (YYYY) Upper Bound
specialtyCriteria​.ultimateParentDuns Array of Number The ultimate parent company D-U-N-S Number for a family of companies
specialtyCriteria​.primaryUrl Array of String Primary URL for the company
specialtyCriteria​.companyName String Company Name
specialtyCriteria​.stockTicker Array of String Stock Ticker
specialtyCriteria​.minorityOwned Boolean A true or false indication of whether or not a company's owners are minorities. A business that is at least 51% owned by, and whose management and daily business operations are controlled by, one or more members of a socially and economically disadvantaged minority group, namely U.S. citizens who are: African American, Asian American, Hispanic American, Native American, Indian Subcontinent American.
specialtyCriteria​.womenOwned Boolean A true or false indication of whether or not a company's owners are women. A business that is at least 51% owned by, and whose management and daily business operations are controlled by one or more women who are U.S. citizens.
specialtyCriteria​.squareFootageFrom Number Company square foot range from
specialtyCriteria​.squareFootageTo Number Company square foot range to
specialtyCriteria​.ethnicity Array of String Ethnicity of the company owner: Chinese, Filipino, Japanese, Korean, Vietnamese, or other Asian origin (ASN), Black or African American (BLK), Hispanic, Latino, or Spanish origin (HSP), Indian Subcontinent origin (ISU), American Indian, Alaska Native, or Native Hawaiian (NAT), Unknown (UNK) Available Values:
ASN
Chinese, Filipino, Japanese, Korean, Vietnamese, or other Asian origin
BLK
Black or African American
HSP
Hispanic, Latino, or Spanish origin
ISU
Indian Subcontinent origin
NAT
American Indian, Alaska Native, or Native Hawaiian
UNK
Unknown
specialtyCriteria​.legalStatus Array of String Legal Status of the company Available Values:
Corporation
Partnership
Proprietorship
NationalGovernmentEntity
RegionalLocalGovernmentEntity
JointVenture
NonProfitOrganization
CooperativeMutualOrganization
ForeignCompany
specialtyCriteria​.ownsOrRents String Company resides in Owned or Rented Space Available Values:
Owned
Location is rented by this company
Rented
Location is owned by this company
specialtyCriteria​.importer Boolean Importer flag which identifies whether or not a company imports for re-manufacture or sale
specialtyCriteria​.exporter Boolean Exporter flag which identifies whether or not a company exports products to other countries.
searchNavigation Object
searchNavigation​.employeeSearchNavigation Object
searchNavigation​.employeeSearchNavigation​.employeeSearchNavigationValue Array of String An employee navigation link that can be fed back into other calls
searchNavigation​.ownershipTypeSearchNavigation Object
searchNavigation​.ownershipTypeSearchNavigation​.ownershipTypeSearchNavigationValue Array of String
searchNavigation​.locationTypeSearchNavigation Object
searchNavigation​.locationTypeSearchNavigation​.locationTypeSearchNavigationValue Array of String A location type navigation link that can be fed back into other calls
searchNavigation​.salesSearchNavigation Object
searchNavigation​.salesSearchNavigation​.salesSearchNavigationValue Array of String A sales navigation link that can be fed back into other calls
searchNavigation​.locationSearchNavigation Object
searchNavigation​.locationSearchNavigation​.countryNavigation Array of Object
searchNavigation​.locationSearchNavigation​.countryNavigation[]​.countryNavigationValue String A country navigation link that can be fed back into other calls.
searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation Array of Object
searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation[]​.stateNavigationValue String A state/province navigation link that can be fed back into other calls.
searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation[]​.cityNavigation Array of Object
searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation[]​.cityNavigation[]​.cityNavigationValue String A city navigation link that can be fed back into other calls
searchNavigation​.industrySearchNavigation Object
searchNavigation​.industrySearchNavigation​.industrySearchNavigationValue Array of String An industry navigation link that can be fed back into other calls. If set to true, navigators will be returned in the response to enable drill down into search results.
searchNavigation​.industrySearchNavigation​.ussicSearchNavigationValue Array of String A US SIC navigation link that can be fed back into other calls.
searchNavigation​.industrySearchNavigation​.naicsSearchNavigationValue Array of String A NAICS navigation link that can be fed back into other calls.

Sample Request

URL
POST /search/company/advanced?return_search_navigation=true
Body
{
  "companySize": {
    "employeesTo": 1000, 
    "employeesFrom": 100
  }
}

Sample Response

{
  "navigators": {
    "locationNavigators": {
      "countryNavigators": {
        "countryNavigator": [
          {
            "stateProvinceNavigators": {
              "stateProvinceNavigator": [
                {
                  "stateProvinceNavigatorDescription": "AK~76 (372)", 
                  "cityNavigators": {
                    "cityNavigator": [
                      {
                        "cityNavigatorValue": "Anchorage~AK~76", 
                        "cityNavigatorDescription": "Anchorage, AK United States (218)"
                      }, 
                      {
                        "cityNavigatorValue": "Fairbanks~AK~76", 
                        "cityNavigatorDescription": "Fairbanks, AK United States (30)"
                      }, 
                      ...
                    ]
                  }, 
                  "stateProvinceNavigatorValue": "AK~76"
                }, 
                {
                  "stateProvinceNavigatorDescription": "AL~76 (1878)", 
                  "cityNavigators": {
                    "cityNavigator": [
                      {
                        "cityNavigatorValue": "Birmingham~AL~76", 
                        "cityNavigatorDescription": "Birmingham, AL United States (294)"
                      }, 
                      {
                        "cityNavigatorValue": "Huntsville~AL~76", 
                        "cityNavigatorDescription": "Huntsville, AL United States (153)"
                      }, 
                      ...
                    ]
                  }, 
                  "stateProvinceNavigatorValue": "AL~76"
                }, 
                ...
              ]
            }, 
            "countryNavigatorValue": "76", 
            "countryNavigatorDescription": "United States (137675)"
          }, 
          {
            "stateProvinceNavigators": {
              "stateProvinceNavigator": [
                {
                  "stateProvinceNavigatorDescription": "AB~14 (1932)", 
                  "cityNavigators": {
                    "cityNavigator": [
                      {
                        "cityNavigatorValue": "Calgary~AB~14", 
                        "cityNavigatorDescription": "Calgary, AB Canada (823)"
                      }, 
                      {
                        "cityNavigatorValue": "Edmonton~AB~14", 
                        "cityNavigatorDescription": "Edmonton, AB Canada (548)"
                      }, 
                      ...
                    ]
                  }, 
                  "stateProvinceNavigatorValue": "AB~14"
                }, 
                {
                  "stateProvinceNavigatorDescription": "BC~14 (1764)", 
                  "cityNavigators": {
                    "cityNavigator": [
                      {
                        "cityNavigatorValue": "Vancouver~BC~14", 
                        "cityNavigatorDescription": "Vancouver, BC Canada (486)"
                      }, 
                      {
                        "cityNavigatorValue": "Burnaby~BC~14", 
                        "cityNavigatorDescription": "Burnaby, BC Canada (143)"
                      }, 
                      ...
                    ]
                  }, 
                  "stateProvinceNavigatorValue": "BC~14"
                }, 
                ...
              ]
            }, 
            "countryNavigatorValue": "14", 
            "countryNavigatorDescription": "Canada (15429)"
          }, 
          ...
        ]
      }
    }, 
    "employeeNavigators": {
      "employeeNavigator": [
        {
          "employeeNavigatorDescription": "&lt; 4 (0)", 
          "employeeNavigatorValue": "[;4]"
        }, 
        {
          "employeeNavigatorDescription": "5-10 (0)", 
          "employeeNavigatorValue": "[5;10]"
        }, 
        ...
      ]
    }, 
    "ownershipTypeNavigators": {
      "ownershipTypeNavigator": [
        {
          "ownershipTypeNavigatorDescription": "Subsidiary/Branch Location of a Public Company (72...", 
          "ownershipTypeNavigatorValue": "21"
        }, 
        {
          "ownershipTypeNavigatorDescription": "Public (10708)", 
          "ownershipTypeNavigatorValue": "1"
        }, 
        ...
      ]
    }, 
    "salesNavigators": {
      "salesNavigator": [
        {
          "salesNavigatorValue": "[;1>", 
          "salesNavigatorDescription": "&lt; $1 million (51105)"
        }, 
        {
          "salesNavigatorValue": "[1;5>", 
          "salesNavigatorDescription": "$1 - less than $5 million (139058)"
        }, 
        ...
      ]
    }, 
    "locationTypeNavigators": {
      "locationTypeNavigator": [
        {
          "locationTypeNavigatorValue": "2", 
          "locationTypeNavigatorDescription": "Branch (229)"
        }, 
        {
          "locationTypeNavigatorValue": "1", 
          "locationTypeNavigatorDescription": "Headquarters (318144)"
        }, 
        ...
      ]
    }, 
    "industryNavigators": {
      "ussicNavigator": [
        {
          "ussicNavigatorDescription": "01110000 Wheat (55)", 
          "ussicNavigatorValue": "^01110000$"
        }, 
        {
          "ussicNavigatorDescription": "01120000 Rice (54)", 
          "ussicNavigatorValue": "^01120000$"
        }, 
        ...
      ], 
      "naicsNavigator": [
        {
          "naicsNavigatorDescription": "111110 Soybean Farming (18)", 
          "naicsNavigatorValue": "^111110$"
        }, 
        {
          "naicsNavigatorDescription": "111120 Oilseed (except Soybean) Farming (8)", 
          "naicsNavigatorValue": "^111120$"
        }, 
        ...
      ], 
      "industryNavigator": [
        {
          "industryNavigatorValue": "1113", 
          "industryNavigatorDescription": "ATM & Other Self-Service Terminal Manufacturing (4..."
        }, 
        {
          "industryNavigatorValue": "1801", 
          "industryNavigatorDescription": "Abrasives Manufacturing (588)"
        }, 
        ...
      ]
    }
  }, 
  "companies": {
    "lastHit": 20, 
    "totalHits": 1004884, 
    "hits": 20, 
    "hit": [
      {
        "hitNumber": 1, 
        "companyResults": {
          "city": "Sungai Petani", 
          "countryId": 49, 
          "dbas": {
            "dba": []
          }, 
          "address1": "Plot 102 Jalan 4", 
          "companyName": "EG INDUSTRIES BERHAD", 
          "country": "Malaysia", 
          "nonMarketableCompany": null, 
          "exchanges": null, 
          "familyTreeSize": null, 
          "sales": 181739.38677, 
          "duns": "652149394", 
          "doNotCallRegistry": false, 
          "primaryUrl": "", 
          "hqPhone": "44219881", 
          "companyId": 652149394, 
          "parentDuns": "652149394", 
          "locationType": "Headquarters", 
          "postalCode": "08000 08000", 
          "stateOrProvince": "Kdh", 
          "historicalIndicator": false, 
          "ultimateParentDuns": "652149394"
        }
      }, 
      {
        "hitNumber": 2, 
        "companyResults": {
          "city": "Santa Rosa J\u00e1uregui", 
          "countryId": 50, 
          "dbas": {
            "dba": []
          }, 
          "address1": "Av. Industrial De La Construcci\u00f3n No. 601", 
          "companyName": "Troquelados Quer\u00e9taro, S. de R.L. de C.V.", 
          "country": "Mexico", 
          "nonMarketableCompany": null, 
          "exchanges": null, 
          "familyTreeSize": null, 
          "sales": 133616.41653843, 
          "duns": "815332853", 
          "doNotCallRegistry": false, 
          "primaryUrl": "", 
          "hqPhone": "4422945446", 
          "companyId": 815332853, 
          "parentDuns": "828480884", 
          "locationType": "Single Location", 
          "postalCode": "76220 76220", 
          "stateOrProvince": "Qro.", 
          "historicalIndicator": false, 
          "ultimateParentDuns": "132117636"
        }
      }, 
      ...
    ], 
    "firstHit": 1
  }
}

CURL Example

curl -H 'Accept: application/json'\
     -H 'Content-type: application/json'\
     -H 'API-KEY:YOUR-API-KEY-HERE'\
     -H 'username:YOUR-USERNAME-HERE'\
     -H 'password:YOUR-PASSWORD-HERE'\
     -d '{
  "companySize": {
    "employeesTo": 1000, 
    "employeesFrom": 100
  }
}'\
     'http://dnbdirect-api.dnb.com/DnBAPI-10/rest/search/company/advanced?return_search_navigation=true'

/person/{unique_company_id}/{co_official_id} Included in Base Package

Returns detailed person information.

Representation

/person/{unique_company_id}/{co_official_id}
?connect_mail={connect_mail}
&convert_currency_to={convert_currency_to}
&view={view}

URL Parameters

Element Type Notes
unique_company_id Number Required
co_official_id Number Required
connect_mail Boolean
convert_currency_to String (usd | gbp | cad | eur | jpy | sek)
view String (full | simple | optional)

Sample Request

URL
GET /person/884114609/1073021000000000

Sample Response

{
  "coOfficial": {
    "positionHistory": {
      "position": [
        {
          "jobFunction": null, 
          "endYear": "2010", 
          "startYear": "2010", 
          "titleText": "", 
          "title": "President, CEO, and Director"
        }, 
        {
          "jobFunction": null, 
          "endYear": "2010", 
          "startYear": "2009", 
          "titleText": "", 
          "title": "President, COO, and Director; Head, U.S. Customer ..."
        }, 
        ...
      ]
    }, 
    "latestPosition": {
      "jobFunction": {
        "jobFunctionId": [
          15, 
          55
        ]
      }, 
      "endYear": "Present", 
      "startYear": "2010", 
      "titleText": "", 
      "title": "Chairman and CEO"
    }, 
    "primaryCompanyPhone": "973-921-5500", 
    "biographySource": "Company Web Site", 
    "socialMediaData": {
      "linkedInAccountId": null
    }, 
    "nonMarketableCompany": null, 
    "companyId": 10483000000000, 
    "connectMail": {
      "connectMailEmailSource": true, 
      "connectMailSource": "D&B", 
      "connectMailNameSource": false, 
      "connectMailPhoneSource": false
    }, 
    "coOfficialId": 1073021000000000, 
    "person": {
      "suffix": "", 
      "firstName": "Sara", 
      "middleName": "S.", 
      "lastName": "Mathew", 
      "age": 56, 
      "prefix": "Ms.", 
      "fullName": "Sara S. Mathew"
    }, 
    "contact": {
      "emailAddress": "Email on file", 
      "phoneNumber": null
    }, 
    "latestSalary": {
      "salary": 800000.0, 
      "bonus": null, 
      "totalSalary": 6666922.0, 
      "year": 2011
    }, 
    "duns": "884114609", 
    "salaryHistory": {
      "salaries": [
        {
          "salary": 750000.0, 
          "bonus": null, 
          "totalSalary": 4586462.0, 
          "year": 2010
        }, 
        {
          "salary": 600000.0, 
          "bonus": null, 
          "totalSalary": 4089398.0, 
          "year": 2009
        }, 
        ...
      ]
    }, 
    "biography": "Sara Mathew has served as our Chairman of the Boar...", 
    "currencyConvertedTo": "USD"
  }
}

CURL Example

curl -H 'Accept: application/json'\
     -H 'Content-type: application/json'\
     -H 'API-KEY:YOUR-API-KEY-HERE'\
     -H 'username:YOUR-USERNAME-HERE'\
     -H 'password:YOUR-PASSWORD-HERE'\
     'http://dnbdirect-api.dnb.com/DnBAPI-10/rest/person/884114609/1073021000000000'

/search/company/basic/{keyword} Included in Base Package

Representation

/search/company/basic/{keyword}
?limit={limit}

URL Parameters

Element Type Notes
keyword String Required
limit String

Sample Request

URL
GET /search/company/basic/hoovers

Sample Response

{
  "companies": [
    {
      "city": "Austin", 
      "revenue": 111.5, 
      "companyId": 41416000000000, 
      "companyName": "Hoover's, Inc.", 
      "state": "TX", 
      "link": {
        "http": "/company/41416000000000?view=basic", 
        "rel": "self"
      }, 
      "duns": "611241688"
    }, 
    {
      "city": "Short Hills", 
      "revenue": 1758.5, 
      "companyId": 10483000000000, 
      "companyName": "The Dun & Bradstreet Corporation", 
      "state": "NJ", 
      "link": {
        "http": "/company/10483000000000?view=basic", 
        "rel": "self"
      }, 
      "duns": "884114609"
    }, 
    ...
  ]
}

CURL Example

curl -H 'Accept: application/json'\
     -H 'Content-type: application/json'\
     -H 'API-KEY:YOUR-API-KEY-HERE'\
     -H 'username:YOUR-USERNAME-HERE'\
     -H 'password:YOUR-PASSWORD-HERE'\
     'http://dnbdirect-api.dnb.com/DnBAPI-10/rest/search/company/basic/hoovers'

/search/person/advanced/ Included in Base Package

Representation

/search/person/advanced
?hit_offset={hit_offset}
&max_records={max_records}
&sort_direction={sort_direction}
&order_by={order_by}

URL Parameters

Element Type Notes
hit_offset Number
max_records Number
sort_direction String (ascending | descending)
order_by String (CompanyName | CompanyType | CountryName | CityName | StateName | PhoneNumber | FaxNumber | SalesGrowth12Mon | TotalAssets | SalesUS | EmployeesTotal | EmployeesHere | FiscalYearEndMonth | MarketCap | NetIncomeGrowth12Mon | EmployeeGrowth12Mon | ROE | ROA | EarningsComparison | BookValueComparison | NetIncome | PersonFirstName | PersonLastName | PersonTitle | None)

Sample Request

URL
POST /search/person/advanced/
Body
{}

Sample Response

{
  "people": {
    "lastHit": 20, 
    "totalHits": 103233896, 
    "hits": 20, 
    "hit": [
      {
        "coOfficialResults": {
          "suffix": "", 
          "firstName": "Fernando", 
          "title": "Secretary", 
          "middleName": "", 
          "lastName": "Rodr\u00edguez Arias Delgado", 
          "nonMarketableCompany": null, 
          "companyName": "TROMPO INVERSIONES SICAV, SA", 
          "connectMail": {
            "connectMailEmailSource": false, 
            "connectMailSource": "None", 
            "connectMailNameSource": false, 
            "connectMailPhoneSource": false
          }, 
          "coOfficialId": 4600047875, 
          "companyId": 460004787, 
          "duns": "460004787", 
          "fullName": "RODRIGUEZ ARIAS DELGADO, FERNANDO"
        }, 
        "hitNumber": 1
      }, 
      {
        "coOfficialResults": {
          "suffix": "", 
          "firstName": "Antonio", 
          "title": "Director", 
          "middleName": "", 
          "lastName": "Canet Mart\u00ednez", 
          "nonMarketableCompany": null, 
          "companyName": "Miquel y Costas & Miquel, S.A.", 
          "connectMail": {
            "connectMailEmailSource": false, 
            "connectMailSource": "None", 
            "connectMailNameSource": false, 
            "connectMailPhoneSource": false
          }, 
          "coOfficialId": 1783275000000000, 
          "companyId": 103161000000000, 
          "duns": "460023443", 
          "fullName": "Antonio Canet Mart\u00ednez"
        }, 
        "hitNumber": 2
      }, 
      ...
    ], 
    "firstHit": 1
  }
}

CURL Example

curl -H 'Accept: application/json'\
     -H 'Content-type: application/json'\
     -H 'API-KEY:YOUR-API-KEY-HERE'\
     -H 'username:YOUR-USERNAME-HERE'\
     -H 'password:YOUR-PASSWORD-HERE'\
     -d '{}'\
     'http://dnbdirect-api.dnb.com/DnBAPI-10/rest/search/person/advanced/'
© Dun & Bradstreet, Inc. 2000-2015. All rights reserved. © 2015 Morningstar. Financial Data provided by Morningstar.