D&B Direct Documentation

SOAP Version 1.0

By D&B SparkLab - Customer Solutions Lab

Overview

Endpoints & WSDL

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

WSDL http://api.dnbdirectapps.com/dev/DnBAPI-10/dnbAPI/dnbAPI.wsdl
Endpoint http://api.dnbdirectapps.com/dev/DnBAPI-10

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

WSDL http://dnbdirect-sandbox.dnb.com/DnBAPI-10/dnbAPI/dnbAPI.wsdl
Endpoint http://dnbdirect-sandbox.dnb.com/DnBAPI-10

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

WSDL http://dnbdirect-api.dnb.com/DnBAPI-10/dnbAPI/dnbAPI.wsdl
Endpoint http://dnbdirect-api.dnb.com/DnBAPI-10

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 your API-KEY to be sent in the SOAP header.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="http://applications.dnb.com/webservice/schema/">
   <soapenv:Header>
      <sch:API-KEY>YOUR-API-KEY-HERE</sch:API-KEY>
   </soapenv:Header>
   <soapenv:Body>
    ...
   </soapenv:Body>
</soapenv:Envelope>
Certain entitled premium or add-on calls may require your username and password as well.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="http://applications.dnb.com/webservice/schema/">
   <soapenv:Header>
      <sch:API-KEY>YOUR-API-KEY-HERE</sch:API-KEY>
      <sch:username>YOUR-USERNAME-HERE</sch:username>
      <sch:password>YOUR-PASSWORD-HERE</sch:password>
   </soapenv:Header>
   <soapenv:Body>
    ...
   </soapenv:Body>
</soapenv:Envelope>

SOAP Operations

AdvancedCompanySearch Included in Base Package

Returns search result of companies based on various criteria.

Request

Element Type Notes
bal Required
bal​.maxRecords integer Maximum records to retrieve (1-200).
bal​.hitOffset integer Zero-based offset used to indicate at what record to start returning results.
bal​.sortDirection string Sort direction types are Ascending or Descending Available Values:
Ascending
Descending
bal​.companySize CompanySize
bal​.companySize​.employeesFrom long Employees Lower Bound. The definition of employee depends on which part of the organization is referenced in the family tree.
bal​.companySize​.employeesTo long Employees Upper Bound. The definition of employee depends on which part of the organization is referenced in the family tree.
bal​.companySize​.employeesGrowthFrom double Total Employees Growth Percentage Lower Bound
bal​.companySize​.employeesGrowthTo double Total Employees Growth Percentage Upper Bound
bal​.companySize​.employeesThisLocationFrom long Employees at this Location Lower Bound
bal​.companySize​.employeesThisLocationTo long Employees at this Location Upper Bound
bal​.companySize​.marketCapFrom decimal 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.
bal​.companySize​.marketCapTo decimal 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.
bal​.companySize​.salesFrom decimal Annual Sales ($ mil) Lower Bound
bal​.companySize​.salesTo decimal Annual Sales ($ mil) Upper Bound
bal​.companySize​.salesGrowthFrom double Annual Sales Growth (%) Lower Bound
bal​.companySize​.salesGrowthTo double Annual Sales Growth (%) Upper Bound
bal​.companyType CompanyType 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.
bal​.companyType​.locationType Array of integer Company Location Type such as Single Location (0), Headquarters (1), Branch (2), Branch/Division (4), Subsidiary (5)
bal​.companyType​.ownershipType Array of integer 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).
bal​.companyType​.subsidiaryStatus Array of integer 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).
bal​.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.
bal​.financialData FinancialData
bal​.financialData​.advertisingExpenseFrom decimal Advertising Expense (expressed in millions of US Dollars) Lower Bound
bal​.financialData​.advertisingExpenseTo decimal Advertising Expense (expressed in millions of US Dollars) Upper Bound
bal​.financialData​.assetsFrom decimal Assets (expressed in millions of US Dollars) Lower Bound
bal​.financialData​.assetsTo decimal Assets (expressed in millions of US Dollars) Upper Bound
bal​.financialData​.filingDateFrom date Filing Date Lower Bound
bal​.financialData​.filingDateTo date Filing Date Upper Bound
bal​.financialData​.fiscalYearEnd Array of long The month the fiscal year ends. Not all financial fiscal year ranges end in December, for example.
bal​.financialData​.incomeFrom decimal Net Income (expressed in millions of US Dollars) Lower Bound
bal​.financialData​.incomeGrowthFrom double Net Income Growth (%) Lower Bound
bal​.financialData​.incomeGrowthTo double Net Income Growth (%) Upper Bound
bal​.financialData​.incomeTo decimal Net Income (expressed in millions of US Dollars) Upper Bound
bal​.financialData​.offerFrom decimal US IPO Data - Offer Amount (expressed in milions of USD) Lower Bound
bal​.financialData​.offerTo decimal US IPO Data - Offer Amount (expressed in milions of USD) Upper Bound
bal​.financialData​.priceRangeFrom decimal US IPO Data - Price Range ($) Lower Bound
bal​.financialData​.priceRangeTo decimal US IPO Data - Price Range ($) Upper Bound
bal​.financialData​.researchExpenseFrom decimal R&D Expense ($ mil) Lower Bound
bal​.financialData​.researchExpenseTo decimal R&D Expense ($ mil) Upper Bound
bal​.financialData​.tradingDateFrom date Trading Date Lower Bound
bal​.financialData​.tradingDateTo date Trading Date Upper Bound
bal​.financialData​.underwriterId Array of long 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.
bal​.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
bal​.industry Industry
bal​.industry​.dnbIndustryCode Array of integer D&B Industry Code
bal​.industry​.primaryOnly boolean Restricts the search to only the primary company industry
bal​.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.
bal​.industry​.nAICSRange Array of StringRange
bal​.industry​.nAICSRange[]​.from string NAICS Code Range Lower Bound
bal​.industry​.nAICSRange[]​.to string NAICS Code Range Upper Bound
bal​.industry​.uSSIC Array of string US SIC Code: "SIC" (Standard Industrial Classification) is an industry code system developed by the US Government.
bal​.industry​.uSSICRange Array of StringRange
bal​.industry​.uSSICRange[]​.from string SIC Code Range Lower Bound
bal​.industry​.uSSICRange[]​.to string SIC Code Range Upper Bound
bal​.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.
bal​.industry​.uKSICRange Array of StringRange
bal​.industry​.uKSICRange[]​.from string UKSIC Code Range Lower Bound
bal​.industry​.uKSICRange[]​.to string UKSIC Code Range Upper Bound
bal​.location CompanyLocation Type of location for the company; headquarters, branch office, etc.
bal​.location​.areaCode Array of string US or Canadian Phone Number Area Code
bal​.location​.streetAddress Array of string Street Address
bal​.location​.county Array of County Company County
bal​.location​.county[]​.countyId string County ID
bal​.location​.county[]​.state string State
bal​.location​.county[]​.countryId long Country ID - D&B-assigned code which identifies the country where the business is located.
bal​.location​.city Array of string City
bal​.location​.countryId Array of long Country ID - D&B-assigned code which identifies the country where the business is located.
bal​.location​.globalState Array of string Global State/Province
bal​.location​.metropolitanId Array of long US Metropolitan Area
bal​.location​.regionId Array of long D&B world region code which identifies the region where the business is located.
bal​.location​.usStateCanadaProvince Array of string US State/Canada Province
bal​.location​.postalCode Array of string Postal Code
bal​.location​.usZipCodeRange Array of Range
bal​.location​.usZipCodeRange[]​.from long US ZIP Code Range Lower Bound
bal​.location​.usZipCodeRange[]​.to long US ZIP Code Range Upper Bound
bal​.location​.zipAreaSearch ZipAreaSearch
bal​.location​.zipAreaSearch​.scale string Units to search in: miles or kilometers Available Values:
miles
kilometers
bal​.location​.zipAreaSearch​.radius double Number of miles or kilometers to search within
bal​.location​.zipAreaSearch​.zipCode string Zipcode to search within (78745 in the example)
bal​.location​.latLongSearch LatLongSearch
bal​.location​.latLongSearch​.scale string Units to search in: miles or kilometers Available Values:
miles
kilometers
bal​.location​.latLongSearch​.radius double Number of miles or kilometers to search within
bal​.location​.latLongSearch​.latitude double
bal​.location​.latLongSearch​.longitude double Longitude component of geo location
bal​.location​.allAny string Denotes whether all or any company location criteria are matched Available Values:
all
any
bal​.location​.ukCounty Array of string UK County name
bal​.specialtyCriteria SpecialtyCriteria
bal​.specialtyCriteria​.auditorId Array of long Obtain the Auditors ID value from the GetAdvancedSearchLookups call. Example: 'id' 1551 corresponds to PricewaterhouseCoopers AB
bal​.specialtyCriteria​.companyKeyword string Company Keyword
bal​.specialtyCriteria​.duns Array of long 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]*)".
bal​.specialtyCriteria​.dunsFrom long D-U-N-S Number lower limit
bal​.specialtyCriteria​.dunsTo long D-U-N-S Number upper limit
bal​.specialtyCriteria​.exchangeId Array of long The ID associated with the exchange where the company's stock is traded.
bal​.specialtyCriteria​.rankingId Array of long Ranking ID
bal​.specialtyCriteria​.ukRegistration Array of string UK Registration Number. Unique identifier assigned to UK companies by the government's Companies House. Example: 3443456
bal​.specialtyCriteria​.ukVat Array of string United Kingdom's Value Added Tax Number. Example: 906565610
bal​.specialtyCriteria​.yearFoundingFrom long Year of Founding or Change in Control Lower Bound
bal​.specialtyCriteria​.yearFoundingTo long Year of Founding or Change in Control (YYYY) Upper Bound
bal​.specialtyCriteria​.ultimateParentDuns Array of long The ultimate parent company D-U-N-S Number for a family of companies
bal​.specialtyCriteria​.primaryUrl Array of string Primary URL for the company
bal​.specialtyCriteria​.companyName string Company Name
bal​.specialtyCriteria​.stockTicker Array of string Stock Ticker
bal​.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.
bal​.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.
bal​.specialtyCriteria​.squareFootageFrom long Company square foot range from
bal​.specialtyCriteria​.squareFootageTo long Company square foot range to
bal​.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
bal​.specialtyCriteria​.legalStatus Array of string Legal Status of the company Available Values:
Corporation
Partnership
Proprietorship
NationalGovernmentEntity
RegionalLocalGovernmentEntity
JointVenture
NonProfitOrganization
CooperativeMutualOrganization
ForeignCompany
bal​.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
bal​.specialtyCriteria​.importer boolean Importer flag which identifies whether or not a company imports for re-manufacture or sale
bal​.specialtyCriteria​.exporter boolean Exporter flag which identifies whether or not a company exports products to other countries.
bal​.orderBy BaseOrderByTypes Order by orderByTypes: CompanyName, CompanyType, CountryName, CityName, StateName, PhoneNumber, FaxNumber, SalesGrowth12Mon, TotalAssets, SalesUS, EmployeesTotal, EmployeesHere, FiscalYearEndMonth, MarketCap, NetIncomeGrowth12Mon, EmployeeGrowth12Mon, ROE, ROA, EarningsComparison, BookValueComparison, NetIncome, PersonFirstName, PersonLastName, PersonTitle Available Values:
CompanyName
CompanyType
CountryName
CityName
StateName
PhoneNumber
FaxNumber
SalesGrowth12Mon
TotalAssets
SalesUS
EmployeesTotal
EmployeesHere
FiscalYearEndMonth
MarketCap
NetIncomeGrowth12Mon
EmployeeGrowth12Mon
ROE
ROA
EarningsComparison
BookValueComparison
NetIncome
bal​.returnSearchNavigation boolean If set to true, navigators will be returned in the response which can be used to enable drill down into search results for additional refinement. Navigators are additional criteria available for a set of results.
bal​.searchNavigation SearchNavigation
bal​.searchNavigation​.employeeSearchNavigation EmployeeSearchNavigation
bal​.searchNavigation​.employeeSearchNavigation​.employeeSearchNavigationValue Array of string An employee navigation link that can be fed back into other calls
bal​.searchNavigation​.ownershipTypeSearchNavigation OwnershipTypeSearchNavigation
bal​.searchNavigation​.ownershipTypeSearchNavigation​.ownershipTypeSearchNavigationValue Array of string
bal​.searchNavigation​.locationTypeSearchNavigation LocationTypeSearchNavigation
bal​.searchNavigation​.locationTypeSearchNavigation​.locationTypeSearchNavigationValue Array of string A location type navigation link that can be fed back into other calls
bal​.searchNavigation​.salesSearchNavigation SalesSearchNavigation
bal​.searchNavigation​.salesSearchNavigation​.salesSearchNavigationValue Array of string A sales navigation link that can be fed back into other calls
bal​.searchNavigation​.locationSearchNavigation LocationSearchNavigation
bal​.searchNavigation​.locationSearchNavigation​.countryNavigation Array of CountryNavigation
bal​.searchNavigation​.locationSearchNavigation​.countryNavigation[]​.countryNavigationValue string A country navigation link that can be fed back into other calls.
bal​.searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation Array of StateNavigation
bal​.searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation[]​.stateNavigationValue string A state/province navigation link that can be fed back into other calls.
bal​.searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation[]​.cityNavigation Array of CityNavigation
bal​.searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation[]​.cityNavigation[]​.cityNavigationValue string A city navigation link that can be fed back into other calls
bal​.searchNavigation​.industrySearchNavigation IndustrySearchNavigation
bal​.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.
bal​.searchNavigation​.industrySearchNavigation​.ussicSearchNavigationValue Array of string A US SIC navigation link that can be fed back into other calls.
bal​.searchNavigation​.industrySearchNavigation​.naicsSearchNavigationValue Array of string A NAICS navigation link that can be fed back into other calls.

Response

Element Type Notes
return CompanyResponseWrapper
return​.companies
return​.companies​.firstHit integer First Hit
return​.companies​.hits integer The total number of hits in this response.
return​.companies​.lastHit integer 1-based last hit number
return​.companies​.totalHits integer
return​.companies​.hit Array of CompanySearchResultHit
return​.companies​.hit[]​.hitNumber integer The hit number indicates the result number in the search.
return​.companies​.hit[]​.companyResults CompanyResultFields Company Results
return​.companies​.hit[]​.companyResults​.companyName string Company Name
return​.companies​.hit[]​.companyResults​.nonMarketableCompany NonMarketableReasons Non-marketable company reason such as 'Invalid address', 'Out of business', 'Key data missing/needing revision', 'Requested no marketing contact'
return​.companies​.hit[]​.companyResults​.locationType string Company Location Type such as Single Location (0), Headquarters (1), Branch (2), Branch/Division (4), Subsidiary (5)
return​.companies​.hit[]​.companyResults​.address1 string (up to 150 characters) Company address line 1
return​.companies​.hit[]​.companyResults​.city string City
return​.companies​.hit[]​.companyResults​.country string Country
return​.companies​.hit[]​.companyResults​.countryId integer Country ID - D&B-assigned code which identifies the country where the business is located.
return​.companies​.hit[]​.companyResults​.stateOrProvince string Address State/Province
return​.companies​.hit[]​.companyResults​.postalCode string Postal Code
return​.companies​.hit[]​.companyResults​.primaryUrl string Primary URL for the company
return​.companies​.hit[]​.companyResults​.parentDuns string The parent company D-U-N-S Number. A parent is a corporation that owns more than 50 percent of another corporation. The parent company may also be a subsidiary of another corporation. If the parent also has branches/divisions, then it is also a headquarters. Parents can have both direct and indirect subsidiaries, indirect subsidiaries being those that have another company in between the subsidiary and the parent.
return​.companies​.hit[]​.companyResults​.ultimateParentDuns string The ultimate parent company D-U-N-S Number for a family of companies
return​.companies​.hit[]​.companyResults​.sales decimal Annual Sales in millions
return​.companies​.hit[]​.companyResults​.hqPhone string Headquarters Phone Number
return​.companies​.hit[]​.companyResults​.doNotCallRegistry boolean Indicates whether company is listed on a UK Do Not Call registry
return​.companies​.hit[]​.companyResults​.dbas Dbas
return​.companies​.hit[]​.companyResults​.historicalIndicator boolean Indicates that the company has ceased operations and is no longer covered by editors.
return​.companies​.hit[]​.companyResults​.exchanges ExchangeList
return​.navigators CompanyNavigators Contains lists of navigation links
return​.navigators​.employeeNavigators EmployeeNavigators
return​.navigators​.employeeNavigators​.employeeNavigator Array of EmployeeNavigator
return​.navigators​.employeeNavigators​.employeeNavigator[]​.employeeNavigatorValue string
return​.navigators​.employeeNavigators​.employeeNavigator[]​.employeeNavigatorDescription string
return​.navigators​.locationTypeNavigators LocationTypeNavigators
return​.navigators​.locationTypeNavigators​.locationTypeNavigator Array of LocationTypeNavigator
return​.navigators​.locationTypeNavigators​.locationTypeNavigator[]​.locationTypeNavigatorValue string
return​.navigators​.locationTypeNavigators​.locationTypeNavigator[]​.locationTypeNavigatorDescription string
return​.navigators​.ownershipTypeNavigators OwnershipTypeNavigators
return​.navigators​.ownershipTypeNavigators​.ownershipTypeNavigator Array of OwnershipTypeNavigator
return​.navigators​.ownershipTypeNavigators​.ownershipTypeNavigator[]​.ownershipTypeNavigatorValue string
return​.navigators​.ownershipTypeNavigators​.ownershipTypeNavigator[]​.ownershipTypeNavigatorDescription string
return​.navigators​.salesNavigators SalesNavigators
return​.navigators​.salesNavigators​.salesNavigator Array of SalesNavigator
return​.navigators​.salesNavigators​.salesNavigator[]​.salesNavigatorValue string
return​.navigators​.salesNavigators​.salesNavigator[]​.salesNavigatorDescription string
return​.navigators​.locationNavigators LocationNavigators
return​.navigators​.locationNavigators​.countryNavigators CountryNavigators
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator Array of CountryNavigator
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator[]​.countryNavigatorValue string The value of a navigation link for country
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator[]​.countryNavigatorDescription string The description of a navigation link for country description
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator[]​.stateProvinceNavigators StateProvinceNavigators
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator[]​.stateProvinceNavigators​.stateProvinceNavigator Array of StateProvinceNavigator
return​.navigators​.industryNavigators IndustryNavigators
return​.navigators​.industryNavigators​.industryNavigator Array of IndustryNavigator
return​.navigators​.industryNavigators​.industryNavigator[]​.industryNavigatorValue string The value of a navigation link an for industry.
return​.navigators​.industryNavigators​.industryNavigator[]​.industryNavigatorDescription string The description of a navigation link for industry.
return​.navigators​.industryNavigators​.ussicNavigator Array of UsSicNavigator
return​.navigators​.industryNavigators​.ussicNavigator[]​.ussicNavigatorValue string The value of a navigation link for US SIC
return​.navigators​.industryNavigators​.ussicNavigator[]​.ussicNavigatorDescription string The description of a navigation link for US SIC
return​.navigators​.industryNavigators​.naicsNavigator Array of NaicsNavigator
return​.navigators​.industryNavigators​.naicsNavigator[]​.naicsNavigatorValue string The value of a navigation link for NAICS
return​.navigators​.industryNavigators​.naicsNavigator[]​.naicsNavigatorDescription string The description of a navigation link for NAICS

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:AdvancedCompanySearchRequest>
         <ns0:bal>
            <ns0:maxRecords>10</ns0:maxRecords>
            <ns0:hitOffset>0</ns0:hitOffset>
            <ns0:sortDirection>Ascending</ns0:sortDirection>
            <ns0:companySize>
               <ns0:employeesFrom>10</ns0:employeesFrom>
               <ns0:employeesTo>999</ns0:employeesTo>
            </ns0:companySize>
            <ns0:companyType>
               <ns0:locationType>1</ns0:locationType>
            </ns0:companyType>
            <ns0:financialData>
               <ns0:assetsFrom>1</ns0:assetsFrom>
            </ns0:financialData>
            <ns0:industry>
               <ns0:primaryOnly>false</ns0:primaryOnly>
               <ns0:uSSIC>08</ns0:uSSIC>
            </ns0:industry>
            <ns0:location>
               <ns0:countryId>76</ns0:countryId>
            </ns0:location>
            <ns0:specialtyCriteria>
               <ns0:legalStatus>Corporation</ns0:legalStatus>
            </ns0:specialtyCriteria>
            <ns0:orderBy>SalesUS</ns0:orderBy>
            <ns0:returnSearchNavigation>true</ns0:returnSearchNavigation>
         </ns0:bal>
      </ns0:AdvancedCompanySearchRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:AdvancedCompanySearchResponse>
         <sch:return>
            <sch:companies>
               <sch:firstHit>1</sch:firstHit>
               <sch:hits>2</sch:hits>
               <sch:lastHit>2</sch:lastHit>
               <sch:totalHits>2</sch:totalHits>
               <sch:hit>
                  <sch:hitNumber>1</sch:hitNumber>
                  <sch:companyResults>
                     <sch:companyId>15222000000000</sch:companyId>
                     <sch:duns>004059614</sch:duns>
                     <sch:companyName>The St. Joe Company</sch:companyName>
                     <sch:locationType>Headquarters</sch:locationType>
                     <sch:address1>133 S. Watersound Pkwy.</sch:address1>
                     <sch:city>Watersound</sch:city>
                     <sch:country>United States</sch:country>
                     <sch:countryId>76</sch:countryId>
                     <sch:stateOrProvince>FL</sch:stateOrProvince>
                     <sch:postalCode>32413</sch:postalCode>
                     <sch:primaryUrl>http://www.joe.com</sch:primaryUrl>
                     <sch:parentDuns>004059614</sch:parentDuns>
                     <sch:ultimateParentDuns>004059614</sch:ultimateParentDuns>
                     <sch:sales>145.285</sch:sales>
                     <sch:hqPhone>904-301-4200</sch:hqPhone>
                     <sch:doNotCallRegistry>false</sch:doNotCallRegistry>
                     <sch:dbas/>
                     <sch:historicalIndicator>false</sch:historicalIndicator>
                  </sch:companyResults>
               </sch:hit>
               <sch:hit>
                  <sch:hitNumber>2</sch:hitNumber>
                  <sch:companyResults>
                     <sch:companyId>11202000000000</sch:companyId>
                     <sch:duns>009448200</sch:duns>
                     <sch:companyName>Potlatch Corporation</sch:companyName>
                     <sch:locationType>Headquarters</sch:locationType>
                     <sch:address1>601 W. 1st Ave..</sch:address1>
                     <sch:city>Spokane</sch:city>
                     <sch:country>United States</sch:country>
                     <sch:countryId>76</sch:countryId>
                     <sch:stateOrProvince>WA</sch:stateOrProvince>
                     <sch:postalCode>99201</sch:postalCode>
                     <sch:primaryUrl>http://www.potlatchcorp.c...</sch:primaryUrl>
                     <sch:parentDuns>009448200</sch:parentDuns>
                     <sch:ultimateParentDuns>009448200</sch:ultimateParentDuns>
                     <sch:sales>497.421</sch:sales>
                     <sch:hqPhone>509-835-1500</sch:hqPhone>
                     <sch:doNotCallRegistry>false</sch:doNotCallRegistry>
                     <sch:dbas/>
                     <sch:historicalIndicator>false</sch:historicalIndicator>
                  </sch:companyResults>
               </sch:hit>
            </sch:companies>
            <sch:navigators>
               <sch:employeeNavigators>
                  <sch:employeeNavigator>
                     <sch:employeeNavigatorValue>[;4]</sch:employeeNavigatorValue>
                     <sch:employeeNavigatorDescription>&lt; 4 (0)</sch:employeeNavigatorDescription>
                  </sch:employeeNavigator>
                  <sch:employeeNavigator>
                     <sch:employeeNavigatorValue>[5;10]</sch:employeeNavigatorValue>
                     <sch:employeeNavigatorDescription>5-10 (0)</sch:employeeNavigatorDescription>
                  </sch:employeeNavigator>
                  ...
                  </sch:employeeNavigators>
               <sch:locationTypeNavigators>
                  <sch:locationTypeNavigator>
                     <sch:locationTypeNavigatorValue>1</sch:locationTypeNavigatorValue>
                     <sch:locationTypeNavigatorDescription>Headquarters (2)</sch:locationTypeNavigatorDescription>
                  </sch:locationTypeNavigator>
               </sch:locationTypeNavigators>
               <sch:ownershipTypeNavigators>
                  <sch:ownershipTypeNavigator>
                     <sch:ownershipTypeNavigatorValue>1</sch:ownershipTypeNavigatorValue>
                     <sch:ownershipTypeNavigatorDescription>Public (2)</sch:ownershipTypeNavigatorDescription>
                  </sch:ownershipTypeNavigator>
               </sch:ownershipTypeNavigators>
               <sch:salesNavigators>
                  <sch:salesNavigator>
                     <sch:salesNavigatorValue>[;1&gt;</sch:salesNavigatorValue>
                     <sch:salesNavigatorDescription>&lt; $1 million (0)</sch:salesNavigatorDescription>
                  </sch:salesNavigator>
                  <sch:salesNavigator>
                     <sch:salesNavigatorValue>[1;5&gt;</sch:salesNavigatorValue>
                     <sch:salesNavigatorDescription>$1 - less than $5 million...</sch:salesNavigatorDescription>
                  </sch:salesNavigator>
                  ...
                  </sch:salesNavigators>
               <sch:locationNavigators>
                  <sch:countryNavigators>
                     <sch:countryNavigator>
                        <sch:countryNavigatorValue>76</sch:countryNavigatorValue>
                        <sch:countryNavigatorDescription>United States (2)</sch:countryNavigatorDescription>
                        <sch:stateProvinceNavigators>
                           <sch:stateProvinceNavigator>
                              <sch:stateProvinceNavigatorValue>FL~76</sch:stateProvinceNavigatorValue>
                              <sch:stateProvinceNavigatorDescription>FL~76 (1)</sch:stateProvinceNavigatorDescription>
                              <sch:cityNavigators>
                                 <sch:cityNavigator>
                                    <sch:cityNavigatorValue>"Watersound ~FL~76"</sch:cityNavigatorValue>
                                    <sch:cityNavigatorDescription>Watersound , FL United St...</sch:cityNavigatorDescription>
                                 </sch:cityNavigator>
                              </sch:cityNavigators>
                           </sch:stateProvinceNavigator>
                           <sch:stateProvinceNavigator>
                              <sch:stateProvinceNavigatorValue>WA~76</sch:stateProvinceNavigatorValue>
                              <sch:stateProvinceNavigatorDescription>WA~76 (1)</sch:stateProvinceNavigatorDescription>
                              <sch:cityNavigators>
                                 <sch:cityNavigator>
                                    <sch:cityNavigatorValue>Spokane~WA~76</sch:cityNavigatorValue>
                                    <sch:cityNavigatorDescription>Spokane, WA United States...</sch:cityNavigatorDescription>
                                 </sch:cityNavigator>
                              </sch:cityNavigators>
                           </sch:stateProvinceNavigator>
                        </sch:stateProvinceNavigators>
                     </sch:countryNavigator>
                  </sch:countryNavigators>
               </sch:locationNavigators>
               <sch:industryNavigators>
                  <sch:industryNavigator>
                     <sch:industryNavigatorValue>1513</sch:industryNavigatorValue>
                     <sch:industryNavigatorDescription>Land REITs (1)</sch:industryNavigatorDescription>
                  </sch:industryNavigator>
                  <sch:industryNavigator>
                     <sch:industryNavigatorValue>1517</sch:industryNavigatorValue>
                     <sch:industryNavigatorDescription>Residential Real Estate D...</sch:industryNavigatorDescription>
                  </sch:industryNavigator>
                  <sch:ussicNavigator>
                     <sch:ussicNavigatorValue>^65520000$</sch:ussicNavigatorValue>
                     <sch:ussicNavigatorDescription>65520000 Subdividers and ...</sch:ussicNavigatorDescription>
                  </sch:ussicNavigator>
                  <sch:ussicNavigator>
                     <sch:ussicNavigatorValue>^67980000$</sch:ussicNavigatorValue>
                     <sch:ussicNavigatorDescription>67980000 Real estate inve...</sch:ussicNavigatorDescription>
                  </sch:ussicNavigator>
                  <sch:naicsNavigator>
                     <sch:naicsNavigatorValue>^113310$</sch:naicsNavigatorValue>
                     <sch:naicsNavigatorDescription>113310 Logging (1)</sch:naicsNavigatorDescription>
                  </sch:naicsNavigator>
                  <sch:naicsNavigator>
                     <sch:naicsNavigatorValue>^237210$</sch:naicsNavigatorValue>
                     <sch:naicsNavigatorDescription>237210 Land Subdivision (...</sch:naicsNavigatorDescription>
                  </sch:naicsNavigator>
               </sch:industryNavigators>
            </sch:navigators>
         </sch:return>
      </sch:AdvancedCompanySearchResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:AdvancedCompanySearchRequest>
         <ns0:bal>
            <ns0:maxRecords>10</ns0:maxRecords>
            <ns0:hitOffset>0</ns0:hitOffset>
            <ns0:sortDirection>Ascending</ns0:sortDirection>
            <ns0:companySize>
               <ns0:employeesFrom>10</ns0:employeesFrom>
               <ns0:employeesTo>999</ns0:employeesTo>
            </ns0:companySize>
            <ns0:companyType>
               <ns0:locationType>1</ns0:locationType>
            </ns0:companyType>
            <ns0:financialData>
               <ns0:assetsFrom>1</ns0:assetsFrom>
            </ns0:financialData>
            <ns0:industry>
               <ns0:primaryOnly>false</ns0:primaryOnly>
               <ns0:uSSIC>08</ns0:uSSIC>
            </ns0:industry>
            <ns0:location>
               <ns0:countryId>76</ns0:countryId>
            </ns0:location>
            <ns0:specialtyCriteria>
               <ns0:legalStatus>Corporation</ns0:legalStatus>
            </ns0:specialtyCriteria>
            <ns0:orderBy>SalesUS</ns0:orderBy>
            <ns0:returnSearchNavigation>true</ns0:returnSearchNavigation>
         </ns0:bal>
      </ns0:AdvancedCompanySearchRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:AdvancedCompanySearch" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

AdvancedCompanySearchOptionalData Included in Base Package

Returns search result of companies based on various criteria.

Request

Element Type Notes
bal Required
bal​.maxRecords integer Maximum records to retrieve (1-200).
bal​.hitOffset integer Zero-based offset used to indicate at what record to start returning results.
bal​.sortDirection string Sort direction types are Ascending or Descending Available Values:
Ascending
Descending
bal​.companySize CompanySize
bal​.companySize​.employeesFrom long Employees Lower Bound. The definition of employee depends on which part of the organization is referenced in the family tree.
bal​.companySize​.employeesTo long Employees Upper Bound. The definition of employee depends on which part of the organization is referenced in the family tree.
bal​.companySize​.employeesGrowthFrom double Total Employees Growth Percentage Lower Bound
bal​.companySize​.employeesGrowthTo double Total Employees Growth Percentage Upper Bound
bal​.companySize​.employeesThisLocationFrom long Employees at this Location Lower Bound
bal​.companySize​.employeesThisLocationTo long Employees at this Location Upper Bound
bal​.companySize​.marketCapFrom decimal 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.
bal​.companySize​.marketCapTo decimal 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.
bal​.companySize​.salesFrom decimal Annual Sales ($ mil) Lower Bound
bal​.companySize​.salesTo decimal Annual Sales ($ mil) Upper Bound
bal​.companySize​.salesGrowthFrom double Annual Sales Growth (%) Lower Bound
bal​.companySize​.salesGrowthTo double Annual Sales Growth (%) Upper Bound
bal​.companyType CompanyType 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.
bal​.companyType​.locationType Array of integer Company Location Type such as Single Location (0), Headquarters (1), Branch (2), Branch/Division (4), Subsidiary (5)
bal​.companyType​.ownershipType Array of integer 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).
bal​.companyType​.subsidiaryStatus Array of integer 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).
bal​.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.
bal​.financialData FinancialData
bal​.financialData​.advertisingExpenseFrom decimal Advertising Expense (expressed in millions of US Dollars) Lower Bound
bal​.financialData​.advertisingExpenseTo decimal Advertising Expense (expressed in millions of US Dollars) Upper Bound
bal​.financialData​.assetsFrom decimal Assets (expressed in millions of US Dollars) Lower Bound
bal​.financialData​.assetsTo decimal Assets (expressed in millions of US Dollars) Upper Bound
bal​.financialData​.filingDateFrom date Filing Date Lower Bound
bal​.financialData​.filingDateTo date Filing Date Upper Bound
bal​.financialData​.fiscalYearEnd Array of long The month the fiscal year ends. Not all financial fiscal year ranges end in December, for example.
bal​.financialData​.incomeFrom decimal Net Income (expressed in millions of US Dollars) Lower Bound
bal​.financialData​.incomeGrowthFrom double Net Income Growth (%) Lower Bound
bal​.financialData​.incomeGrowthTo double Net Income Growth (%) Upper Bound
bal​.financialData​.incomeTo decimal Net Income (expressed in millions of US Dollars) Upper Bound
bal​.financialData​.offerFrom decimal US IPO Data - Offer Amount (expressed in milions of USD) Lower Bound
bal​.financialData​.offerTo decimal US IPO Data - Offer Amount (expressed in milions of USD) Upper Bound
bal​.financialData​.priceRangeFrom decimal US IPO Data - Price Range ($) Lower Bound
bal​.financialData​.priceRangeTo decimal US IPO Data - Price Range ($) Upper Bound
bal​.financialData​.researchExpenseFrom decimal R&D Expense ($ mil) Lower Bound
bal​.financialData​.researchExpenseTo decimal R&D Expense ($ mil) Upper Bound
bal​.financialData​.tradingDateFrom date Trading Date Lower Bound
bal​.financialData​.tradingDateTo date Trading Date Upper Bound
bal​.financialData​.underwriterId Array of long 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.
bal​.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
bal​.industry Industry
bal​.industry​.dnbIndustryCode Array of integer D&B Industry Code
bal​.industry​.primaryOnly boolean Restricts the search to only the primary company industry
bal​.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.
bal​.industry​.nAICSRange Array of StringRange
bal​.industry​.nAICSRange[]​.from string NAICS Code Range Lower Bound
bal​.industry​.nAICSRange[]​.to string NAICS Code Range Upper Bound
bal​.industry​.uSSIC Array of string US SIC Code: "SIC" (Standard Industrial Classification) is an industry code system developed by the US Government.
bal​.industry​.uSSICRange Array of StringRange
bal​.industry​.uSSICRange[]​.from string SIC Code Range Lower Bound
bal​.industry​.uSSICRange[]​.to string SIC Code Range Upper Bound
bal​.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.
bal​.industry​.uKSICRange Array of StringRange
bal​.industry​.uKSICRange[]​.from string UKSIC Code Range Lower Bound
bal​.industry​.uKSICRange[]​.to string UKSIC Code Range Upper Bound
bal​.location CompanyLocation Type of location for the company; headquarters, branch office, etc.
bal​.location​.areaCode Array of string US or Canadian Phone Number Area Code
bal​.location​.streetAddress Array of string Street Address
bal​.location​.county Array of County Company County
bal​.location​.county[]​.countyId string County ID
bal​.location​.county[]​.state string State
bal​.location​.county[]​.countryId long Country ID - D&B-assigned code which identifies the country where the business is located.
bal​.location​.city Array of string City
bal​.location​.countryId Array of long Country ID - D&B-assigned code which identifies the country where the business is located.
bal​.location​.globalState Array of string Global State/Province
bal​.location​.metropolitanId Array of long US Metropolitan Area
bal​.location​.regionId Array of long D&B world region code which identifies the region where the business is located.
bal​.location​.usStateCanadaProvince Array of string US State/Canada Province
bal​.location​.postalCode Array of string Postal Code
bal​.location​.usZipCodeRange Array of Range
bal​.location​.usZipCodeRange[]​.from long US ZIP Code Range Lower Bound
bal​.location​.usZipCodeRange[]​.to long US ZIP Code Range Upper Bound
bal​.location​.zipAreaSearch ZipAreaSearch
bal​.location​.zipAreaSearch​.scale string Units to search in: miles or kilometers Available Values:
miles
kilometers
bal​.location​.zipAreaSearch​.radius double Number of miles or kilometers to search within
bal​.location​.zipAreaSearch​.zipCode string Zipcode to search within (78745 in the example)
bal​.location​.latLongSearch LatLongSearch
bal​.location​.latLongSearch​.scale string Units to search in: miles or kilometers Available Values:
miles
kilometers
bal​.location​.latLongSearch​.radius double Number of miles or kilometers to search within
bal​.location​.latLongSearch​.latitude double
bal​.location​.latLongSearch​.longitude double Longitude component of geo location
bal​.location​.allAny string Denotes whether all or any company location criteria are matched Available Values:
all
any
bal​.location​.ukCounty Array of string UK County name
bal​.specialtyCriteria SpecialtyCriteria
bal​.specialtyCriteria​.auditorId Array of long Obtain the Auditors ID value from the GetAdvancedSearchLookups call. Example: 'id' 1551 corresponds to PricewaterhouseCoopers AB
bal​.specialtyCriteria​.companyKeyword string Company Keyword
bal​.specialtyCriteria​.duns Array of long 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]*)".
bal​.specialtyCriteria​.dunsFrom long D-U-N-S Number lower limit
bal​.specialtyCriteria​.dunsTo long D-U-N-S Number upper limit
bal​.specialtyCriteria​.exchangeId Array of long The ID associated with the exchange where the company's stock is traded.
bal​.specialtyCriteria​.rankingId Array of long Ranking ID
bal​.specialtyCriteria​.ukRegistration Array of string UK Registration Number. Unique identifier assigned to UK companies by the government's Companies House. Example: 3443456
bal​.specialtyCriteria​.ukVat Array of string United Kingdom's Value Added Tax Number. Example: 906565610
bal​.specialtyCriteria​.yearFoundingFrom long Year of Founding or Change in Control Lower Bound
bal​.specialtyCriteria​.yearFoundingTo long Year of Founding or Change in Control (YYYY) Upper Bound
bal​.specialtyCriteria​.ultimateParentDuns Array of long The ultimate parent company D-U-N-S Number for a family of companies
bal​.specialtyCriteria​.primaryUrl Array of string Primary URL for the company
bal​.specialtyCriteria​.companyName string Company Name
bal​.specialtyCriteria​.stockTicker Array of string Stock Ticker
bal​.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.
bal​.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.
bal​.specialtyCriteria​.squareFootageFrom long Company square foot range from
bal​.specialtyCriteria​.squareFootageTo long Company square foot range to
bal​.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
bal​.specialtyCriteria​.legalStatus Array of string Legal Status of the company Available Values:
Corporation
Partnership
Proprietorship
NationalGovernmentEntity
RegionalLocalGovernmentEntity
JointVenture
NonProfitOrganization
CooperativeMutualOrganization
ForeignCompany
bal​.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
bal​.specialtyCriteria​.importer boolean Importer flag which identifies whether or not a company imports for re-manufacture or sale
bal​.specialtyCriteria​.exporter boolean Exporter flag which identifies whether or not a company exports products to other countries.
bal​.orderBy BaseOrderByTypes Order by orderByTypes: CompanyName, CompanyType, CountryName, CityName, StateName, PhoneNumber, FaxNumber, SalesGrowth12Mon, TotalAssets, SalesUS, EmployeesTotal, EmployeesHere, FiscalYearEndMonth, MarketCap, NetIncomeGrowth12Mon, EmployeeGrowth12Mon, ROE, ROA, EarningsComparison, BookValueComparison, NetIncome, PersonFirstName, PersonLastName, PersonTitle Available Values:
CompanyName
CompanyType
CountryName
CityName
StateName
PhoneNumber
FaxNumber
SalesGrowth12Mon
TotalAssets
SalesUS
EmployeesTotal
EmployeesHere
FiscalYearEndMonth
MarketCap
NetIncomeGrowth12Mon
EmployeeGrowth12Mon
ROE
ROA
EarningsComparison
BookValueComparison
NetIncome
bal​.optionalResponseFields OptionalResponseFields
bal​.optionalResponseFields​.includeHistoricalInfo boolean Optional Response Field to indicate that the historical information should be returned with in the results
bal​.optionalResponseFields​.includeGeoLocationInfo boolean Optional Response Field to indicate that geo location information should be returned with in the results
bal​.optionalResponseFields​.includeExchangeInfo boolean Optional Response Field to indicate that Exchange information should be returned with in the results
bal​.optionalResponseFields​.includeOptionalCompanyInfo boolean Optional Response Field to indicate that Optional Company information should be returned with in the results
bal​.returnSearchNavigation boolean If set to true, navigators will be returned in the response which can be used to enable drill down into search results for additional refinement. Navigators are additional criteria available for a set of results.
bal​.searchNavigation SearchNavigation
bal​.searchNavigation​.employeeSearchNavigation EmployeeSearchNavigation
bal​.searchNavigation​.employeeSearchNavigation​.employeeSearchNavigationValue Array of string An employee navigation link that can be fed back into other calls
bal​.searchNavigation​.ownershipTypeSearchNavigation OwnershipTypeSearchNavigation
bal​.searchNavigation​.ownershipTypeSearchNavigation​.ownershipTypeSearchNavigationValue Array of string
bal​.searchNavigation​.locationTypeSearchNavigation LocationTypeSearchNavigation
bal​.searchNavigation​.locationTypeSearchNavigation​.locationTypeSearchNavigationValue Array of string A location type navigation link that can be fed back into other calls
bal​.searchNavigation​.salesSearchNavigation SalesSearchNavigation
bal​.searchNavigation​.salesSearchNavigation​.salesSearchNavigationValue Array of string A sales navigation link that can be fed back into other calls
bal​.searchNavigation​.locationSearchNavigation LocationSearchNavigation
bal​.searchNavigation​.locationSearchNavigation​.countryNavigation Array of CountryNavigation
bal​.searchNavigation​.locationSearchNavigation​.countryNavigation[]​.countryNavigationValue string A country navigation link that can be fed back into other calls.
bal​.searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation Array of StateNavigation
bal​.searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation[]​.stateNavigationValue string A state/province navigation link that can be fed back into other calls.
bal​.searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation[]​.cityNavigation Array of CityNavigation
bal​.searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation[]​.cityNavigation[]​.cityNavigationValue string A city navigation link that can be fed back into other calls
bal​.searchNavigation​.industrySearchNavigation IndustrySearchNavigation
bal​.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.
bal​.searchNavigation​.industrySearchNavigation​.ussicSearchNavigationValue Array of string A US SIC navigation link that can be fed back into other calls.
bal​.searchNavigation​.industrySearchNavigation​.naicsSearchNavigationValue Array of string A NAICS navigation link that can be fed back into other calls.

Response

Element Type Notes
return CompanyOptionalDataResponseWrapper
return​.companies
return​.companies​.firstHit integer First Hit
return​.companies​.hits integer The total number of hits in this response.
return​.companies​.lastHit integer 1-based last hit number
return​.companies​.totalHits integer
return​.companies​.hit Array of CompanySearchOptionalDataResultHit
return​.companies​.hit[]​.hitNumber integer The hit number indicates the result number in the search.
return​.companies​.hit[]​.companyResults CompanyResultOptionalDataFields Company Results
return​.companies​.hit[]​.companyResults​.primaryContact string
return​.companies​.hit[]​.companyResults​.primaryContactTitle string
return​.companies​.hit[]​.companyResults​.primaryUSSIC string Primary US SIC Code. "SIC" (Standard Industrial Classification) is an industry code system developed by the US Government. 2 to 8 digit SIC codes are supported.
return​.companies​.hit[]​.companyResults​.numberOfEmployeesTotal integer
return​.companies​.hit[]​.companyResults​.historicalInfo HistoricalInfo
return​.companies​.hit[]​.companyResults​.geoLocationInfo GeoLocationInfo
return​.companies​.hit[]​.companyResults​.exchangeInfoList ExchangeInfoList
return​.companies​.hit[]​.companyResults​.optionalCompanyInfo OptionalCompanyInfo
return​.navigators CompanyNavigators Contains lists of navigation links
return​.navigators​.employeeNavigators EmployeeNavigators
return​.navigators​.employeeNavigators​.employeeNavigator Array of EmployeeNavigator
return​.navigators​.employeeNavigators​.employeeNavigator[]​.employeeNavigatorValue string
return​.navigators​.employeeNavigators​.employeeNavigator[]​.employeeNavigatorDescription string
return​.navigators​.locationTypeNavigators LocationTypeNavigators
return​.navigators​.locationTypeNavigators​.locationTypeNavigator Array of LocationTypeNavigator
return​.navigators​.locationTypeNavigators​.locationTypeNavigator[]​.locationTypeNavigatorValue string
return​.navigators​.locationTypeNavigators​.locationTypeNavigator[]​.locationTypeNavigatorDescription string
return​.navigators​.ownershipTypeNavigators OwnershipTypeNavigators
return​.navigators​.ownershipTypeNavigators​.ownershipTypeNavigator Array of OwnershipTypeNavigator
return​.navigators​.ownershipTypeNavigators​.ownershipTypeNavigator[]​.ownershipTypeNavigatorValue string
return​.navigators​.ownershipTypeNavigators​.ownershipTypeNavigator[]​.ownershipTypeNavigatorDescription string
return​.navigators​.salesNavigators SalesNavigators
return​.navigators​.salesNavigators​.salesNavigator Array of SalesNavigator
return​.navigators​.salesNavigators​.salesNavigator[]​.salesNavigatorValue string
return​.navigators​.salesNavigators​.salesNavigator[]​.salesNavigatorDescription string
return​.navigators​.locationNavigators LocationNavigators
return​.navigators​.locationNavigators​.countryNavigators CountryNavigators
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator Array of CountryNavigator
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator[]​.countryNavigatorValue string The value of a navigation link for country
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator[]​.countryNavigatorDescription string The description of a navigation link for country description
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator[]​.stateProvinceNavigators StateProvinceNavigators
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator[]​.stateProvinceNavigators​.stateProvinceNavigator Array of StateProvinceNavigator
return​.navigators​.industryNavigators IndustryNavigators
return​.navigators​.industryNavigators​.industryNavigator Array of IndustryNavigator
return​.navigators​.industryNavigators​.industryNavigator[]​.industryNavigatorValue string The value of a navigation link an for industry.
return​.navigators​.industryNavigators​.industryNavigator[]​.industryNavigatorDescription string The description of a navigation link for industry.
return​.navigators​.industryNavigators​.ussicNavigator Array of UsSicNavigator
return​.navigators​.industryNavigators​.ussicNavigator[]​.ussicNavigatorValue string The value of a navigation link for US SIC
return​.navigators​.industryNavigators​.ussicNavigator[]​.ussicNavigatorDescription string The description of a navigation link for US SIC
return​.navigators​.industryNavigators​.naicsNavigator Array of NaicsNavigator
return​.navigators​.industryNavigators​.naicsNavigator[]​.naicsNavigatorValue string The value of a navigation link for NAICS
return​.navigators​.industryNavigators​.naicsNavigator[]​.naicsNavigatorDescription string The description of a navigation link for NAICS

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:AdvancedCompanySearchOptionalDataRequest>
         <ns0:bal>
            <ns0:maxRecords>10</ns0:maxRecords>
            <ns0:hitOffset>0</ns0:hitOffset>
            <ns0:sortDirection>Ascending</ns0:sortDirection>
            <ns0:companySize>
               <ns0:employeesFrom>10</ns0:employeesFrom>
               <ns0:employeesTo>999</ns0:employeesTo>
            </ns0:companySize>
            <ns0:companyType>
               <ns0:locationType>1</ns0:locationType>
            </ns0:companyType>
            <ns0:financialData>
               <ns0:assetsFrom>1</ns0:assetsFrom>
            </ns0:financialData>
            <ns0:industry>
               <ns0:primaryOnly>false</ns0:primaryOnly>
               <ns0:uSSIC>08</ns0:uSSIC>
            </ns0:industry>
            <ns0:location>
               <ns0:countryId>76</ns0:countryId>
            </ns0:location>
            <ns0:specialtyCriteria>
               <ns0:legalStatus>Corporation</ns0:legalStatus>
            </ns0:specialtyCriteria>
            <ns0:orderBy>SalesUS</ns0:orderBy>
            <ns0:optionalResponseFields>
               <ns0:includeHistoricalInfo>true</ns0:includeHistoricalInfo>
               <ns0:includeGeoLocationInfo>true</ns0:includeGeoLocationInfo>
               <ns0:includeExchangeInfo>false</ns0:includeExchangeInfo>
            </ns0:optionalResponseFields>
            <ns0:returnSearchNavigation>true</ns0:returnSearchNavigation>
         </ns0:bal>
      </ns0:AdvancedCompanySearchOptionalDataRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:AdvancedCompanySearchOptionalDataResponse>
         <sch:return>
            <sch:companies>
               <sch:firstHit>1</sch:firstHit>
               <sch:hits>2</sch:hits>
               <sch:lastHit>2</sch:lastHit>
               <sch:totalHits>2</sch:totalHits>
               <sch:hit>
                  <sch:hitNumber>1</sch:hitNumber>
                  <sch:companyResults>
                     <sch:companyId>15222000000000</sch:companyId>
                     <sch:duns>004059614</sch:duns>
                     <sch:companyName>The St. Joe Company</sch:companyName>
                     <sch:locationType>Headquarters</sch:locationType>
                     <sch:address1>133 S. Watersound Pkwy.</sch:address1>
                     <sch:city>Watersound</sch:city>
                     <sch:country>United States</sch:country>
                     <sch:countryId>76</sch:countryId>
                     <sch:stateOrProvince>FL</sch:stateOrProvince>
                     <sch:postalCode>32413</sch:postalCode>
                     <sch:primaryUrl>http://www.joe.com</sch:primaryUrl>
                     <sch:parentDuns>004059614</sch:parentDuns>
                     <sch:ultimateParentDuns>004059614</sch:ultimateParentDuns>
                     <sch:sales>145.285</sch:sales>
                     <sch:hqPhone>904-301-4200</sch:hqPhone>
                     <sch:doNotCallRegistry>false</sch:doNotCallRegistry>
                     <sch:dbas/>
                     <sch:historicalIndicator>false</sch:historicalIndicator>
                     <sch:primaryContact>Bruce R. Berkowitz</sch:primaryContact>
                     <sch:primaryContactTitle>Chairman</sch:primaryContactTitle>
                     <sch:primaryUSSIC>65520000</sch:primaryUSSIC>
                     <sch:numberOfEmployeesTotal>75</sch:numberOfEmployeesTotal>
                     <sch:historicalInfo xsi:nil="true"/>
                     <sch:geoLocationInfo>
                        <sch:latitude>30.27505</sch:latitude>
                        <sch:longitude>-86.00356</sch:longitude>
                        <sch:latLongAccuracy>0</sch:latLongAccuracy>
                     </sch:geoLocationInfo>
                  </sch:companyResults>
               </sch:hit>
               <sch:hit>
                  <sch:hitNumber>2</sch:hitNumber>
                  <sch:companyResults>
                     <sch:companyId>11202000000000</sch:companyId>
                     <sch:duns>009448200</sch:duns>
                     <sch:companyName>Potlatch Corporation</sch:companyName>
                     <sch:locationType>Headquarters</sch:locationType>
                     <sch:address1>601 W. 1st Ave..</sch:address1>
                     <sch:city>Spokane</sch:city>
                     <sch:country>United States</sch:country>
                     <sch:countryId>76</sch:countryId>
                     <sch:stateOrProvince>WA</sch:stateOrProvince>
                     <sch:postalCode>99201</sch:postalCode>
                     <sch:primaryUrl>http://www.potlatchcorp.c...</sch:primaryUrl>
                     <sch:parentDuns>009448200</sch:parentDuns>
                     <sch:ultimateParentDuns>009448200</sch:ultimateParentDuns>
                     <sch:sales>497.421</sch:sales>
                     <sch:hqPhone>509-835-1500</sch:hqPhone>
                     <sch:doNotCallRegistry>false</sch:doNotCallRegistry>
                     <sch:dbas/>
                     <sch:historicalIndicator>false</sch:historicalIndicator>
                     <sch:primaryContact>Michael J. Covey</sch:primaryContact>
                     <sch:primaryContactTitle>Chairman, President and C...</sch:primaryContactTitle>
                     <sch:primaryUSSIC>67980000</sch:primaryUSSIC>
                     <sch:numberOfEmployeesTotal>885</sch:numberOfEmployeesTotal>
                     <sch:historicalInfo xsi:nil="true"/>
                     <sch:geoLocationInfo>
                        <sch:latitude>47.656526</sch:latitude>
                        <sch:longitude>-117.421203</sch:longitude>
                        <sch:latLongAccuracy>0</sch:latLongAccuracy>
                     </sch:geoLocationInfo>
                  </sch:companyResults>
               </sch:hit>
            </sch:companies>
            <sch:navigators>
               <sch:employeeNavigators>
                  <sch:employeeNavigator>
                     <sch:employeeNavigatorValue>[;4]</sch:employeeNavigatorValue>
                     <sch:employeeNavigatorDescription>&lt; 4 (0)</sch:employeeNavigatorDescription>
                  </sch:employeeNavigator>
                  <sch:employeeNavigator>
                     <sch:employeeNavigatorValue>[5;10]</sch:employeeNavigatorValue>
                     <sch:employeeNavigatorDescription>5-10 (0)</sch:employeeNavigatorDescription>
                  </sch:employeeNavigator>
                  ...
                  </sch:employeeNavigators>
               <sch:locationTypeNavigators>
                  <sch:locationTypeNavigator>
                     <sch:locationTypeNavigatorValue>1</sch:locationTypeNavigatorValue>
                     <sch:locationTypeNavigatorDescription>Headquarters (2)</sch:locationTypeNavigatorDescription>
                  </sch:locationTypeNavigator>
               </sch:locationTypeNavigators>
               <sch:ownershipTypeNavigators>
                  <sch:ownershipTypeNavigator>
                     <sch:ownershipTypeNavigatorValue>1</sch:ownershipTypeNavigatorValue>
                     <sch:ownershipTypeNavigatorDescription>Public (2)</sch:ownershipTypeNavigatorDescription>
                  </sch:ownershipTypeNavigator>
               </sch:ownershipTypeNavigators>
               <sch:salesNavigators>
                  <sch:salesNavigator>
                     <sch:salesNavigatorValue>[;1&gt;</sch:salesNavigatorValue>
                     <sch:salesNavigatorDescription>&lt; $1 million (0)</sch:salesNavigatorDescription>
                  </sch:salesNavigator>
                  <sch:salesNavigator>
                     <sch:salesNavigatorValue>[1;5&gt;</sch:salesNavigatorValue>
                     <sch:salesNavigatorDescription>$1 - less than $5 million...</sch:salesNavigatorDescription>
                  </sch:salesNavigator>
                  ...
                  </sch:salesNavigators>
               <sch:locationNavigators>
                  <sch:countryNavigators>
                     <sch:countryNavigator>
                        <sch:countryNavigatorValue>76</sch:countryNavigatorValue>
                        <sch:countryNavigatorDescription>United States (2)</sch:countryNavigatorDescription>
                        <sch:stateProvinceNavigators>
                           <sch:stateProvinceNavigator>
                              <sch:stateProvinceNavigatorValue>FL~76</sch:stateProvinceNavigatorValue>
                              <sch:stateProvinceNavigatorDescription>FL~76 (1)</sch:stateProvinceNavigatorDescription>
                              <sch:cityNavigators>
                                 <sch:cityNavigator>
                                    <sch:cityNavigatorValue>"Watersound ~FL~76"</sch:cityNavigatorValue>
                                    <sch:cityNavigatorDescription>Watersound , FL United St...</sch:cityNavigatorDescription>
                                 </sch:cityNavigator>
                              </sch:cityNavigators>
                           </sch:stateProvinceNavigator>
                           <sch:stateProvinceNavigator>
                              <sch:stateProvinceNavigatorValue>WA~76</sch:stateProvinceNavigatorValue>
                              <sch:stateProvinceNavigatorDescription>WA~76 (1)</sch:stateProvinceNavigatorDescription>
                              <sch:cityNavigators>
                                 <sch:cityNavigator>
                                    <sch:cityNavigatorValue>Spokane~WA~76</sch:cityNavigatorValue>
                                    <sch:cityNavigatorDescription>Spokane, WA United States...</sch:cityNavigatorDescription>
                                 </sch:cityNavigator>
                              </sch:cityNavigators>
                           </sch:stateProvinceNavigator>
                        </sch:stateProvinceNavigators>
                     </sch:countryNavigator>
                  </sch:countryNavigators>
               </sch:locationNavigators>
               <sch:industryNavigators>
                  <sch:industryNavigator>
                     <sch:industryNavigatorValue>1513</sch:industryNavigatorValue>
                     <sch:industryNavigatorDescription>Land REITs (1)</sch:industryNavigatorDescription>
                  </sch:industryNavigator>
                  <sch:industryNavigator>
                     <sch:industryNavigatorValue>1517</sch:industryNavigatorValue>
                     <sch:industryNavigatorDescription>Residential Real Estate D...</sch:industryNavigatorDescription>
                  </sch:industryNavigator>
                  <sch:ussicNavigator>
                     <sch:ussicNavigatorValue>^65520000$</sch:ussicNavigatorValue>
                     <sch:ussicNavigatorDescription>65520000 Subdividers and ...</sch:ussicNavigatorDescription>
                  </sch:ussicNavigator>
                  <sch:ussicNavigator>
                     <sch:ussicNavigatorValue>^67980000$</sch:ussicNavigatorValue>
                     <sch:ussicNavigatorDescription>67980000 Real estate inve...</sch:ussicNavigatorDescription>
                  </sch:ussicNavigator>
                  <sch:naicsNavigator>
                     <sch:naicsNavigatorValue>^113310$</sch:naicsNavigatorValue>
                     <sch:naicsNavigatorDescription>113310 Logging (1)</sch:naicsNavigatorDescription>
                  </sch:naicsNavigator>
                  <sch:naicsNavigator>
                     <sch:naicsNavigatorValue>^237210$</sch:naicsNavigatorValue>
                     <sch:naicsNavigatorDescription>237210 Land Subdivision (...</sch:naicsNavigatorDescription>
                  </sch:naicsNavigator>
               </sch:industryNavigators>
            </sch:navigators>
         </sch:return>
      </sch:AdvancedCompanySearchOptionalDataResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:AdvancedCompanySearchOptionalDataRequest>
         <ns0:bal>
            <ns0:maxRecords>10</ns0:maxRecords>
            <ns0:hitOffset>0</ns0:hitOffset>
            <ns0:sortDirection>Ascending</ns0:sortDirection>
            <ns0:companySize>
               <ns0:employeesFrom>10</ns0:employeesFrom>
               <ns0:employeesTo>999</ns0:employeesTo>
            </ns0:companySize>
            <ns0:companyType>
               <ns0:locationType>1</ns0:locationType>
            </ns0:companyType>
            <ns0:financialData>
               <ns0:assetsFrom>1</ns0:assetsFrom>
            </ns0:financialData>
            <ns0:industry>
               <ns0:primaryOnly>false</ns0:primaryOnly>
               <ns0:uSSIC>08</ns0:uSSIC>
            </ns0:industry>
            <ns0:location>
               <ns0:countryId>76</ns0:countryId>
            </ns0:location>
            <ns0:specialtyCriteria>
               <ns0:legalStatus>Corporation</ns0:legalStatus>
            </ns0:specialtyCriteria>
            <ns0:orderBy>SalesUS</ns0:orderBy>
            <ns0:optionalResponseFields>
               <ns0:includeHistoricalInfo>true</ns0:includeHistoricalInfo>
               <ns0:includeGeoLocationInfo>true</ns0:includeGeoLocationInfo>
               <ns0:includeExchangeInfo>false</ns0:includeExchangeInfo>
            </ns0:optionalResponseFields>
            <ns0:returnSearchNavigation>true</ns0:returnSearchNavigation>
         </ns0:bal>
      </ns0:AdvancedCompanySearchOptionalDataRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:AdvancedCompanySearchOptionalData" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

FindCompanyByKeyword Included in Base Package

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

Request

Element Type Notes
maxRecords integer Maximum records to retrieve (1-200).
hitOffset integer Zero-based offset used to indicate at what record to start returning results.
sortDirection string Sort direction types are Ascending or Descending Available Values:
Ascending
Descending
keyword string Required Keyword or phrase
dunsFrom long D-U-N-S Number lower limit
dunsTo long D-U-N-S Number upper limit
nonMarketableCompanyFilterOptions NonMarketableFilterOptions
nonMarketableCompanyFilterOptions​.includeUndeliverableAddress boolean If true, will return all the unmarketable company records which have undeliverable addresses.
nonMarketableCompanyFilterOptions​.includeOutOfBusiness boolean If true, will return all the unmarketable company records that are out of business.
nonMarketableCompanyFilterOptions​.includeIncompleteData boolean If true, will return all the unmarketable company records which have incomplete data.
searchBy Array of string One of the included enumerations called SearchByFields Available Values:
companyName
stockSymbol
returnSearchNavigation boolean If set to true, navigators will be returned in the response which can be used to enable drill down into search results for additional refinement. Navigators are additional criteria available for a set of results.
orderBy BaseOrderByTypes Order by orderByTypes: CompanyName, CompanyType, CountryName, CityName, StateName, PhoneNumber, FaxNumber, SalesGrowth12Mon, TotalAssets, SalesUS, EmployeesTotal, EmployeesHere, FiscalYearEndMonth, MarketCap, NetIncomeGrowth12Mon, EmployeeGrowth12Mon, ROE, ROA, EarningsComparison, BookValueComparison, NetIncome, PersonFirstName, PersonLastName, PersonTitle Available Values:
CompanyName
CompanyType
CountryName
CityName
StateName
PhoneNumber
FaxNumber
SalesGrowth12Mon
TotalAssets
SalesUS
EmployeesTotal
EmployeesHere
FiscalYearEndMonth
MarketCap
NetIncomeGrowth12Mon
EmployeeGrowth12Mon
ROE
ROA
EarningsComparison
BookValueComparison
NetIncome
searchNavigation SearchNavigation
searchNavigation​.employeeSearchNavigation EmployeeSearchNavigation
searchNavigation​.employeeSearchNavigation​.employeeSearchNavigationValue Array of string An employee navigation link that can be fed back into other calls
searchNavigation​.ownershipTypeSearchNavigation OwnershipTypeSearchNavigation
searchNavigation​.ownershipTypeSearchNavigation​.ownershipTypeSearchNavigationValue Array of string
searchNavigation​.locationTypeSearchNavigation LocationTypeSearchNavigation
searchNavigation​.locationTypeSearchNavigation​.locationTypeSearchNavigationValue Array of string A location type navigation link that can be fed back into other calls
searchNavigation​.salesSearchNavigation SalesSearchNavigation
searchNavigation​.salesSearchNavigation​.salesSearchNavigationValue Array of string A sales navigation link that can be fed back into other calls
searchNavigation​.locationSearchNavigation LocationSearchNavigation
searchNavigation​.locationSearchNavigation​.countryNavigation Array of CountryNavigation
searchNavigation​.locationSearchNavigation​.countryNavigation[]​.countryNavigationValue string A country navigation link that can be fed back into other calls.
searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation Array of StateNavigation
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 CityNavigation
searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation[]​.cityNavigation[]​.cityNavigationValue string A city navigation link that can be fed back into other calls
searchNavigation​.industrySearchNavigation IndustrySearchNavigation
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.

Response

Element Type Notes
return
return​.resultSet CompanySearchResultSet
return​.resultSet​.firstHit integer First Hit
return​.resultSet​.hits integer The total number of hits in this response.
return​.resultSet​.lastHit integer 1-based last hit number
return​.resultSet​.totalHits integer Total number of records matching the search criteria
return​.resultSet​.hit Array of CompanySearchResultHit
return​.resultSet​.hit[]​.hitNumber integer The hit number indicates the result number in the search.
return​.resultSet​.hit[]​.companyResults CompanyResultFields Company Results
return​.resultSet​.hit[]​.companyResults​.companyName string Company Name
return​.resultSet​.hit[]​.companyResults​.nonMarketableCompany NonMarketableReasons Non-marketable company reason such as 'Invalid address', 'Out of business', 'Key data missing/needing revision', 'Requested no marketing contact'
return​.resultSet​.hit[]​.companyResults​.locationType string Company Location Type such as Single Location (0), Headquarters (1), Branch (2), Branch/Division (4), Subsidiary (5)
return​.resultSet​.hit[]​.companyResults​.address1 string (up to 150 characters) Company address line 1
return​.resultSet​.hit[]​.companyResults​.city string City
return​.resultSet​.hit[]​.companyResults​.country string Country
return​.resultSet​.hit[]​.companyResults​.countryId integer Country ID - D&B-assigned code which identifies the country where the business is located.
return​.resultSet​.hit[]​.companyResults​.stateOrProvince string Address State/Province
return​.resultSet​.hit[]​.companyResults​.postalCode string Postal Code
return​.resultSet​.hit[]​.companyResults​.primaryUrl string Primary URL for the company
return​.resultSet​.hit[]​.companyResults​.parentDuns string The parent company D-U-N-S Number. A parent is a corporation that owns more than 50 percent of another corporation. The parent company may also be a subsidiary of another corporation. If the parent also has branches/divisions, then it is also a headquarters. Parents can have both direct and indirect subsidiaries, indirect subsidiaries being those that have another company in between the subsidiary and the parent.
return​.resultSet​.hit[]​.companyResults​.ultimateParentDuns string The ultimate parent company D-U-N-S Number for a family of companies
return​.resultSet​.hit[]​.companyResults​.sales decimal Annual Sales in millions
return​.resultSet​.hit[]​.companyResults​.hqPhone string Headquarters Phone Number
return​.resultSet​.hit[]​.companyResults​.doNotCallRegistry boolean Indicates whether company is listed on a UK Do Not Call registry
return​.resultSet​.hit[]​.companyResults​.dbas Dbas
return​.resultSet​.hit[]​.companyResults​.historicalIndicator boolean Indicates that the company has ceased operations and is no longer covered by editors.
return​.resultSet​.hit[]​.companyResults​.exchanges ExchangeList
return​.navigators CompanyNavigators Contains lists of navigation links
return​.navigators​.employeeNavigators EmployeeNavigators
return​.navigators​.employeeNavigators​.employeeNavigator Array of EmployeeNavigator
return​.navigators​.employeeNavigators​.employeeNavigator[]​.employeeNavigatorValue string
return​.navigators​.employeeNavigators​.employeeNavigator[]​.employeeNavigatorDescription string
return​.navigators​.locationTypeNavigators LocationTypeNavigators
return​.navigators​.locationTypeNavigators​.locationTypeNavigator Array of LocationTypeNavigator
return​.navigators​.locationTypeNavigators​.locationTypeNavigator[]​.locationTypeNavigatorValue string
return​.navigators​.locationTypeNavigators​.locationTypeNavigator[]​.locationTypeNavigatorDescription string
return​.navigators​.ownershipTypeNavigators OwnershipTypeNavigators
return​.navigators​.ownershipTypeNavigators​.ownershipTypeNavigator Array of OwnershipTypeNavigator
return​.navigators​.ownershipTypeNavigators​.ownershipTypeNavigator[]​.ownershipTypeNavigatorValue string
return​.navigators​.ownershipTypeNavigators​.ownershipTypeNavigator[]​.ownershipTypeNavigatorDescription string
return​.navigators​.salesNavigators SalesNavigators
return​.navigators​.salesNavigators​.salesNavigator Array of SalesNavigator
return​.navigators​.salesNavigators​.salesNavigator[]​.salesNavigatorValue string
return​.navigators​.salesNavigators​.salesNavigator[]​.salesNavigatorDescription string
return​.navigators​.locationNavigators LocationNavigators
return​.navigators​.locationNavigators​.countryNavigators CountryNavigators
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator Array of CountryNavigator
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator[]​.countryNavigatorValue string The value of a navigation link for country
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator[]​.countryNavigatorDescription string The description of a navigation link for country description
return​.navigators​.locationNavigators​.countryNavigators​.countryNavigator[]​.stateProvinceNavigators StateProvinceNavigators
return​.navigators​.industryNavigators IndustryNavigators
return​.navigators​.industryNavigators​.industryNavigator Array of IndustryNavigator
return​.navigators​.industryNavigators​.industryNavigator[]​.industryNavigatorValue string The value of a navigation link an for industry.
return​.navigators​.industryNavigators​.industryNavigator[]​.industryNavigatorDescription string The description of a navigation link for industry.
return​.navigators​.industryNavigators​.ussicNavigator Array of UsSicNavigator
return​.navigators​.industryNavigators​.ussicNavigator[]​.ussicNavigatorValue string The value of a navigation link for US SIC
return​.navigators​.industryNavigators​.ussicNavigator[]​.ussicNavigatorDescription string The description of a navigation link for US SIC
return​.navigators​.industryNavigators​.naicsNavigator Array of NaicsNavigator
return​.navigators​.industryNavigators​.naicsNavigator[]​.naicsNavigatorValue string The value of a navigation link for NAICS
return​.navigators​.industryNavigators​.naicsNavigator[]​.naicsNavigatorDescription string The description of a navigation link for NAICS

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:FindCompanyByKeywordRequest>
         <ns0:keyword>Aerospace</ns0:keyword>
      </ns0:FindCompanyByKeywordRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:FindCompanyByKeywordResponse>
         <sch:return>
            <sch:resultSet>
               <sch:firstHit>1</sch:firstHit>
               <sch:hits>20</sch:hits>
               <sch:lastHit>20</sch:lastHit>
               <sch:totalHits>20027</sch:totalHits>
               <sch:hit>
                  <sch:hitNumber>1</sch:hitNumber>
                  <sch:companyResults>
                     <sch:companyId>135821000000000</sch:companyId>
                     <sch:duns>640771432</sch:duns>
                     <sch:companyName>NP Aerospace Ltd.</sch:companyName>
                     <sch:locationType>Headquarters</sch:locationType>
                     <sch:address1>473 Foleshill Rd.</sch:address1>
                     <sch:city>Coventry</sch:city>
                     <sch:country>United Kingdom</sch:country>
                     <sch:countryId>74</sch:countryId>
                     <sch:stateOrProvince>West Midlands</sch:stateOrProvince>
                     <sch:primaryUrl>http://www.np-aerospace.c...</sch:primaryUrl>
                     <sch:parentDuns>347628591</sch:parentDuns>
                     <sch:ultimateParentDuns>210207205</sch:ultimateParentDuns>
                     <sch:sales>141.9726322</sch:sales>
                     <sch:hqPhone>24-7670-2802</sch:hqPhone>
                     <sch:doNotCallRegistry>false</sch:doNotCallRegistry>
                     <sch:dbas/>
                     <sch:historicalIndicator>false</sch:historicalIndicator>
                     <sch:exchanges/>
                  </sch:companyResults>
               </sch:hit>
               <sch:hit>
                  <sch:hitNumber>2</sch:hitNumber>
                  <sch:companyResults>
                     <sch:companyId>134749000000000</sch:companyId>
                     <sch:duns>379784234</sch:duns>
                     <sch:companyName>Mettis Aerospace Limited</sch:companyName>
                     <sch:locationType>Single Location</sch:locationType>
                     <sch:address1>Windsor Road</sch:address1>
                     <sch:city>Redditch</sch:city>
                     <sch:country>United Kingdom</sch:country>
                     <sch:countryId>74</sch:countryId>
                     <sch:stateOrProvince>Worcestershire</sch:stateOrProvince>
                     <sch:primaryUrl>http://www.mettis-aerospa...</sch:primaryUrl>
                     <sch:parentDuns>379786304</sch:parentDuns>
                     <sch:ultimateParentDuns>165691853</sch:ultimateParentDuns>
                     <sch:sales>76.1823012</sch:sales>
                     <sch:hqPhone>1527-406-400</sch:hqPhone>
                     <sch:doNotCallRegistry>false</sch:doNotCallRegistry>
                     <sch:dbas/>
                     <sch:historicalIndicator>false</sch:historicalIndicator>
                     <sch:exchanges/>
                  </sch:companyResults>
               </sch:hit>
               ...
               </sch:resultSet>
            <sch:navigators/>
         </sch:return>
      </sch:FindCompanyByKeywordResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:FindCompanyByKeywordRequest>
         <ns0:keyword>Aerospace</ns0:keyword>
      </ns0:FindCompanyByKeywordRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:FindCompanyByKeyword" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

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.

Request

Element Type Notes
DataAreaRequest DataAreaRequestType Required
DataAreaRequest​.OrderRequest OrderRequestType 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 integer (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.

Response

Element Type Notes
DataAreaResponse DataAreaResponseType Required
DataAreaResponse​.OrderResponseHeader OrderResponseHeaderType Required
DataAreaResponse​.OrderResponseHeader​.TranID string Required The transaction ID is the unique identifier of the transaction
DataAreaResponse​.OrderResponseHeader​.Status StatusType Required
DataAreaResponse​.OrderResponseHeader​.Status​.Code integer Required Response status code that describes whether a successful response is returned or an error is returned
DataAreaResponse​.OrderResponseHeader​.Status​.Description string Required Description of the status code
DataAreaResponse​.OrderResponse OrderResponseType
DataAreaResponse​.OrderResponse​.CandidatesReturned integer The number of candidates returned. Maximum of 25 candidates will be returned for the following countries: Spain, Ireland, Belgium, San Marino, Andorra, Italy, United Kingdom, Portugal, Netherlands, Luxembourg, Virgin Islands U.S., Puerto Rico, United States of America and Canada. For these countries, if the user specifies a value more than 25 in the 'CandidateMaximumQuantity' field of the request, CandidateMaximumQuantity will be considered as 25. Maximum of 100 candidates will be returned for all other countries. For these countries, if the user specifies a value more than 100 in the 'CandidateMaximumQuantity' field of the request, CandidateMaximumQuantity will be considered as 100.
DataAreaResponse​.OrderResponse​.Candidates CandidatesType
DataAreaResponse​.OrderResponse​.Candidates​.Candidate CandidateType
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.DUNS string (1-9 characters) 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]*)".
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.ConfidenceCode integer (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.
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.BestMatchFlag string (1-5 characters) If there are more than one candidate matched at a high confidence level such as a 10 and a differentiator is needed, this flag indicates the best possible match.
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.MatchGradeString string (1-11 characters) A MatchGrade provides a similarity score between components of customer and D&B reference info
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.PrimaryBusinessName string (1-240 characters) Primary Company Business Name
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.PhysicalAddressLine string (1-70 characters) Physical street address where the business is located
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.PhysicalCity string (1-50 characters) City where the business is located
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.PhysicalState string (1-2 characters) The state abbreviation where the company is located
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.PhysicalPostalCode string (1-10 characters) The zip code where the company is located
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.CountryCode string (1-2 characters) Dial these numbers to access the phone number in the designated country. For example, for Mitsubishi's primary phone number in Japan "81" is listed. For a New Zealand-based company "61" is listed.
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.CountryName string (1-30 characters) Name of the country where the business is located
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.Phone string (1-16 characters) Telephone Number
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.TradeStyle string (1-90 characters) Doing Business As or Trade Style Name
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.SubjectDetails string SingleLocation, ParentHeadquarters, or BranchDivision
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.MatchBasis MatchBasisType
DataAreaResponse​.OrderResponse​.Candidates​.Candidate​.MDPProfile string (1-28 characters) A series of 7 or 11 2-digit codes used to define the source of the matched record ? the kind of data to which the record was matched, within the D&B Match Reference File. Match Data Profiles are codes that appear on the output file and matching reports returned. They show the information D&B was able to match such as the type of name, address or phone that was matched. Or if no match occurred, D&B shows why we were unable to match.

Sample Request XML



      

Sample Response XML



      

CURL Example

curl -d '' -H "SOAPAction: sch:FindCompanyCleanseMatch" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

FindCompetitorsByCompanyID Included in Base Package

Returns all the competitors for a given company."

Request

Element Type Notes
uniqueId long Required Company ID or D-U-N-S Number
topCompetitor boolean Top competitor indicator

Response

Element Type Notes
return CompetitorSearchResult
return​.competitor Array of CompetitorSearchResultHit
return​.competitor[]​.addrcity string (up to 50 characters) Competitor City
return​.competitor[]​.addrcountry string (up to 70 characters) Competitor Country
return​.competitor[]​.addrcountryid unsignedLong Competitor Country ID. Example: 76 = United States
return​.competitor[]​.addrstateprov string (up to 2 characters) Competitor search result hit for State/Province
return​.competitor[]​.companyId long Company ID - Most likely this will be a DUNS number. However, there are Hoover's editorial ID's as another unique company ID (Example: 10483000000000). These company ID's may or may not have a corresponding DUNS number.
return​.competitor[]​.duns string 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]*)".
return​.competitor[]​.parentDuns string
return​.competitor[]​.ultimateParentDuns string The ultimate parent company D-U-N-S Number for a family of companies
return​.competitor[]​.finsales decimal Annual sales based on the fiscal year and expressed in millions of US dollars.
return​.competitor[]​.companyName string Company Name
return​.competitor[]​.topcompetitor boolean Top competitor indicator

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:FindCompetitorsByCompanyIDRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:FindCompetitorsByCompanyIDRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:FindCompetitorsByCompanyIDResponse>
         <sch:return>
            <sch:competitor>
               <sch:addrcity>Puteaux</sch:addrcity>
               <sch:addrcountry>France</sch:addrcountry>
               <sch:addrcountryid>27</sch:addrcountryid>
               <sch:addrstateprov/>
               <sch:companyId>101016000000000</sch:companyId>
               <sch:duns>275253524</sch:duns>
               <sch:parentDuns>395709947</sch:parentDuns>
               <sch:ultimateParentDuns>291588544</sch:ultimateParentDuns>
               <sch:finsales>935.8944216623998</sch:finsales>
               <sch:companyName>Coface SA</sch:companyName>
               <sch:topcompetitor>false</sch:topcompetitor>
            </sch:competitor>
            <sch:competitor>
               <sch:addrcity>Dublin </sch:addrcity>
               <sch:addrcountry>Ireland</sch:addrcountry>
               <sch:addrcountryid>39</sch:addrcountryid>
               <sch:addrstateprov/>
               <sch:companyId>154281000000000</sch:companyId>
               <sch:duns>896612129</sch:duns>
               <sch:parentDuns>365214688</sch:parentDuns>
               <sch:ultimateParentDuns>365214688</sch:ultimateParentDuns>
               <sch:finsales>4473.2391244</sch:finsales>
               <sch:companyName>Experian plc</sch:companyName>
               <sch:topcompetitor>false</sch:topcompetitor>
            </sch:competitor>
            ...
            </sch:return>
      </sch:FindCompetitorsByCompanyIDResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:FindCompetitorsByCompanyIDRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:FindCompetitorsByCompanyIDRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:FindCompetitorsByCompanyID" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

GetCompanyComparisonData Available in Add-on: Advanced Financial Information

This call returns financial comparison data for a given company."

Request

Element Type Notes
uniqueId long Required Company ID or D-U-N-S Number

Response

Element Type Notes
return GetCompanyComparisonDataResponseWrapper
return​.profitabilityComparison ProfitabilityComparisons
return​.profitabilityComparison​.company ProfitabilityComparison
return​.profitabilityComparison​.company​.pctGrossProfitMargin decimal Gross profit margin. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.profitabilityComparison​.company​.pctPreTaxProfitMargin decimal Pre-tax profit margin. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.profitabilityComparison​.company​.pctNetProfitMargin decimal Net profit margin. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.profitabilityComparison​.company​.pctReturnOnEquity decimal
return​.profitabilityComparison​.company​.pctReturnOnAssets decimal
return​.profitabilityComparison​.company​.pctReturnOnInvestedCapital decimal Return on invested capital
return​.profitabilityComparison​.industryMedian ProfitabilityComparison
return​.profitabilityComparison​.industryMedian​.pctGrossProfitMargin decimal Gross profit margin. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.profitabilityComparison​.industryMedian​.pctPreTaxProfitMargin decimal Pre-tax profit margin. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.profitabilityComparison​.industryMedian​.pctNetProfitMargin decimal Net profit margin. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.profitabilityComparison​.industryMedian​.pctReturnOnEquity decimal
return​.profitabilityComparison​.industryMedian​.pctReturnOnAssets decimal
return​.profitabilityComparison​.industryMedian​.pctReturnOnInvestedCapital decimal Return on invested capital
return​.profitabilityComparison​.marketMedian ProfitabilityComparison
return​.profitabilityComparison​.marketMedian​.pctGrossProfitMargin decimal Gross profit margin. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.profitabilityComparison​.marketMedian​.pctPreTaxProfitMargin decimal Pre-tax profit margin. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.profitabilityComparison​.marketMedian​.pctNetProfitMargin decimal Net profit margin. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.profitabilityComparison​.marketMedian​.pctReturnOnEquity decimal
return​.profitabilityComparison​.marketMedian​.pctReturnOnAssets decimal
return​.profitabilityComparison​.marketMedian​.pctReturnOnInvestedCapital decimal Return on invested capital
return​.valuationComparison ValuationComparisons
return​.valuationComparison​.company ValuationComparison
return​.valuationComparison​.company​.priceSalesRatio decimal Price to sales ratio
return​.valuationComparison​.company​.priceEarningsRatio decimal Price to earnings ratio
return​.valuationComparison​.company​.priceBookRatio decimal Price to book ratio
return​.valuationComparison​.company​.priceCashFlowRatio decimal Price to cash flow ratio
return​.valuationComparison​.industryMedian ValuationComparison
return​.valuationComparison​.industryMedian​.priceSalesRatio decimal Price to sales ratio
return​.valuationComparison​.industryMedian​.priceEarningsRatio decimal Price to earnings ratio
return​.valuationComparison​.industryMedian​.priceBookRatio decimal Price to book ratio
return​.valuationComparison​.industryMedian​.priceCashFlowRatio decimal Price to cash flow ratio
return​.valuationComparison​.marketMedian ValuationComparison
return​.valuationComparison​.marketMedian​.priceSalesRatio decimal Price to sales ratio
return​.valuationComparison​.marketMedian​.priceEarningsRatio decimal Price to earnings ratio
return​.valuationComparison​.marketMedian​.priceBookRatio decimal Price to book ratio
return​.valuationComparison​.marketMedian​.priceCashFlowRatio decimal Price to cash flow ratio
return​.operationsComparison OperationsComparisons
return​.operationsComparison​.company OperationsComparison
return​.operationsComparison​.company​.daysOfSalesOutstanding decimal Days of sales outstanding
return​.operationsComparison​.company​.inventoryTurnover decimal Inventory turnover is the cost of goods sold divided by the avergy inventory from the most recent balance sheet and the corresponding balance sheet one year prior. The inventory turnover measures the efficiency of inventory management.
return​.operationsComparison​.company​.daysCostOfGoodsSoldInInventory decimal Days cost of goods sold in inventory
return​.operationsComparison​.company​.assetTurnover decimal Asset turnover relating to operations comparisons
return​.operationsComparison​.company​.netReceivablesTurnoverFlow decimal Net receivables turnover flow
return​.operationsComparison​.company​.pctEffectiveTaxRate decimal Effective tax rate
return​.operationsComparison​.industryMedian OperationsComparison
return​.operationsComparison​.industryMedian​.daysOfSalesOutstanding decimal Days of sales outstanding
return​.operationsComparison​.industryMedian​.inventoryTurnover decimal Inventory turnover is the cost of goods sold divided by the avergy inventory from the most recent balance sheet and the corresponding balance sheet one year prior. The inventory turnover measures the efficiency of inventory management.
return​.operationsComparison​.industryMedian​.daysCostOfGoodsSoldInInventory decimal Days cost of goods sold in inventory
return​.operationsComparison​.industryMedian​.assetTurnover decimal Asset turnover relating to operations comparisons
return​.operationsComparison​.industryMedian​.netReceivablesTurnoverFlow decimal Net receivables turnover flow
return​.operationsComparison​.industryMedian​.pctEffectiveTaxRate decimal Effective tax rate
return​.operationsComparison​.marketMedian OperationsComparison
return​.operationsComparison​.marketMedian​.daysOfSalesOutstanding decimal Days of sales outstanding
return​.operationsComparison​.marketMedian​.inventoryTurnover decimal Inventory turnover is the cost of goods sold divided by the avergy inventory from the most recent balance sheet and the corresponding balance sheet one year prior. The inventory turnover measures the efficiency of inventory management.
return​.operationsComparison​.marketMedian​.daysCostOfGoodsSoldInInventory decimal Days cost of goods sold in inventory
return​.operationsComparison​.marketMedian​.assetTurnover decimal Asset turnover relating to operations comparisons
return​.operationsComparison​.marketMedian​.netReceivablesTurnoverFlow decimal Net receivables turnover flow
return​.operationsComparison​.marketMedian​.pctEffectiveTaxRate decimal Effective tax rate
return​.financialComparison FinancialComparisons
return​.financialComparison​.company FinancialComparison
return​.financialComparison​.company​.currentRatio decimal Current Ratio
return​.financialComparison​.company​.quickRatio decimal Quick Ratio
return​.financialComparison​.company​.leverageRatio decimal Leverage ratio: This ratio measures a company's arrangement of operating costs (fixed and variable costs) to provide a framework around how output changes will affect operating income. The most well known leverage ratio is the debt-to-equity ratio, for example.
return​.financialComparison​.company​.totalDebtToEquity decimal Total Debt/Equity
return​.financialComparison​.company​.interestCoverage decimal Interest Coverage
return​.financialComparison​.industryMedian FinancialComparison
return​.financialComparison​.industryMedian​.currentRatio decimal Current Ratio
return​.financialComparison​.industryMedian​.quickRatio decimal Quick Ratio
return​.financialComparison​.industryMedian​.leverageRatio decimal Leverage ratio: This ratio measures a company's arrangement of operating costs (fixed and variable costs) to provide a framework around how output changes will affect operating income. The most well known leverage ratio is the debt-to-equity ratio, for example.
return​.financialComparison​.industryMedian​.totalDebtToEquity decimal Total Debt/Equity
return​.financialComparison​.industryMedian​.interestCoverage decimal Interest Coverage
return​.financialComparison​.marketMedian FinancialComparison
return​.financialComparison​.marketMedian​.currentRatio decimal Current Ratio
return​.financialComparison​.marketMedian​.quickRatio decimal Quick Ratio
return​.financialComparison​.marketMedian​.leverageRatio decimal Leverage ratio: This ratio measures a company's arrangement of operating costs (fixed and variable costs) to provide a framework around how output changes will affect operating income. The most well known leverage ratio is the debt-to-equity ratio, for example.
return​.financialComparison​.marketMedian​.totalDebtToEquity decimal Total Debt/Equity
return​.financialComparison​.marketMedian​.interestCoverage decimal Interest Coverage
return​.perShareDataComparison PerShareDataComparisons
return​.perShareDataComparison​.company PerShareDataComparison
return​.perShareDataComparison​.company​.revenuePerShare decimal Revenue per share
return​.perShareDataComparison​.company​.dividendsPerShare decimal Dividends per share
return​.perShareDataComparison​.company​.cashFlowPerShare decimal Cash flow per share such as in the context of PerShareDataComparison
return​.perShareDataComparison​.company​.workingCapitalPerShare decimal Working capital per share
return​.perShareDataComparison​.company​.longTermDebtPerShare decimal Long term debt per share
return​.perShareDataComparison​.company​.bookValuePerShare decimal Book value per share
return​.perShareDataComparison​.company​.totalAssetsPerShare decimal Total assets per share
return​.perShareDataComparison​.industryMedian PerShareDataComparison
return​.perShareDataComparison​.industryMedian​.revenuePerShare decimal Revenue per share
return​.perShareDataComparison​.industryMedian​.dividendsPerShare decimal Dividends per share
return​.perShareDataComparison​.industryMedian​.cashFlowPerShare decimal Cash flow per share such as in the context of PerShareDataComparison
return​.perShareDataComparison​.industryMedian​.workingCapitalPerShare decimal Working capital per share
return​.perShareDataComparison​.industryMedian​.longTermDebtPerShare decimal Long term debt per share
return​.perShareDataComparison​.industryMedian​.bookValuePerShare decimal Book value per share
return​.perShareDataComparison​.industryMedian​.totalAssetsPerShare decimal Total assets per share
return​.perShareDataComparison​.marketMedian PerShareDataComparison
return​.perShareDataComparison​.marketMedian​.revenuePerShare decimal Revenue per share
return​.perShareDataComparison​.marketMedian​.dividendsPerShare decimal Dividends per share
return​.perShareDataComparison​.marketMedian​.cashFlowPerShare decimal Cash flow per share such as in the context of PerShareDataComparison
return​.perShareDataComparison​.marketMedian​.workingCapitalPerShare decimal Working capital per share
return​.perShareDataComparison​.marketMedian​.longTermDebtPerShare decimal Long term debt per share
return​.perShareDataComparison​.marketMedian​.bookValuePerShare decimal Book value per share
return​.perShareDataComparison​.marketMedian​.totalAssetsPerShare decimal Total assets per share
return​.growthComparison GrowthComparisons
return​.growthComparison​.company GrowthComparison
return​.growthComparison​.company​.pctTwelveMonthRevenueGrowth decimal 12-Month Revenue Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.company​.pctTwelveMonthNetIncomeGrowth decimal 12-Month Net Income Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.company​.pctTwelveMonthEpsGrowth decimal 12-Month EPS Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.company​.pctTwelveMonthDividendGrowth decimal 12-Month Dividend Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.company​.pctThirtySixMonthRevenueGrowth decimal 36-Month Revenue Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.company​.pctThirtySixMonthNetIncomeGrowth decimal 36-Month Net Income Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.company​.pctThirtySixMonthEpsGrowth decimal 36-Month EPS Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.company​.pctThirtySixMonthDividendGrowth decimal 36-Month Dividend Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.industryMedian GrowthComparison
return​.growthComparison​.industryMedian​.pctTwelveMonthRevenueGrowth decimal 12-Month Revenue Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.industryMedian​.pctTwelveMonthNetIncomeGrowth decimal 12-Month Net Income Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.industryMedian​.pctTwelveMonthEpsGrowth decimal 12-Month EPS Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.industryMedian​.pctTwelveMonthDividendGrowth decimal 12-Month Dividend Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.industryMedian​.pctThirtySixMonthRevenueGrowth decimal 36-Month Revenue Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.industryMedian​.pctThirtySixMonthNetIncomeGrowth decimal 36-Month Net Income Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.industryMedian​.pctThirtySixMonthEpsGrowth decimal 36-Month EPS Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.industryMedian​.pctThirtySixMonthDividendGrowth decimal 36-Month Dividend Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.marketMedian GrowthComparison
return​.growthComparison​.marketMedian​.pctTwelveMonthRevenueGrowth decimal 12-Month Revenue Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.marketMedian​.pctTwelveMonthNetIncomeGrowth decimal 12-Month Net Income Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.marketMedian​.pctTwelveMonthEpsGrowth decimal 12-Month EPS Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.marketMedian​.pctTwelveMonthDividendGrowth decimal 12-Month Dividend Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.marketMedian​.pctThirtySixMonthRevenueGrowth decimal 36-Month Revenue Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.marketMedian​.pctThirtySixMonthNetIncomeGrowth decimal 36-Month Net Income Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.marketMedian​.pctThirtySixMonthEpsGrowth decimal 36-Month EPS Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthComparison​.marketMedian​.pctThirtySixMonthDividendGrowth decimal 36-Month Dividend Growth. Expressed as a whole number. To express 50%, for example, enter the input as '50'.

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyComparisonDataRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyComparisonDataRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:GetCompanyComparisonDataResponse>
         <sch:return>
            <sch:profitabilityComparison>
               <sch:company>
                  <sch:pctGrossProfitMargin>66.54</sch:pctGrossProfitMargin>
                  <sch:pctPreTaxProfitMargin>21.48</sch:pctPreTaxProfitMargin>
                  <sch:pctNetProfitMargin>15.76</sch:pctNetProfitMargin>
                  <sch:pctReturnOnEquity xsi:nil="true"/>
                  <sch:pctReturnOnAssets>15.26</sch:pctReturnOnAssets>
                  <sch:pctReturnOnInvestedCapital xsi:nil="true"/>
               </sch:company>
               <sch:industryMedian>
                  <sch:pctGrossProfitMargin>37.99</sch:pctGrossProfitMargin>
                  <sch:pctPreTaxProfitMargin>7.92</sch:pctPreTaxProfitMargin>
                  <sch:pctNetProfitMargin>4.39</sch:pctNetProfitMargin>
                  <sch:pctReturnOnEquity>8.17</sch:pctReturnOnEquity>
                  <sch:pctReturnOnAssets>2.89</sch:pctReturnOnAssets>
                  <sch:pctReturnOnInvestedCapital>4.89</sch:pctReturnOnInvestedCapital>
               </sch:industryMedian>
               <sch:marketMedian>
                  <sch:pctGrossProfitMargin>34.46</sch:pctGrossProfitMargin>
                  <sch:pctPreTaxProfitMargin>10.44</sch:pctPreTaxProfitMargin>
                  <sch:pctNetProfitMargin>6.96</sch:pctNetProfitMargin>
                  <sch:pctReturnOnEquity>11.56</sch:pctReturnOnEquity>
                  <sch:pctReturnOnAssets>2.04</sch:pctReturnOnAssets>
                  <sch:pctReturnOnInvestedCapital>5.89</sch:pctReturnOnInvestedCapital>
               </sch:marketMedian>
            </sch:profitabilityComparison>
            <sch:valuationComparison>
               <sch:company>
                  <sch:priceSalesRatio>2.32</sch:priceSalesRatio>
                  <sch:priceEarningsRatio>14.71</sch:priceEarningsRatio>
                  <sch:priceBookRatio>-4.51</sch:priceBookRatio>
                  <sch:priceCashFlowRatio>11.68</sch:priceCashFlowRatio>
               </sch:company>
               <sch:industryMedian>
                  <sch:priceSalesRatio>1.55</sch:priceSalesRatio>
                  <sch:priceEarningsRatio>35.34</sch:priceEarningsRatio>
                  <sch:priceBookRatio>2.89</sch:priceBookRatio>
                  <sch:priceCashFlowRatio>11.27</sch:priceCashFlowRatio>
               </sch:industryMedian>
               <sch:marketMedian>
                  <sch:priceSalesRatio>1.21</sch:priceSalesRatio>
                  <sch:priceEarningsRatio>17.30</sch:priceEarningsRatio>
                  <sch:priceBookRatio>1.96</sch:priceBookRatio>
                  <sch:priceCashFlowRatio>7.96</sch:priceCashFlowRatio>
               </sch:marketMedian>
            </sch:valuationComparison>
            <sch:operationsComparison>
               <sch:company>
                  <sch:daysOfSalesOutstanding>80.11</sch:daysOfSalesOutstanding>
                  <sch:inventoryTurnover xsi:nil="true"/>
                  <sch:daysCostOfGoodsSoldInInventory xsi:nil="true"/>
                  <sch:assetTurnover>0.97</sch:assetTurnover>
                  <sch:netReceivablesTurnoverFlow>4.56</sch:netReceivablesTurnoverFlow>
                  <sch:pctEffectiveTaxRate>26.46</sch:pctEffectiveTaxRate>
               </sch:company>
               <sch:industryMedian>
                  <sch:daysOfSalesOutstanding>57.06</sch:daysOfSalesOutstanding>
                  <sch:inventoryTurnover>13.41</sch:inventoryTurnover>
                  <sch:daysCostOfGoodsSoldInInventory>27.22</sch:daysCostOfGoodsSoldInInventory>
                  <sch:assetTurnover>0.66</sch:assetTurnover>
                  <sch:netReceivablesTurnoverFlow>6.40</sch:netReceivablesTurnoverFlow>
                  <sch:pctEffectiveTaxRate>40.90</sch:pctEffectiveTaxRate>
               </sch:industryMedian>
               <sch:marketMedian>
                  <sch:daysOfSalesOutstanding>43.05</sch:daysOfSalesOutstanding>
                  <sch:inventoryTurnover>7.43</sch:inventoryTurnover>
                  <sch:daysCostOfGoodsSoldInInventory>49.14</sch:daysCostOfGoodsSoldInInventory>
                  <sch:assetTurnover>0.29</sch:assetTurnover>
                  <sch:netReceivablesTurnoverFlow>8.48</sch:netReceivablesTurnoverFlow>
                  <sch:pctEffectiveTaxRate>28.32</sch:pctEffectiveTaxRate>
               </sch:marketMedian>
            </sch:operationsComparison>
            <sch:financialComparison>
               <sch:company>
                  <sch:currentRatio>0.76</sch:currentRatio>
                  <sch:quickRatio>0.63</sch:quickRatio>
                  <sch:leverageRatio xsi:nil="true"/>
                  <sch:totalDebtToEquity xsi:nil="true"/>
                  <sch:interestCoverage>11.01</sch:interestCoverage>
               </sch:company>
               <sch:industryMedian>
                  <sch:currentRatio>1.37</sch:currentRatio>
                  <sch:quickRatio>4.52</sch:quickRatio>
                  <sch:leverageRatio>2.81</sch:leverageRatio>
                  <sch:totalDebtToEquity>0.67</sch:totalDebtToEquity>
                  <sch:interestCoverage>4.12</sch:interestCoverage>
               </sch:industryMedian>
               <sch:marketMedian>
                  <sch:currentRatio>1.40</sch:currentRatio>
                  <sch:quickRatio>4.99</sch:quickRatio>
                  <sch:leverageRatio>5.80</sch:leverageRatio>
                  <sch:totalDebtToEquity>0.97</sch:totalDebtToEquity>
                  <sch:interestCoverage>6.38</sch:interestCoverage>
               </sch:marketMedian>
            </sch:financialComparison>
            <sch:perShareDataComparison>
               <sch:company>
                  <sch:revenuePerShare>35.78</sch:revenuePerShare>
                  <sch:dividendsPerShare>1.48</sch:dividendsPerShare>
                  <sch:cashFlowPerShare>7.10</sch:cashFlowPerShare>
                  <sch:workingCapitalPerShare>-5.05</sch:workingCapitalPerShare>
                  <sch:longTermDebtPerShare>21.48</sch:longTermDebtPerShare>
                  <sch:bookValuePerShare>-18.40</sch:bookValuePerShare>
                  <sch:totalAssetsPerShare>44.05</sch:totalAssetsPerShare>
               </sch:company>
               <sch:industryMedian>
                  <sch:revenuePerShare xsi:nil="true"/>
                  <sch:dividendsPerShare xsi:nil="true"/>
                  <sch:cashFlowPerShare xsi:nil="true"/>
                  <sch:workingCapitalPerShare>2.41</sch:workingCapitalPerShare>
                  <sch:longTermDebtPerShare>6.09</sch:longTermDebtPerShare>
                  <sch:bookValuePerShare xsi:nil="true"/>
                  <sch:totalAssetsPerShare>25.76</sch:totalAssetsPerShare>
               </sch:industryMedian>
               <sch:marketMedian>
                  <sch:revenuePerShare xsi:nil="true"/>
                  <sch:dividendsPerShare xsi:nil="true"/>
                  <sch:cashFlowPerShare xsi:nil="true"/>
                  <sch:workingCapitalPerShare>2.53</sch:workingCapitalPerShare>
                  <sch:longTermDebtPerShare>0.08</sch:longTermDebtPerShare>
                  <sch:bookValuePerShare xsi:nil="true"/>
                  <sch:totalAssetsPerShare>88.87</sch:totalAssetsPerShare>
               </sch:marketMedian>
            </sch:perShareDataComparison>
            <sch:growthComparison>
               <sch:company>
                  <sch:pctTwelveMonthRevenueGrowth>4.88</sch:pctTwelveMonthRevenueGrowth>
                  <sch:pctTwelveMonthNetIncomeGrowth>3.25</sch:pctTwelveMonthNetIncomeGrowth>
                  <sch:pctTwelveMonthEpsGrowth>6.02</sch:pctTwelveMonthEpsGrowth>
                  <sch:pctTwelveMonthDividendGrowth>2.86</sch:pctTwelveMonthDividendGrowth>
                  <sch:pctThirtySixMonthRevenueGrowth>0.62</sch:pctThirtySixMonthRevenueGrowth>
                  <sch:pctThirtySixMonthNetIncomeGrowth>-5.72</sch:pctThirtySixMonthNetIncomeGrowth>
                  <sch:pctThirtySixMonthEpsGrowth>-1.83</sch:pctThirtySixMonthEpsGrowth>
                  <sch:pctThirtySixMonthDividendGrowth>6.27</sch:pctThirtySixMonthDividendGrowth>
               </sch:company>
               <sch:industryMedian>
                  <sch:pctTwelveMonthRevenueGrowth>3.47</sch:pctTwelveMonthRevenueGrowth>
                  <sch:pctTwelveMonthNetIncomeGrowth>-24.68</sch:pctTwelveMonthNetIncomeGrowth>
                  <sch:pctTwelveMonthEpsGrowth xsi:nil="true"/>
                  <sch:pctTwelveMonthDividendGrowth xsi:nil="true"/>
                  <sch:pctThirtySixMonthRevenueGrowth>9.12</sch:pctThirtySixMonthRevenueGrowth>
                  <sch:pctThirtySixMonthNetIncomeGrowth>3.52</sch:pctThirtySixMonthNetIncomeGrowth>
                  <sch:pctThirtySixMonthEpsGrowth xsi:nil="true"/>
                  <sch:pctThirtySixMonthDividendGrowth xsi:nil="true"/>
               </sch:industryMedian>
               <sch:marketMedian>
                  <sch:pctTwelveMonthRevenueGrowth>-1.31</sch:pctTwelveMonthRevenueGrowth>
                  <sch:pctTwelveMonthNetIncomeGrowth>-10.52</sch:pctTwelveMonthNetIncomeGrowth>
                  <sch:pctTwelveMonthEpsGrowth xsi:nil="true"/>
                  <sch:pctTwelveMonthDividendGrowth xsi:nil="true"/>
                  <sch:pctThirtySixMonthRevenueGrowth>7.76</sch:pctThirtySixMonthRevenueGrowth>
                  <sch:pctThirtySixMonthNetIncomeGrowth>65.84</sch:pctThirtySixMonthNetIncomeGrowth>
                  <sch:pctThirtySixMonthEpsGrowth xsi:nil="true"/>
                  <sch:pctThirtySixMonthDividendGrowth xsi:nil="true"/>
               </sch:marketMedian>
            </sch:growthComparison>
         </sch:return>
      </sch:GetCompanyComparisonDataResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyComparisonDataRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyComparisonDataRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:GetCompanyComparisonData" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

GetCompanyDetail Available in Add-on: Full Company Profile

Returns detailed company information for a single company."

Request

Element Type Notes
uniqueId long Required Company ID or D-U-N-S Number

Response

Element Type Notes
return GetCompanyFullWrapper
return​.companyId long Company ID - Most likely this will be a DUNS number. However, there are Hoover's editorial ID's as another unique company ID (Example: 10483000000000). These company ID's may or may not have a corresponding DUNS number.
return​.duns string 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]*)".
return​.companyType string 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.
return​.locationType string Company Location Type such as Single Location (0), Headquarters (1), Branch (2), Branch/Division (4), Subsidiary (5)
return​.ultimateParentDuns string The ultimate parent company D-U-N-S Number for a family of companies
return​.ultimateParentName string The ultimate parent company name corresponding to the ultimate parent DUNS Number
return​.parentDuns string
return​.parentName string The company name of the company's immediate parent company.
return​.name string Company Name
return​.nonMarketableCompany NonMarketableReasons Non-marketable company reason such as 'Invalid address', 'Out of business', 'Key data missing/needing revision', 'Requested no marketing contact'
return​.nonMarketableCompany​.reason Array of string Reason for non-marketable status; Non-marketable company reasons: 'Invalid address', 'Out of business', 'Key data missing/needing revision', 'Requested no marketing contact' Available Values:
Invalid address
Out of business
Key data missing/needing revision
Requested no marketing contact
return​.dbaNames DBANames
return​.dbaNames​.dba Array of string Doing Business As or Trade Style Name
return​.industries Industries
return​.industries​.lineOfBusiness string Primary line of business which could based on USSIC, UKSIC, etc.
return​.industries​.primaryDnBIC string 4 digit D&B Industry Code. DNBIC Code: Replaces dnbicName (DNBIC Name)
return​.industries​.primaryNAICS string NAICS Code. Primary NAICS Code. Individual 2-digit to 6-digit codes and code ranges are allowed. To get a broad range of companies within an industry sector, use 2-digit codes. To get more specific results for a line of business, use 6-digit codes
return​.industries​.primaryUSSIC string Primary US SIC Code. "SIC" (Standard Industrial Classification) is an industry code system developed by the US Government. 2 to 8 digit SIC codes are supported.
return​.industries​.primaryUKSIC string Primary UK SIC Code. United Kingdom Standard Industrial Classification of Economic Activities.
return​.industries​.allUKSIC AllUKSIC
return​.industries​.allUKSIC​.item Array of AllUKSICItem
return​.industries​.allUKSIC​.item[]​.uksic 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.
return​.industries​.allUKSIC​.item[]​.description string
return​.industries​.allUSSIC AllUSSIC
return​.industries​.allUSSIC​.item Array of AllUSSICItem
return​.industries​.allUSSIC​.item[]​.ussic string US SIC Code: "SIC" (Standard Industrial Classification) is an industry code system developed by the US Government.
return​.industries​.allUSSIC​.item[]​.description string
return​.industries​.allNAICS AllNAICS
return​.industries​.allNAICS​.item Array of AllNAICSItem
return​.industries​.allNAICS​.item[]​.naics 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.
return​.industries​.allNAICS​.item[]​.description string
return​.industries​.allDnBIC AllDnBIC
return​.industries​.allDnBIC​.item Array of AllDnBICItem
return​.industries​.allDnBIC​.item[]​.dnbic string D&B Industry Code
return​.industries​.allDnBIC​.item[]​.description string
return​.subsidiaryStatus boolean 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).
return​.keyNumbersHistory KeyNumbersHistory
return​.keyNumbersHistory​.annualKeyNumbersHistory TimePeriodKeyNumbers
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers Array of KeyNumbers
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.sales decimal Annual Sales in millions
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.employeesAtThisLocation integer The number of employees at this location. The total number of individuals engaged by a business entity at the location of the DUNS numbered subject entity.
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.totalEmployeeGrowthPercent decimal Total Employee Growth % for the Year
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.employeesTotal integer Total number of employees. The total number of people employed by all branches and subsidiaries of a business.
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.researchAndDevelopment decimal R&D expenses for the year. This value is in US dollars.
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.advertising decimal Advertising expenses for the year expressed in millions of US dollars.
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.fiscal-period string Fiscal reporting period as a key number. Please note that not all financial fiscal year ranges begin in January. Example: FY2010
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.periodEndMonth string Period End Month. Abbreviated Month and full year. Example: Jan 2012
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory TimePeriodKeyNumbers
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers Array of KeyNumbers
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.sales decimal Annual Sales in millions
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.employeesAtThisLocation integer The number of employees at this location. The total number of individuals engaged by a business entity at the location of the DUNS numbered subject entity.
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.totalEmployeeGrowthPercent decimal Total Employee Growth % for the Year
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.employeesTotal integer Total number of employees. The total number of people employed by all branches and subsidiaries of a business.
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.researchAndDevelopment decimal R&D expenses for the year. This value is in US dollars.
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.advertising decimal Advertising expenses for the year expressed in millions of US dollars.
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.fiscal-period string Fiscal reporting period as a key number. Please note that not all financial fiscal year ranges begin in January. Example: FY2010
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.periodEndMonth string Period End Month. Abbreviated Month and full year. Example: Jan 2012
return​.locations Locations
return​.locations​.location Array of Location Type of location for the company; headquarters, branch office, etc.
return​.locations​.location[]​.address1 string (up to 150 characters) Company address line 1
return​.locations​.location[]​.address2 string (up to 70 characters) Company address line 2
return​.locations​.location[]​.city string City
return​.locations​.location[]​.county string Company County
return​.locations​.location[]​.state string (1-30 characters) State
return​.locations​.location[]​.stateOfIncorporation string Company State of Incorporation
return​.locations​.location[]​.country string Country
return​.locations​.location[]​.countryId integer Country ID - D&B-assigned code which identifies the country where the business is located.
return​.locations​.location[]​.zip string Postal/ZIP code
return​.locations​.location[]​.zip4 string ZIP Plus 4 code
return​.locations​.location[]​.latitude decimal
return​.locations​.location[]​.longitude decimal Longitude component of geo location
return​.locations​.location[]​.latLongAccuracy string
return​.locations​.location[]​.addressType string (up to 70 characters) Type of address such as Primary Address, Headquarters, or Mailing
return​.locations​.location[]​.metroArea string The metropolitan area for the location
return​.ownershipYear string Ownership year
return​.phones PhoneNumbers
return​.phones​.faxNumber Array of PhoneNumber
return​.phones​.faxNumber[]​.countryCode string (1-2 characters) Dial these numbers to access the phone number in the designated country. For example, for Mitsubishi's primary phone number in Japan "81" is listed. For a New Zealand-based company "61" is listed.
return​.phones​.faxNumber[]​.areaCode string US or Canadian Phone Number Area Code
return​.phones​.faxNumber[]​.phoneNumber string Phone Number
return​.phones​.faxNumber[]​.doNotCallRegistry boolean Indicates whether company is listed on a UK Do Not Call registry
return​.phones​.phoneNumber Array of PhoneNumber Phone Number
return​.phones​.phoneNumber[]​.countryCode string (1-2 characters) Dial these numbers to access the phone number in the designated country. For example, for Mitsubishi's primary phone number in Japan "81" is listed. For a New Zealand-based company "61" is listed.
return​.phones​.phoneNumber[]​.areaCode string US or Canadian Phone Number Area Code
return​.phones​.phoneNumber[]​.phoneNumber string Phone Number
return​.phones​.phoneNumber[]​.doNotCallRegistry boolean Indicates whether company is listed on a UK Do Not Call registry
return​.synopsis string Company Description with html tags
return​.full-description string Full company description
return​.historicalIndicator boolean Indicates that the company has ceased operations and is no longer covered by editors.
return​.historicalText string Brief description why company is defunct
return​.stocks Stocks
return​.stocks​.tickerUS string The stock ticker symbol for a company which is used to identify listed companies on the securities exchanges on which they trade.
return​.stocks​.exchangeInfoList ExchangeInfoList
return​.stocks​.exchangeInfoList​.exchangeInfo Array of ExchangeInfo
return​.stocks​.exchangeInfoList​.exchangeInfo[]​.country string Country
return​.stocks​.exchangeInfoList​.exchangeInfo[]​.tickerSymbol string The stock ticker symbol for a company used to identify listed companies on the securities exchanges on which they trade.
return​.stocks​.exchangeInfoList​.exchangeInfo[]​.exchangeName string Name of the exchange where this company is traded.
return​.top-executives CompanyTopExecutives
return​.top-executives​.official Array of TopExecutive Max array length: 3
return​.top-executives​.official[]​.coOfficialId long Company's official ID that is 7 - 16 digits long. This element differs from the unique company ID (which is the DUNS number or company ID).
return​.top-executives​.official[]​.latest-position OfficialLatestPosition
return​.top-executives​.official[]​.latest-position​.title string
return​.top-executives​.official[]​.latest-position​.jobFunction Records a person's job functions. For example, in a person's latest position, he or she was "President, CEO, and Director" so the ID's contained in this element correspond to these functions.
return​.top-executives​.official[]​.latest-position​.jobFunction​.jobFunctionId Array of integer Identifies a job function that may be independent of job title. Management Responsibility Code (MRC) identifies the title of the principal or manager for the subject.
return​.top-executives​.official[]​.latest-position​.start-year string Latest position start year
return​.top-executives​.official[]​.latest-position​.end-year string Latest position end year
return​.top-executives​.official[]​.latest-salary OfficialLatestSalary
return​.top-executives​.official[]​.latest-salary​.year unsignedLong
return​.top-executives​.official[]​.latest-salary​.salary decimal Salary for the year excluding bonus
return​.top-executives​.official[]​.latest-salary​.total-salary decimal Total compensation for the year, including any bonus or other compensation in USD
return​.top-executives​.official[]​.latest-salary​.bonus decimal Bonus for the fiscal year (not the actual year) expressed in millions of local currency which can include US dollars and can be converted to USD, Euros, British Pounds, Canadian Dollars, Japanese Yen, or Swedish Kronor for use in our products. Prerequisites: The company has to be covered by Hoover's, and it has to file documents with the SEC, and the officer has to be one of the five highest-compensated people at the company.
return​.top-executives​.official[]​.person Person
return​.top-executives​.official[]​.person​.age long (up to 4 characters) Person Age
return​.top-executives​.official[]​.person​.first-name string Person First Name
return​.top-executives​.official[]​.person​.full-name string Person Full Name
return​.top-executives​.official[]​.person​.last-name string Person Last Name
return​.top-executives​.official[]​.person​.middle-name string Person Middle Name
return​.top-executives​.official[]​.person​.prefix string Person Prefix
return​.top-executives​.official[]​.person​.suffix string Person Suffix
return​.top-executives​.official[]​.connectMail ConnectMail Optional flag set to true when requesting ConnectMail data.
return​.top-executives​.official[]​.connectMail​.connectMailNameSource boolean
return​.top-executives​.official[]​.connectMail​.connectMailEmailSource boolean Indicates if official's email address is a ConnectMail contact
return​.top-executives​.official[]​.connectMail​.connectMailPhoneSource boolean Indicates if official's phone number is a ConnectMail contact
return​.top-executives​.official[]​.connectMail​.connectMailSource string Source of the primary contact. If it's true, then the primary contact's source is "ConnectMail". So, in order to view the primary contact, you should have purchased the contact. If connectMailNameSource is false, then the primary contact's name will be available to you by default.
return​.primaryURLs PrimaryUrls
return​.primaryURLs​.primaryUrl Array of PrimaryUrl Primary URL for the company
return​.primaryURLs​.primaryUrl[]​.url string A primary url for a company
return​.primaryURLs​.primaryUrl[]​.sortOrder integer Sort order
return​.otherURLs Urls
return​.otherURLs​.url Array of string
return​.accountingFirm string (1-60 characters) The accounting firm or auditor name for this company. Example: Deloitte & Touche LLP San Fra
return​.bankName string The primary bank name this company banks with.
return​.marketingPreScreenScore string D&B Marketing Prescreen value for this company
return​.keyFinancials KeyFinancials
return​.keyFinancials​.marketValueInfo MarketValueInfo
return​.keyFinancials​.marketValueInfo​.marketValue decimal Market value (in millions of USD) of this company
return​.keyFinancials​.marketValueInfo​.marketValueDate date Date of market valuation
return​.keyFinancials​.incomeAssets IncomeAssets
return​.keyFinancials​.incomeAssets​.period string Fiscal period reporting period for income assets. Example: FY2010. Please note that not all financial fiscal year ranges begin in January.
return​.keyFinancials​.incomeAssets​.assets decimal Total assets (expressed in millions of US Dollars) of this company
return​.keyFinancials​.incomeAssets​.salesGrowthPercent decimal Sales growth in percent for this company
return​.keyFinancials​.incomeAssets​.netIncome decimal Net income (in millions of USD)
return​.keyFinancials​.incomeAssets​.netIncomeGrowthPercent decimal Net income growth in percent of this company
return​.ukSpecs UKSpecs
return​.ukSpecs​.uKRegistration string UK Registration Number. Unique identifier assigned to UK companies by the government's Companies House. Example: 3443456
return​.ukSpecs​.uKVAT string United Kingdom's Value Added Tax Number. Example: 906565610
return​.ukSpecs​.numberOfSubsidiaries NumberOfSubsidiaries
return​.ukSpecs​.numberOfSubsidiaries​.domestic integer Number of subsidiaries in the UK
return​.numberOfPCs integer Number of personal computers (PC's) at this company
return​.spaceAtAddress integer Space in square feet at the location
return​.spaceAtAddressUnitOfMeasurement string Unit of measure for space at address
return​.spaceAtAddressAccuracy integer accuracy of space at address field
return​.ownedOrLeased string Indicates whether company's location is owned or leased
return​.manufacturingIndicator string Indicates if the company is a manufacturer
return​.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.
return​.ethnicity 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)
return​.franchiseOperationType string Indicates the main franchise operation type of the business such as Owned by Franchisee
return​.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.
return​.yearFounded string Year the company was founded
return​.legalStatus string
return​.rankings Rankings
return​.rankings​.rank Array of Rank
return​.rankings​.rank[]​.rankNumber integer Company's rank on a ranking list, such as number 100 on the Fortune 500
return​.rankings​.rank[]​.definition string

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyDetailRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyDetailRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:GetCompanyDetailResponse>
         <sch:return>
            <sch:companyId>10483000000000</sch:companyId>
            <sch:duns>884114609</sch:duns>
            <sch:companyType>PUBLIC</sch:companyType>
            <sch:locationType>HEADQUARTERS</sch:locationType>
            <sch:ultimateParentDuns>884114609</sch:ultimateParentDuns>
            <sch:ultimateParentName>The Dun &amp; Bradstreet Corp...</sch:ultimateParentName>
            <sch:parentDuns>884114609</sch:parentDuns>
            <sch:parentName>The Dun &amp; Bradstreet Corp...</sch:parentName>
            <sch:name>The Dun &amp; Bradstreet Corp...</sch:name>
            <sch:dbaNames>
               <sch:dba>D&amp;B</sch:dba>
            </sch:dbaNames>
            <sch:industries>
               <sch:lineOfBusiness>Credit reporting services</sch:lineOfBusiness>
               <sch:primaryDnBIC>1849</sch:primaryDnBIC>
               <sch:primaryNAICS>524298</sch:primaryNAICS>
               <sch:primaryUSSIC>73230000</sch:primaryUSSIC>
               <sch:primaryUKSIC>74.871</sch:primaryUKSIC>
               <sch:allUKSIC>
                  <sch:item>
                     <sch:uksic>74.871</sch:uksic>
                     <sch:description>Credit reporting and coll...</sch:description>
                  </sch:item>
                  <sch:item>
                     <sch:uksic>72.300</sch:uksic>
                     <sch:description>Data processing</sch:description>
                  </sch:item>
                  ...
               </sch:allUKSIC>
               <sch:allUSSIC>
                  <sch:item>
                     <sch:ussic>87320000</sch:ussic>
                     <sch:description>Commercial nonphysical re...</sch:description>
                  </sch:item>
                  <sch:item>
                     <sch:ussic>73230000</sch:ussic>
                     <sch:description>Credit reporting services</sch:description>
                  </sch:item>
                  ...
               </sch:allUSSIC>
               <sch:allNAICS>
                  <sch:item>
                     <sch:naics>519130</sch:naics>
                     <sch:description>Internet Publishing and B...</sch:description>
                  </sch:item>
                  <sch:item>
                     <sch:naics>519190</sch:naics>
                     <sch:description>All Other Information Ser...</sch:description>
                  </sch:item>
                  ...
                  </sch:allNAICS>
               <sch:allDnBIC>
                  <sch:item>
                     <sch:dnbic>1058</sch:dnbic>
                     <sch:description>Market Research &amp; Polling...</sch:description>
                  </sch:item>
                  <sch:item>
                     <sch:dnbic>1424</sch:dnbic>
                     <sch:description>Insurance Agencies &amp; Brok...</sch:description>
                  </sch:item>
                  ...
                  </sch:allDnBIC>
            </sch:industries>
            <sch:subsidiaryStatus>false</sch:subsidiaryStatus>
            <sch:keyNumbersHistory>
               <sch:annualKeyNumbersHistory>
                  <sch:keyNumbers>
                     <sch:sales xsi:nil="true"/>
                     <sch:employeesAtThisLocation>48</sch:employeesAtThisLocation>
                     <sch:totalEmployeeGrowthPercent xsi:nil="true"/>
                     <sch:employeesTotal xsi:nil="true"/>
                     <sch:researchAndDevelopment xsi:nil="true"/>
                     <sch:advertising xsi:nil="true"/>
                     <sch:fiscal-period>FY</sch:fiscal-period>
                     <sch:periodEndMonth/>
                  </sch:keyNumbers>
                  <sch:keyNumbers>
                     <sch:sales>1758.5</sch:sales>
                     <sch:employeesAtThisLocation xsi:nil="true"/>
                     <sch:totalEmployeeGrowthPercent>-1.92</sch:totalEmployeeGrowthPercent>
                     <sch:employeesTotal>5100</sch:employeesTotal>
                     <sch:researchAndDevelopment xsi:nil="true"/>
                     <sch:advertising xsi:nil="true"/>
                     <sch:fiscal-period>FY2011</sch:fiscal-period>
                     <sch:periodEndMonth>Dec 2011</sch:periodEndMonth>
                  </sch:keyNumbers>
                  ...
                  </sch:annualKeyNumbersHistory>
               <sch:quarterlyKeyNumbersHistory>
                  <sch:keyNumbers>
                     <sch:sales>383.9</sch:sales>
                     <sch:employeesAtThisLocation xsi:nil="true"/>
                     <sch:totalEmployeeGrowthPercent xsi:nil="true"/>
                     <sch:employeesTotal xsi:nil="true"/>
                     <sch:researchAndDevelopment xsi:nil="true"/>
                     <sch:advertising xsi:nil="true"/>
                     <sch:fiscal-period>2Q2012</sch:fiscal-period>
                     <sch:periodEndMonth>Jun 2012</sch:periodEndMonth>
                  </sch:keyNumbers>
                  <sch:keyNumbers>
                     <sch:sales>402.8</sch:sales>
                     <sch:employeesAtThisLocation xsi:nil="true"/>
                     <sch:totalEmployeeGrowthPercent xsi:nil="true"/>
                     <sch:employeesTotal xsi:nil="true"/>
                     <sch:researchAndDevelopment xsi:nil="true"/>
                     <sch:advertising xsi:nil="true"/>
                     <sch:fiscal-period>1Q2012</sch:fiscal-period>
                     <sch:periodEndMonth>Mar 2012</sch:periodEndMonth>
                  </sch:keyNumbers>
                  ...
                  </sch:quarterlyKeyNumbersHistory>
            </sch:keyNumbersHistory>
            <sch:locations>
               <sch:location>
                  <sch:address1>103 Jfk Pkwy.</sch:address1>
                  <sch:address2/>
                  <sch:city>Short Hills</sch:city>
                  <sch:county>Essex County</sch:county>
                  <sch:state>NJ</sch:state>
                  <sch:stateOfIncorporation>DE</sch:stateOfIncorporation>
                  <sch:country>United States</sch:country>
                  <sch:countryId>76</sch:countryId>
                  <sch:zip>07078</sch:zip>
                  <sch:zip4/>
                  <sch:latitude>40.742396</sch:latitude>
                  <sch:longitude>-74.354241</sch:longitude>
                  <sch:latLongAccuracy>0</sch:latLongAccuracy>
                  <sch:addressType>PRIMARY_ADDRESS</sch:addressType>
                  <sch:metroArea>New York-Northern New Jer...</sch:metroArea>
               </sch:location>
            </sch:locations>
            <sch:ownershipYear>1841</sch:ownershipYear>
            <sch:phones>
               <sch:phoneNumber>
                  <sch:countryCode/>
                  <sch:areaCode>973</sch:areaCode>
                  <sch:phoneNumber>921-5500</sch:phoneNumber>
                  <sch:doNotCallRegistry>false</sch:doNotCallRegistry>
               </sch:phoneNumber>
               <sch:phoneNumber>
                  <sch:countryCode/>
                  <sch:areaCode>800</sch:areaCode>
                  <sch:phoneNumber>234-3867</sch:phoneNumber>
                  <sch:doNotCallRegistry>false</sch:doNotCallRegistry>
               </sch:phoneNumber>
            </sch:phones>
            <sch:synopsis>&lt;p&gt;For The Dun &amp; Bradstre...</sch:synopsis>
            <sch:full-description>&lt;p&gt;For The Dun &amp; Bradstre...</sch:full-description>
            <sch:historicalIndicator>false</sch:historicalIndicator>
            <sch:historicalText/>
            <sch:stocks>
               <sch:tickerUS>DNB</sch:tickerUS>
               <sch:exchangeInfoList>
                  <sch:exchangeInfo>
                     <sch:country>United States</sch:country>
                     <sch:tickerSymbol>DNB</sch:tickerSymbol>
                     <sch:exchangeName>BATS</sch:exchangeName>
                  </sch:exchangeInfo>
                  <sch:exchangeInfo>
                     <sch:country>United States</sch:country>
                     <sch:tickerSymbol>DNB</sch:tickerSymbol>
                     <sch:exchangeName>BATS CTA</sch:exchangeName>
                  </sch:exchangeInfo>
                  ...
                  </sch:exchangeInfoList>
            </sch:stocks>
            <sch:top-executives>
               <sch:official>
                  <sch:coOfficialId>1073021000000000</sch:coOfficialId>
                  <sch:latest-position>
                     <sch:title>Chairman and CEO</sch:title>
                     <sch:jobFunction>
                        <sch:jobFunctionId>15</sch:jobFunctionId>
                        <sch:jobFunctionId>55</sch:jobFunctionId>
                     </sch:jobFunction>
                     <sch:start-year>2010</sch:start-year>
                     <sch:end-year>Present</sch:end-year>
                  </sch:latest-position>
                  <sch:latest-salary>
                     <sch:year>2011</sch:year>
                     <sch:salary>800000.0</sch:salary>
                     <sch:total-salary>6666922.0</sch:total-salary>
                     <sch:bonus xsi:nil="true"/>
                  </sch:latest-salary>
                  <sch:person>
                     <sch:age>56</sch:age>
                     <sch:first-name>Sara</sch:first-name>
                     <sch:full-name>Sara S. Mathew</sch:full-name>
                     <sch:last-name>Mathew</sch:last-name>
                     <sch:middle-name>S.</sch:middle-name>
                     <sch:prefix>Ms.</sch:prefix>
                     <sch:suffix/>
                  </sch:person>
                  <sch:connectMail>
                     <sch:connectMailNameSource>false</sch:connectMailNameSource>
                     <sch:connectMailEmailSource>true</sch:connectMailEmailSource>
                     <sch:connectMailPhoneSource>false</sch:connectMailPhoneSource>
                     <sch:connectMailSource>D&amp;B</sch:connectMailSource>
                  </sch:connectMail>
               </sch:official>
               <sch:official>
                  <sch:coOfficialId>2301455000000000</sch:coOfficialId>
                  <sch:latest-position>
                     <sch:title>SVP and CFO</sch:title>
                     <sch:jobFunction>
                        <sch:jobFunctionId>195</sch:jobFunctionId>
                        <sch:jobFunctionId>25</sch:jobFunctionId>
                     </sch:jobFunction>
                     <sch:start-year>2011</sch:start-year>
                     <sch:end-year>Present</sch:end-year>
                  </sch:latest-position>
                  <sch:latest-salary>
                     <sch:year>2011</sch:year>
                     <sch:salary>361250.0</sch:salary>
                     <sch:total-salary>1486303.0</sch:total-salary>
                     <sch:bonus xsi:nil="true"/>
                  </sch:latest-salary>
                  <sch:person>
                     <sch:age>45</sch:age>
                     <sch:first-name>Richard</sch:first-name>
                     <sch:full-name>Richard H. Veldran</sch:full-name>
                     <sch:last-name>Veldran</sch:last-name>
                     <sch:middle-name>H.</sch:middle-name>
                     <sch:prefix>Mr.</sch:prefix>
                     <sch:suffix/>
                  </sch:person>
                  <sch:connectMail>
                     <sch:connectMailNameSource>false</sch:connectMailNameSource>
                     <sch:connectMailEmailSource>true</sch:connectMailEmailSource>
                     <sch:connectMailPhoneSource>false</sch:connectMailPhoneSource>
                     <sch:connectMailSource>D&amp;B</sch:connectMailSource>
                  </sch:connectMail>
               </sch:official>
               ...
            </sch:top-executives>
            <sch:primaryURLs>
               <sch:primaryUrl>
                  <sch:url>http://www.dnb.com</sch:url>
                  <sch:sortOrder>0</sch:sortOrder>
               </sch:primaryUrl>
            </sch:primaryURLs>
            <sch:otherURLs/>
            <sch:accountingFirm>Pricewaterhousecoopers LL...</sch:accountingFirm>
            <sch:bankName/>
            <sch:marketingPreScreenScore>L</sch:marketingPreScreenScore>
            <sch:keyFinancials>
               <sch:marketValueInfo>
                  <sch:marketValue>3722.9619</sch:marketValue>
                  <sch:marketValueDate>2012-10-05</sch:marketValueDate>
               </sch:marketValueInfo>
               <sch:incomeAssets>
                  <sch:period>FY2011</sch:period>
                  <sch:assets>1977.1</sch:assets>
                  <sch:salesGrowthPercent>4.88</sch:salesGrowthPercent>
                  <sch:netIncome>260.3</sch:netIncome>
                  <sch:netIncomeGrowthPercent>3.25</sch:netIncomeGrowthPercent>
               </sch:incomeAssets>
            </sch:keyFinancials>
            <sch:ukSpecs/>
            <sch:numberOfPCs xsi:nil="true"/>
            <sch:spaceAtAddress>123000</sch:spaceAtAddress>
            <sch:spaceAtAddressUnitOfMeasurement>sq ft</sch:spaceAtAddressUnitOfMeasurement>
            <sch:spaceAtAddressAccuracy>0</sch:spaceAtAddressAccuracy>
            <sch:ownedOrLeased>Location Is Rented By Thi...</sch:ownedOrLeased>
            <sch:manufacturingIndicator/>
            <sch:minorityOwned>false</sch:minorityOwned>
            <sch:ethnicity>Unknown</sch:ethnicity>
            <sch:franchiseOperationType/>
            <sch:womenOwned>false</sch:womenOwned>
            <sch:yearFounded>1841</sch:yearFounded>
            <sch:legalStatus>Corporation</sch:legalStatus>
            <sch:rankings>
               <sch:rank>
                  <sch:rankNumber xsi:nil="true"/>
                  <sch:definition>S&amp;P 500 (October 1, 2012)</sch:definition>
               </sch:rank>
               <sch:rank>
                  <sch:rankNumber>996</sch:rankNumber>
                  <sch:definition>FORTUNE 1000 (May 2012)</sch:definition>
               </sch:rank>
            </sch:rankings>
         </sch:return>
      </sch:GetCompanyDetailResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyDetailRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyDetailRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:GetCompanyDetail" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

GetCompanyDetailOptionalData Available in Add-on: Full Company Profile

Returns detailed company information for a single company, with the ability to specify the components that are to be returned."

Request

Element Type Notes
uniqueId long Required Company ID or D-U-N-S Number
optionalResponseFields OptionalDataResponseFields
optionalResponseFields​.includeIndustries boolean If true, the return will include industries the company is affiliated with such as: lineOfBusiness, primaryDnBIC, primaryNAICS, primaryUSSIC, primaryUKSIC, allUKSIC, allUSSIC, allNAICS, allDnBIC
optionalResponseFields​.includeKeyNumbers boolean If true, the return will include annual and quarterly key numbers and affiliated values such as: sales, salesAccuracy, employeesAtThisLocation, employeesAtThisLocationAccuracy, totalEmployeeGrowthPercent, employeesTotal, researchAndDevelopment, advertising, fiscal-period, and periodEndMonth
optionalResponseFields​.includeLocations boolean If true, the return will include location data such aas address, city, county, state, country, countryId, zip, zip4, latitude, longitude, latLongAcuracy, addressType, and metroArea
optionalResponseFields​.includePhones boolean If true, the return will include: faxNumber, countryCode, areaCode, phoneNumber, and whether or not the phone number is listed in the doNotCallRegistry
optionalResponseFields​.includeRankings boolean If true, the return will include details about rankings such as the type of ranking system and the rankNumber
optionalResponseFields​.includeStocks boolean If true, the return will include stock information such as tickerUS, exchangeInfoList , exchangeInfo, exchangePrimary country, tickerSymbol, and exchangeName
optionalResponseFields​.includeTopExecutives boolean If true, the return will include official information about the company's top executives such as Chairman and CEO and include jobFunctionId's, start and end year, compensation details, age, and the full name of these executives
optionalResponseFields​.includeURLs boolean If true, the return will include a company's official website address such as http://www.thecoca-colacompany.com, the sortorder, and other official URL addresses
optionalResponseFields​.includeSocialMedia Array of string Type of social media data to include for the company. Options: all, twitter, facebook, youtube, wikipedia Available Values:
all
twitter
youtube
facebook
wikipedia

Response

Element Type Notes
return GetCompanyDetailOptionalWrapper
return​.companyId long Company ID - Most likely this will be a DUNS number. However, there are Hoover's editorial ID's as another unique company ID (Example: 10483000000000). These company ID's may or may not have a corresponding DUNS number.
return​.duns string 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]*)".
return​.companyType string 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.
return​.locationType string Company Location Type such as Single Location (0), Headquarters (1), Branch (2), Branch/Division (4), Subsidiary (5)
return​.ultimateParentDuns string The ultimate parent company D-U-N-S Number for a family of companies
return​.ultimateParentName string The ultimate parent company name corresponding to the ultimate parent DUNS Number
return​.parentDuns string
return​.parentName string The company name of the company's immediate parent company.
return​.name string Company Name
return​.nonMarketableCompany NonMarketableReasons Non-marketable company reason such as 'Invalid address', 'Out of business', 'Key data missing/needing revision', 'Requested no marketing contact'
return​.nonMarketableCompany​.reason Array of string Reason for non-marketable status; Non-marketable company reasons: 'Invalid address', 'Out of business', 'Key data missing/needing revision', 'Requested no marketing contact' Available Values:
Invalid address
Out of business
Key data missing/needing revision
Requested no marketing contact
return​.dbaNames DBANames
return​.dbaNames​.dba Array of string Doing Business As or Trade Style Name
return​.industries Industries
return​.industries​.lineOfBusiness string Primary line of business which could based on USSIC, UKSIC, etc.
return​.industries​.primaryDnBIC string 4 digit D&B Industry Code. DNBIC Code: Replaces dnbicName (DNBIC Name)
return​.industries​.primaryNAICS string NAICS Code. Primary NAICS Code. Individual 2-digit to 6-digit codes and code ranges are allowed. To get a broad range of companies within an industry sector, use 2-digit codes. To get more specific results for a line of business, use 6-digit codes
return​.industries​.primaryUSSIC string Primary US SIC Code. "SIC" (Standard Industrial Classification) is an industry code system developed by the US Government. 2 to 8 digit SIC codes are supported.
return​.industries​.primaryUKSIC string Primary UK SIC Code. United Kingdom Standard Industrial Classification of Economic Activities.
return​.industries​.allUKSIC AllUKSIC
return​.industries​.allUKSIC​.item Array of AllUKSICItem
return​.industries​.allUKSIC​.item[]​.uksic 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.
return​.industries​.allUKSIC​.item[]​.description string
return​.industries​.allUSSIC AllUSSIC
return​.industries​.allUSSIC​.item Array of AllUSSICItem
return​.industries​.allUSSIC​.item[]​.ussic string US SIC Code: "SIC" (Standard Industrial Classification) is an industry code system developed by the US Government.
return​.industries​.allUSSIC​.item[]​.description string
return​.industries​.allNAICS AllNAICS
return​.industries​.allNAICS​.item Array of AllNAICSItem
return​.industries​.allNAICS​.item[]​.naics 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.
return​.industries​.allNAICS​.item[]​.description string
return​.industries​.allDnBIC AllDnBIC
return​.industries​.allDnBIC​.item Array of AllDnBICItem
return​.industries​.allDnBIC​.item[]​.dnbic string D&B Industry Code
return​.industries​.allDnBIC​.item[]​.description string
return​.subsidiaryStatus boolean 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).
return​.keyNumbersHistory KeyNumbersHistory
return​.keyNumbersHistory​.annualKeyNumbersHistory TimePeriodKeyNumbers
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers Array of KeyNumbers
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.sales decimal Annual Sales in millions
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.employeesAtThisLocation integer The number of employees at this location. The total number of individuals engaged by a business entity at the location of the DUNS numbered subject entity.
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.totalEmployeeGrowthPercent decimal Total Employee Growth % for the Year
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.employeesTotal integer Total number of employees. The total number of people employed by all branches and subsidiaries of a business.
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.researchAndDevelopment decimal R&D expenses for the year. This value is in US dollars.
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.advertising decimal Advertising expenses for the year expressed in millions of US dollars.
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.fiscal-period string Fiscal reporting period as a key number. Please note that not all financial fiscal year ranges begin in January. Example: FY2010
return​.keyNumbersHistory​.annualKeyNumbersHistory​.keyNumbers[]​.periodEndMonth string Period End Month. Abbreviated Month and full year. Example: Jan 2012
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory TimePeriodKeyNumbers
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers Array of KeyNumbers
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.sales decimal Annual Sales in millions
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.employeesAtThisLocation integer The number of employees at this location. The total number of individuals engaged by a business entity at the location of the DUNS numbered subject entity.
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.totalEmployeeGrowthPercent decimal Total Employee Growth % for the Year
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.employeesTotal integer Total number of employees. The total number of people employed by all branches and subsidiaries of a business.
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.researchAndDevelopment decimal R&D expenses for the year. This value is in US dollars.
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.advertising decimal Advertising expenses for the year expressed in millions of US dollars.
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.fiscal-period string Fiscal reporting period as a key number. Please note that not all financial fiscal year ranges begin in January. Example: FY2010
return​.keyNumbersHistory​.quarterlyKeyNumbersHistory​.keyNumbers[]​.periodEndMonth string Period End Month. Abbreviated Month and full year. Example: Jan 2012
return​.locations Locations
return​.locations​.location Array of Location Type of location for the company; headquarters, branch office, etc.
return​.locations​.location[]​.address1 string (up to 150 characters) Company address line 1
return​.locations​.location[]​.address2 string (up to 70 characters) Company address line 2
return​.locations​.location[]​.city string City
return​.locations​.location[]​.county string Company County
return​.locations​.location[]​.state string (1-30 characters) State
return​.locations​.location[]​.stateOfIncorporation string Company State of Incorporation
return​.locations​.location[]​.country string Country
return​.locations​.location[]​.countryId integer Country ID - D&B-assigned code which identifies the country where the business is located.
return​.locations​.location[]​.zip string Postal/ZIP code
return​.locations​.location[]​.zip4 string ZIP Plus 4 code
return​.locations​.location[]​.latitude decimal
return​.locations​.location[]​.longitude decimal Longitude component of geo location
return​.locations​.location[]​.latLongAccuracy string
return​.locations​.location[]​.addressType string (up to 70 characters) Type of address such as Primary Address, Headquarters, or Mailing
return​.locations​.location[]​.metroArea string The metropolitan area for the location
return​.ownershipYear string Ownership year
return​.phones PhoneNumbers
return​.phones​.faxNumber Array of PhoneNumber
return​.phones​.faxNumber[]​.countryCode string (1-2 characters) Dial these numbers to access the phone number in the designated country. For example, for Mitsubishi's primary phone number in Japan "81" is listed. For a New Zealand-based company "61" is listed.
return​.phones​.faxNumber[]​.areaCode string US or Canadian Phone Number Area Code
return​.phones​.faxNumber[]​.phoneNumber string Phone Number
return​.phones​.faxNumber[]​.doNotCallRegistry boolean Indicates whether company is listed on a UK Do Not Call registry
return​.phones​.phoneNumber Array of PhoneNumber Phone Number
return​.phones​.phoneNumber[]​.countryCode string (1-2 characters) Dial these numbers to access the phone number in the designated country. For example, for Mitsubishi's primary phone number in Japan "81" is listed. For a New Zealand-based company "61" is listed.
return​.phones​.phoneNumber[]​.areaCode string US or Canadian Phone Number Area Code
return​.phones​.phoneNumber[]​.phoneNumber string Phone Number
return​.phones​.phoneNumber[]​.doNotCallRegistry boolean Indicates whether company is listed on a UK Do Not Call registry
return​.synopsis string Company Description with html tags
return​.full-description string Full company description
return​.historicalIndicator boolean Indicates that the company has ceased operations and is no longer covered by editors.
return​.historicalText string Brief description why company is defunct
return​.stocks Stocks
return​.stocks​.tickerUS string The stock ticker symbol for a company which is used to identify listed companies on the securities exchanges on which they trade.
return​.stocks​.exchangeInfoList ExchangeInfoList
return​.stocks​.exchangeInfoList​.exchangeInfo Array of ExchangeInfo
return​.stocks​.exchangeInfoList​.exchangeInfo[]​.country string Country
return​.stocks​.exchangeInfoList​.exchangeInfo[]​.tickerSymbol string The stock ticker symbol for a company used to identify listed companies on the securities exchanges on which they trade.
return​.stocks​.exchangeInfoList​.exchangeInfo[]​.exchangeName string Name of the exchange where this company is traded.
return​.top-executives CompanyTopExecutives
return​.top-executives​.official Array of TopExecutive Max array length: 3
return​.top-executives​.official[]​.coOfficialId long Company's official ID that is 7 - 16 digits long. This element differs from the unique company ID (which is the DUNS number or company ID).
return​.top-executives​.official[]​.latest-position OfficialLatestPosition
return​.top-executives​.official[]​.latest-position​.title string
return​.top-executives​.official[]​.latest-position​.jobFunction Records a person's job functions. For example, in a person's latest position, he or she was "President, CEO, and Director" so the ID's contained in this element correspond to these functions.
return​.top-executives​.official[]​.latest-position​.jobFunction​.jobFunctionId Array of integer Identifies a job function that may be independent of job title. Management Responsibility Code (MRC) identifies the title of the principal or manager for the subject.
return​.top-executives​.official[]​.latest-position​.start-year string Latest position start year
return​.top-executives​.official[]​.latest-position​.end-year string Latest position end year
return​.top-executives​.official[]​.latest-salary OfficialLatestSalary
return​.top-executives​.official[]​.latest-salary​.year unsignedLong
return​.top-executives​.official[]​.latest-salary​.salary decimal Salary for the year excluding bonus
return​.top-executives​.official[]​.latest-salary​.total-salary decimal Total compensation for the year, including any bonus or other compensation in USD
return​.top-executives​.official[]​.latest-salary​.bonus decimal Bonus for the fiscal year (not the actual year) expressed in millions of local currency which can include US dollars and can be converted to USD, Euros, British Pounds, Canadian Dollars, Japanese Yen, or Swedish Kronor for use in our products. Prerequisites: The company has to be covered by Hoover's, and it has to file documents with the SEC, and the officer has to be one of the five highest-compensated people at the company.
return​.top-executives​.official[]​.person Person
return​.top-executives​.official[]​.person​.age long (up to 4 characters) Person Age
return​.top-executives​.official[]​.person​.first-name string Person First Name
return​.top-executives​.official[]​.person​.full-name string Person Full Name
return​.top-executives​.official[]​.person​.last-name string Person Last Name
return​.top-executives​.official[]​.person​.middle-name string Person Middle Name
return​.top-executives​.official[]​.person​.prefix string Person Prefix
return​.top-executives​.official[]​.person​.suffix string Person Suffix
return​.top-executives​.official[]​.connectMail ConnectMail Optional flag set to true when requesting ConnectMail data.
return​.top-executives​.official[]​.connectMail​.connectMailNameSource boolean
return​.top-executives​.official[]​.connectMail​.connectMailEmailSource boolean Indicates if official's email address is a ConnectMail contact
return​.top-executives​.official[]​.connectMail​.connectMailPhoneSource boolean Indicates if official's phone number is a ConnectMail contact
return​.top-executives​.official[]​.connectMail​.connectMailSource string Source of the primary contact. If it's true, then the primary contact's source is "ConnectMail". So, in order to view the primary contact, you should have purchased the contact. If connectMailNameSource is false, then the primary contact's name will be available to you by default.
return​.primaryURLs PrimaryUrls
return​.primaryURLs​.primaryUrl Array of PrimaryUrl Primary URL for the company
return​.primaryURLs​.primaryUrl[]​.url string A primary url for a company
return​.primaryURLs​.primaryUrl[]​.sortOrder integer Sort order
return​.otherURLs Urls
return​.otherURLs​.url Array of string
return​.accountingFirm string (1-60 characters) The accounting firm or auditor name for this company. Example: Deloitte & Touche LLP San Fra
return​.bankName string The primary bank name this company banks with.
return​.marketingPreScreenScore string D&B Marketing Prescreen value for this company
return​.keyFinancials KeyFinancials
return​.keyFinancials​.marketValueInfo MarketValueInfo
return​.keyFinancials​.marketValueInfo​.marketValue decimal Market value (in millions of USD) of this company
return​.keyFinancials​.marketValueInfo​.marketValueDate date Date of market valuation
return​.keyFinancials​.incomeAssets IncomeAssets
return​.keyFinancials​.incomeAssets​.period string Fiscal period reporting period for income assets. Example: FY2010. Please note that not all financial fiscal year ranges begin in January.
return​.keyFinancials​.incomeAssets​.assets decimal Total assets (expressed in millions of US Dollars) of this company
return​.keyFinancials​.incomeAssets​.salesGrowthPercent decimal Sales growth in percent for this company
return​.keyFinancials​.incomeAssets​.netIncome decimal Net income (in millions of USD)
return​.keyFinancials​.incomeAssets​.netIncomeGrowthPercent decimal Net income growth in percent of this company
return​.ukSpecs UKSpecs
return​.ukSpecs​.uKRegistration string UK Registration Number. Unique identifier assigned to UK companies by the government's Companies House. Example: 3443456
return​.ukSpecs​.uKVAT string United Kingdom's Value Added Tax Number. Example: 906565610
return​.ukSpecs​.numberOfSubsidiaries NumberOfSubsidiaries
return​.ukSpecs​.numberOfSubsidiaries​.domestic integer Number of subsidiaries in the UK
return​.numberOfPCs integer Number of personal computers (PC's) at this company
return​.spaceAtAddress integer Space in square feet at the location
return​.spaceAtAddressUnitOfMeasurement string Unit of measure for space at address
return​.spaceAtAddressAccuracy integer accuracy of space at address field
return​.ownedOrLeased string Indicates whether company's location is owned or leased
return​.manufacturingIndicator string Indicates if the company is a manufacturer
return​.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.
return​.ethnicity 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)
return​.franchiseOperationType string Indicates the main franchise operation type of the business such as Owned by Franchisee
return​.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.
return​.yearFounded string Year the company was founded
return​.legalStatus string
return​.rankings Rankings
return​.rankings​.rank Array of Rank
return​.rankings​.rank[]​.rankNumber integer Company's rank on a ranking list, such as number 100 on the Fortune 500
return​.rankings​.rank[]​.definition string
return​.socialMedia SocialMedia
return​.socialMedia​.twitter Twitter
return​.socialMedia​.twitter​.twitterAccount Array of TwitterAccount
return​.socialMedia​.twitter​.twitterAccount[]​.twitterUsername string Company Twitter username
return​.socialMedia​.twitter​.twitterAccount[]​.twitterDisplayName string Company Twitter display name
return​.socialMedia​.twitter​.twitterAccount[]​.twitterFollowers long Number of Twitter followers
return​.socialMedia​.youTube YouTube
return​.socialMedia​.youTube​.youTubeAccount Array of YouTubeAccount
return​.socialMedia​.youTube​.youTubeAccount[]​.youTubeChannel string YouTube channel name
return​.socialMedia​.youTube​.youTubeAccount[]​.youTubeSubscribers long Number of YouTube subscribers
return​.socialMedia​.facebook Facebook
return​.socialMedia​.facebook​.facebookAccount Array of FacebookAccount
return​.socialMedia​.facebook​.facebookAccount[]​.facebookUsername string Company Facebook username
return​.socialMedia​.facebook​.facebookAccount[]​.facebookFans long Number of company Facebook fans which is determined by the number of people who "like" the company on Facebook
return​.socialMedia​.wikipedia Wikipedia
return​.socialMedia​.wikipedia​.wikipediaUrl Array of string Url to company Wikiepedia page

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyDetailOptionalDataRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
         <ns0:optionalResponseFields>
            <ns0:includeIndustries>true</ns0:includeIndustries>
            <ns0:includeURLs>true</ns0:includeURLs>
            <ns0:includeSocialMedia>twitter</ns0:includeSocialMedia>
            <ns0:includeSocialMedia>facebook</ns0:includeSocialMedia>
         </ns0:optionalResponseFields>
      </ns0:GetCompanyDetailOptionalDataRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:GetCompanyDetailOptionalDataResponse>
         <sch:return>
            <sch:companyId>10483000000000</sch:companyId>
            <sch:duns>884114609</sch:duns>
            <sch:companyType>PUBLIC</sch:companyType>
            <sch:locationType>HEADQUARTERS</sch:locationType>
            <sch:ultimateParentDuns>884114609</sch:ultimateParentDuns>
            <sch:ultimateParentName>The Dun &amp; Bradstreet Corp...</sch:ultimateParentName>
            <sch:parentDuns>884114609</sch:parentDuns>
            <sch:parentName>The Dun &amp; Bradstreet Corp...</sch:parentName>
            <sch:name>The Dun &amp; Bradstreet Corp...</sch:name>
            <sch:dbaNames>
               <sch:dba>D&amp;B</sch:dba>
            </sch:dbaNames>
            <sch:industries>
               <sch:lineOfBusiness>Credit reporting services</sch:lineOfBusiness>
               <sch:primaryDnBIC>1849</sch:primaryDnBIC>
               <sch:primaryNAICS>524298</sch:primaryNAICS>
               <sch:primaryUSSIC>73230000</sch:primaryUSSIC>
               <sch:primaryUKSIC>74.871</sch:primaryUKSIC>
               <sch:allUKSIC>
                  <sch:item>
                     <sch:uksic>74.871</sch:uksic>
                     <sch:description>Credit reporting and coll...</sch:description>
                  </sch:item>
                  <sch:item>
                     <sch:uksic>72.300</sch:uksic>
                     <sch:description>Data processing</sch:description>
                  </sch:item>
                  ...
               </sch:allUKSIC>
               <sch:allUSSIC>
                  <sch:item>
                     <sch:ussic>87320000</sch:ussic>
                     <sch:description>Commercial nonphysical re...</sch:description>
                  </sch:item>
                  <sch:item>
                     <sch:ussic>73230000</sch:ussic>
                     <sch:description>Credit reporting services</sch:description>
                  </sch:item>
                  ...
               </sch:allUSSIC>
               <sch:allNAICS>
                  <sch:item>
                     <sch:naics>519130</sch:naics>
                     <sch:description>Internet Publishing and B...</sch:description>
                  </sch:item>
                  <sch:item>
                     <sch:naics>519190</sch:naics>
                     <sch:description>All Other Information Ser...</sch:description>
                  </sch:item>
                  ...
                  </sch:allNAICS>
               <sch:allDnBIC>
                  <sch:item>
                     <sch:dnbic>1058</sch:dnbic>
                     <sch:description>Market Research &amp; Polling...</sch:description>
                  </sch:item>
                  <sch:item>
                     <sch:dnbic>1424</sch:dnbic>
                     <sch:description>Insurance Agencies &amp; Brok...</sch:description>
                  </sch:item>
                  ...
                  </sch:allDnBIC>
            </sch:industries>
            <sch:subsidiaryStatus>false</sch:subsidiaryStatus>
            <sch:ownershipYear>1841</sch:ownershipYear>
            <sch:synopsis>&lt;p&gt;For The Dun &amp; Bradstre...</sch:synopsis>
            <sch:full-description>&lt;p&gt;For The Dun &amp; Bradstre...</sch:full-description>
            <sch:historicalIndicator>false</sch:historicalIndicator>
            <sch:historicalText/>
            <sch:primaryURLs>
               <sch:primaryUrl>
                  <sch:url>http://www.dnb.com</sch:url>
                  <sch:sortOrder>0</sch:sortOrder>
               </sch:primaryUrl>
            </sch:primaryURLs>
            <sch:otherURLs/>
            <sch:accountingFirm>Pricewaterhousecoopers LL...</sch:accountingFirm>
            <sch:bankName/>
            <sch:marketingPreScreenScore>L</sch:marketingPreScreenScore>
            <sch:keyFinancials>
               <sch:marketValueInfo>
                  <sch:marketValue>3722.9619</sch:marketValue>
                  <sch:marketValueDate>2012-10-05</sch:marketValueDate>
               </sch:marketValueInfo>
               <sch:incomeAssets/>
            </sch:keyFinancials>
            <sch:ukSpecs/>
            <sch:numberOfPCs xsi:nil="true"/>
            <sch:spaceAtAddress>123000</sch:spaceAtAddress>
            <sch:spaceAtAddressUnitOfMeasurement>sq ft</sch:spaceAtAddressUnitOfMeasurement>
            <sch:spaceAtAddressAccuracy>0</sch:spaceAtAddressAccuracy>
            <sch:ownedOrLeased>Location Is Rented By Thi...</sch:ownedOrLeased>
            <sch:manufacturingIndicator/>
            <sch:minorityOwned>false</sch:minorityOwned>
            <sch:ethnicity>Unknown</sch:ethnicity>
            <sch:franchiseOperationType/>
            <sch:womenOwned>false</sch:womenOwned>
            <sch:yearFounded>1841</sch:yearFounded>
            <sch:legalStatus>Corporation</sch:legalStatus>
            <sch:socialMedia>
               <sch:twitter>
                  <sch:twitterAccount>
                     <sch:twitterUsername>dnbsupplierrisk</sch:twitterUsername>
                     <sch:twitterDisplayName>D&amp;B Supplier Risk</sch:twitterDisplayName>
                     <sch:twitterFollowers>964</sch:twitterFollowers>
                  </sch:twitterAccount>
               </sch:twitter>
               <sch:facebook>
                  <sch:facebookAccount>
                     <sch:facebookUsername>149591618410019</sch:facebookUsername>
                     <sch:facebookFans>0</sch:facebookFans>
                  </sch:facebookAccount>
               </sch:facebook>
            </sch:socialMedia>
         </sch:return>
      </sch:GetCompanyDetailOptionalDataResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyDetailOptionalDataRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
         <ns0:optionalResponseFields>
            <ns0:includeIndustries>true</ns0:includeIndustries>
            <ns0:includeURLs>true</ns0:includeURLs>
            <ns0:includeSocialMedia>twitter</ns0:includeSocialMedia>
            <ns0:includeSocialMedia>facebook</ns0:includeSocialMedia>
         </ns0:optionalResponseFields>
      </ns0:GetCompanyDetailOptionalDataRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:GetCompanyDetailOptionalData" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

GetCompanyDetailSimple Included in Base Package

Returns a reduced subset of company information for a given company."

Request

Element Type Notes
uniqueId long Required Company ID or D-U-N-S Number

Response

Element Type Notes
return GetCompanyDetailSimpleResponseWrapper
return​.name string Company Name
return​.companyId long Company ID - Most likely this will be a DUNS number. However, there are Hoover's editorial ID's as another unique company ID (Example: 10483000000000). These company ID's may or may not have a corresponding DUNS number.
return​.nonMarketableCompany NonMarketableReasons Non-marketable company reason such as 'Invalid address', 'Out of business', 'Key data missing/needing revision', 'Requested no marketing contact'
return​.nonMarketableCompany​.reason Array of string Reason for non-marketable status; Non-marketable company reasons: 'Invalid address', 'Out of business', 'Key data missing/needing revision', 'Requested no marketing contact' Available Values:
Invalid address
Out of business
Key data missing/needing revision
Requested no marketing contact
return​.primaryLocation PrimaryLocation
return​.primaryLocation​.address1 string (up to 150 characters) Company address line 1
return​.primaryLocation​.address2 string (up to 70 characters) Company address line 2
return​.primaryLocation​.city string City
return​.primaryLocation​.country string Country
return​.primaryLocation​.state string (1-30 characters) State
return​.primaryLocation​.zip string Postal/ZIP code
return​.primaryLocation​.zip4 string ZIP Plus 4 code
return​.primaryLocation​.latitude decimal
return​.primaryLocation​.longitude decimal Longitude component of geo location
return​.primaryLocation​.latLongAccuracy string
return​.primaryPhone PrimaryPhoneNumber
return​.primaryPhone​.countryCode string (1-2 characters) Dial these numbers to access the phone number in the designated country. For example, for Mitsubishi's primary phone number in Japan "81" is listed. For a New Zealand-based company "61" is listed.
return​.primaryPhone​.areaCode string US or Canadian Phone Number Area Code
return​.primaryPhone​.phoneNumber string Phone Number
return​.primaryPhone​.doNotCallRegistry boolean Indicates whether company is listed on a UK Do Not Call registry
return​.primaryURL string Primary URL for the company
return​.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.
return​.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.
return​.yearFounded string Year the company was founded
return​.legalStatus string
return​.franchiseOperationType string Indicates the main franchise operation type of the business such as Owned by Franchisee

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyDetailSimpleRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyDetailSimpleRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:GetCompanyDetailSimpleResponse>
         <sch:return>
            <sch:name>The Dun &amp; Bradstreet Corp...</sch:name>
            <sch:companyId>10483000000000</sch:companyId>
            <sch:primaryLocation>
               <sch:address1>103 Jfk Pkwy.</sch:address1>
               <sch:address2/>
               <sch:city>Short Hills</sch:city>
               <sch:country>United States</sch:country>
               <sch:state>NJ</sch:state>
               <sch:zip>07078</sch:zip>
               <sch:zip4/>
               <sch:latitude>40.742396</sch:latitude>
               <sch:longitude>-74.354241</sch:longitude>
               <sch:latLongAccuracy>0</sch:latLongAccuracy>
            </sch:primaryLocation>
            <sch:primaryPhone>
               <sch:countryCode/>
               <sch:areaCode>973</sch:areaCode>
               <sch:phoneNumber>921-5500</sch:phoneNumber>
               <sch:doNotCallRegistry>false</sch:doNotCallRegistry>
            </sch:primaryPhone>
            <sch:primaryURL>http://www.dnb.com</sch:primaryURL>
            <sch:minorityOwned>false</sch:minorityOwned>
            <sch:womenOwned>false</sch:womenOwned>
            <sch:yearFounded>1841</sch:yearFounded>
            <sch:legalStatus>Corporation</sch:legalStatus>
            <sch:franchiseOperationType/>
         </sch:return>
      </sch:GetCompanyDetailSimpleResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyDetailSimpleRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyDetailSimpleRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:GetCompanyDetailSimple" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

GetCompanyFinancialDetail Available in Add-on: Advanced Financial Information

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

Request

Element Type Notes
uniqueId long Required Company ID or D-U-N-S Number

Response

Element Type Notes
return GetCompanyFinancialDetailResponseWrapper
return​.annualIncomeStatements AnnualIncomeStatements
return​.annualIncomeStatements​.latestYear AnnualIncomeStatement
return​.annualIncomeStatements​.latestYear​.year string
return​.annualIncomeStatements​.latestYear​.revenue decimal Revenue in millions
return​.annualIncomeStatements​.latestYear​.grossProfit decimal The gross profit in millions of US Dollars claimed on the income statement.
return​.annualIncomeStatements​.latestYear​.operatingIncome decimal The operating income in millions (USD) claimed on the income statement
return​.annualIncomeStatements​.latestYear​.totalNetIncome decimal The total net income in millions (USD) claimed on the income statement.
return​.annualIncomeStatements​.latestYear​.dilutedEPS decimal The diluted earnings per share claimed on the income statement.
return​.annualIncomeStatements​.previousYears PreviousYears
return​.annualIncomeStatements​.previousYears​.previousYear Array of AnnualIncomeStatement
return​.annualIncomeStatements​.previousYears​.previousYear[]​.year string
return​.annualIncomeStatements​.previousYears​.previousYear[]​.revenue decimal Revenue in millions
return​.annualIncomeStatements​.previousYears​.previousYear[]​.grossProfit decimal The gross profit in millions of US Dollars claimed on the income statement.
return​.annualIncomeStatements​.previousYears​.previousYear[]​.operatingIncome decimal The operating income in millions (USD) claimed on the income statement
return​.annualIncomeStatements​.previousYears​.previousYear[]​.totalNetIncome decimal The total net income in millions (USD) claimed on the income statement.
return​.annualIncomeStatements​.previousYears​.previousYear[]​.dilutedEPS decimal The diluted earnings per share claimed on the income statement.
return​.quarterlyIncomeStatements QuarterlyIncomeStatements
return​.quarterlyIncomeStatements​.latestQuarter QuarterlyIncomeStatement
return​.quarterlyIncomeStatements​.latestQuarter​.quarterMonth string The month of the quarterly data
return​.quarterlyIncomeStatements​.latestQuarter​.quarterYear string The year of the quarterly data
return​.quarterlyIncomeStatements​.latestQuarter​.revenue decimal Revenue in millions
return​.quarterlyIncomeStatements​.latestQuarter​.grossProfit decimal The gross profit in millions of US Dollars claimed on the income statement.
return​.quarterlyIncomeStatements​.latestQuarter​.operatingIncome decimal The operating income in millions (USD) claimed on the income statement
return​.quarterlyIncomeStatements​.latestQuarter​.totalNetIncome decimal The total net income in millions (USD) claimed on the income statement.
return​.quarterlyIncomeStatements​.latestQuarter​.dilutedEPS decimal The diluted earnings per share claimed on the income statement.
return​.quarterlyIncomeStatements​.previousQuarters PreviousQuarters
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter Array of QuarterlyIncomeStatement
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.quarterMonth string The month of the quarterly data
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.quarterYear string The year of the quarterly data
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.revenue decimal Revenue in millions
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.grossProfit decimal The gross profit in millions of US Dollars claimed on the income statement.
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.operatingIncome decimal The operating income in millions (USD) claimed on the income statement
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.totalNetIncome decimal The total net income in millions (USD) claimed on the income statement.
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.dilutedEPS decimal The diluted earnings per share claimed on the income statement.
return​.annualCashFlowStatements AnnualCashFlowStatements
return​.annualCashFlowStatements​.latestYear AnnualCashFlowStatement
return​.annualCashFlowStatements​.latestYear​.year string
return​.annualCashFlowStatements​.latestYear​.cashAndCashEquivalentsAtTheBeginningOfTheYear decimal Cash and cash equivalents for the current year in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash.
return​.annualCashFlowStatements​.latestYear​.netCashProvidedByOperatingActivities decimal Net operating cash flow, cash flow from operations in millions (USD)
return​.annualCashFlowStatements​.latestYear​.netCashProvidedByInvestingActivities decimal
return​.annualCashFlowStatements​.latestYear​.netCashProvidedByFinancingActivities decimal
return​.annualCashFlowStatements​.latestYear​.netIncreaseDecreaseInCashAndCashEquivalents decimal Net change in cash, increase or decrease in cash and cash equivalents from the beginning to the end of a statement period.
return​.annualCashFlowStatements​.latestYear​.cashAndCashEquivalentsAtTheEndOfTheYear decimal Cash and cash equivalents for the previous year in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash.
return​.annualCashFlowStatements​.latestYear​.capitalExpenditure decimal
return​.annualCashFlowStatements​.previousYears PreviousYearsCashFlowStatement
return​.annualCashFlowStatements​.previousYears​.previousYear Array of AnnualCashFlowStatement
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.year string
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.cashAndCashEquivalentsAtTheBeginningOfTheYear decimal Cash and cash equivalents for the current year in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash.
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.netCashProvidedByOperatingActivities decimal Net operating cash flow, cash flow from operations in millions (USD)
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.netCashProvidedByInvestingActivities decimal
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.netCashProvidedByFinancingActivities decimal
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.netIncreaseDecreaseInCashAndCashEquivalents decimal Net change in cash, increase or decrease in cash and cash equivalents from the beginning to the end of a statement period.
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.cashAndCashEquivalentsAtTheEndOfTheYear decimal Cash and cash equivalents for the previous year in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash.
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.capitalExpenditure decimal
return​.quarterlyCashFlowStatements QuarterlyCashFlowStatements
return​.quarterlyCashFlowStatements​.latestQuarter QuarterlyCashFlowStatement
return​.quarterlyCashFlowStatements​.latestQuarter​.quarterMonth string The month of the quarterly data
return​.quarterlyCashFlowStatements​.latestQuarter​.quarterYear string The year of the quarterly data
return​.quarterlyCashFlowStatements​.latestQuarter​.cashAndCashEquivalentsAtTheBeginningOfTheQuarter decimal Cash and cash equivalents for the current quarter in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash. To find out when the beginning of the quarter is for an organization, refer to the co_financial_id which contains information about the period of time covered by the quarter. E.g. 15245000000000:FINL:1Q2012:201106 indicated that the quarter ending at the end of June 2011 (and thus starting at the first of April 2011) was the first quarter in the company's 2012 fiscal year.
return​.quarterlyCashFlowStatements​.latestQuarter​.netCashProvidedByOperatingActivities decimal Net operating cash flow, cash flow from operations in millions (USD)
return​.quarterlyCashFlowStatements​.latestQuarter​.netCashProvidedByInvestingActivities decimal
return​.quarterlyCashFlowStatements​.latestQuarter​.netCashProvidedByFinancingActivities decimal
return​.quarterlyCashFlowStatements​.latestQuarter​.netIncreaseDecreaseInCashAndCashEquivalents decimal Net change in cash, increase or decrease in cash and cash equivalents from the beginning to the end of a statement period.
return​.quarterlyCashFlowStatements​.latestQuarter​.cashAndCashEquivalentsAtTheEndOfTheQuarter decimal Cash and cash equivalents for the previous quarter in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash.
return​.quarterlyCashFlowStatements​.latestQuarter​.capitalExpenditure decimal
return​.quarterlyCashFlowStatements​.previousQuarters PreviousQuartersCashFlowStatement
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter Array of QuarterlyCashFlowStatement
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.quarterMonth string The month of the quarterly data
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.quarterYear string The year of the quarterly data
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.cashAndCashEquivalentsAtTheBeginningOfTheQuarter decimal Cash and cash equivalents for the current quarter in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash. To find out when the beginning of the quarter is for an organization, refer to the co_financial_id which contains information about the period of time covered by the quarter. E.g. 15245000000000:FINL:1Q2012:201106 indicated that the quarter ending at the end of June 2011 (and thus starting at the first of April 2011) was the first quarter in the company's 2012 fiscal year.
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.netCashProvidedByOperatingActivities decimal Net operating cash flow, cash flow from operations in millions (USD)
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.netCashProvidedByInvestingActivities decimal
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.netCashProvidedByFinancingActivities decimal
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.netIncreaseDecreaseInCashAndCashEquivalents decimal Net change in cash, increase or decrease in cash and cash equivalents from the beginning to the end of a statement period.
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.cashAndCashEquivalentsAtTheEndOfTheQuarter decimal Cash and cash equivalents for the previous quarter in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash.
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.capitalExpenditure decimal

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyFinancialDetailRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyFinancialDetailRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:GetCompanyFinancialDetailResponse>
         <sch:return>
            <sch:annualIncomeStatements>
               <sch:latestYear>
                  <sch:year>2011</sch:year>
                  <sch:revenue>1758.5</sch:revenue>
                  <sch:grossProfit>1171.4</sch:grossProfit>
                  <sch:operatingIncome>424.8</sch:operatingIncome>
                  <sch:totalNetIncome>260.3</sch:totalNetIncome>
                  <sch:dilutedEPS>5.28</sch:dilutedEPS>
               </sch:latestYear>
               <sch:previousYears>
                  <sch:previousYear>
                     <sch:year>2010</sch:year>
                     <sch:revenue>1676.6</sch:revenue>
                     <sch:grossProfit>1118.8999999999999</sch:grossProfit>
                     <sch:operatingIncome>409.1</sch:operatingIncome>
                     <sch:totalNetIncome>252.1</sch:totalNetIncome>
                     <sch:dilutedEPS>4.98</sch:dilutedEPS>
                  </sch:previousYear>
                  <sch:previousYear>
                     <sch:year>2009</sch:year>
                     <sch:revenue>1687.0</sch:revenue>
                     <sch:grossProfit>1186.7</sch:grossProfit>
                     <sch:operatingIncome>464.5</sch:operatingIncome>
                     <sch:totalNetIncome>319.4</sch:totalNetIncome>
                     <sch:dilutedEPS>5.99</sch:dilutedEPS>
                  </sch:previousYear>
                  ...
                  </sch:previousYears>
            </sch:annualIncomeStatements>
            <sch:quarterlyIncomeStatements>
               <sch:latestQuarter>
                  <sch:quarterMonth>June</sch:quarterMonth>
                  <sch:quarterYear>2012</sch:quarterYear>
                  <sch:revenue>383.9</sch:revenue>
                  <sch:grossProfit>257.5</sch:grossProfit>
                  <sch:operatingIncome>89.3</sch:operatingIncome>
                  <sch:totalNetIncome>56.5</sch:totalNetIncome>
                  <sch:dilutedEPS>1.20</sch:dilutedEPS>
               </sch:latestQuarter>
               <sch:previousQuarters>
                  <sch:previousQuarter>
                     <sch:quarterMonth>March</sch:quarterMonth>
                     <sch:quarterYear>2012</sch:quarterYear>
                     <sch:revenue>402.8</sch:revenue>
                     <sch:grossProfit>258.20000000000005</sch:grossProfit>
                     <sch:operatingIncome>74.4</sch:operatingIncome>
                     <sch:totalNetIncome>63.4</sch:totalNetIncome>
                     <sch:dilutedEPS>1.32</sch:dilutedEPS>
                  </sch:previousQuarter>
                  <sch:previousQuarter>
                     <sch:quarterMonth>December</sch:quarterMonth>
                     <sch:quarterYear>2011</sch:quarterYear>
                     <sch:revenue>498.7</sch:revenue>
                     <sch:grossProfit>342.7</sch:grossProfit>
                     <sch:operatingIncome>145.1</sch:operatingIncome>
                     <sch:totalNetIncome>93.5</sch:totalNetIncome>
                     <sch:dilutedEPS>1.93</sch:dilutedEPS>
                  </sch:previousQuarter>
                  ...
                  </sch:previousQuarters>
            </sch:quarterlyIncomeStatements>
            <sch:annualCashFlowStatements>
               <sch:latestYear>
                  <sch:year>2011</sch:year>
                  <sch:cashAndCashEquivalentsAtTheBeginningOfTheYear>78.5</sch:cashAndCashEquivalentsAtTheBeginningOfTheYear>
                  <sch:netCashProvidedByOperatingActivities>312.9</sch:netCashProvidedByOperatingActivities>
                  <sch:netCashProvidedByInvestingActivities>-73.4</sch:netCashProvidedByInvestingActivities>
                  <sch:netCashProvidedByFinancingActivities>-238.0</sch:netCashProvidedByFinancingActivities>
                  <sch:netIncreaseDecreaseInCashAndCashEquivalents>5.9</sch:netIncreaseDecreaseInCashAndCashEquivalents>
                  <sch:cashAndCashEquivalentsAtTheEndOfTheYear>84.4</sch:cashAndCashEquivalentsAtTheEndOfTheYear>
                  <sch:capitalExpenditure>-53.4</sch:capitalExpenditure>
               </sch:latestYear>
               <sch:previousYears>
                  <sch:previousYear>
                     <sch:year>2010</sch:year>
                     <sch:cashAndCashEquivalentsAtTheBeginningOfTheYear>222.9</sch:cashAndCashEquivalentsAtTheBeginningOfTheYear>
                     <sch:netCashProvidedByOperatingActivities>319.4</sch:netCashProvidedByOperatingActivities>
                     <sch:netCashProvidedByInvestingActivities>-253.6</sch:netCashProvidedByInvestingActivities>
                     <sch:netCashProvidedByFinancingActivities>-192.9</sch:netCashProvidedByFinancingActivities>
                     <sch:netIncreaseDecreaseInCashAndCashEquivalents>-144.4</sch:netIncreaseDecreaseInCashAndCashEquivalents>
                     <sch:cashAndCashEquivalentsAtTheEndOfTheYear>78.5</sch:cashAndCashEquivalentsAtTheEndOfTheYear>
                     <sch:capitalExpenditure>-65.9</sch:capitalExpenditure>
                  </sch:previousYear>
                  <sch:previousYear>
                     <sch:year>2009</sch:year>
                     <sch:cashAndCashEquivalentsAtTheBeginningOfTheYear>164.2</sch:cashAndCashEquivalentsAtTheBeginningOfTheYear>
                     <sch:netCashProvidedByOperatingActivities>369.5</sch:netCashProvidedByOperatingActivities>
                     <sch:netCashProvidedByInvestingActivities>-120.7</sch:netCashProvidedByInvestingActivities>
                     <sch:netCashProvidedByFinancingActivities>-213.1</sch:netCashProvidedByFinancingActivities>
                     <sch:netIncreaseDecreaseInCashAndCashEquivalents>58.7</sch:netIncreaseDecreaseInCashAndCashEquivalents>
                     <sch:cashAndCashEquivalentsAtTheEndOfTheYear>222.9</sch:cashAndCashEquivalentsAtTheEndOfTheYear>
                     <sch:capitalExpenditure>-65.3</sch:capitalExpenditure>
                  </sch:previousYear>
                  ...
                  </sch:previousYears>
            </sch:annualCashFlowStatements>
            <sch:quarterlyCashFlowStatements>
               <sch:latestQuarter>
                  <sch:quarterMonth>June</sch:quarterMonth>
                  <sch:quarterYear>2012</sch:quarterYear>
                  <sch:cashAndCashEquivalentsAtTheBeginningOfTheQuarter>117.7</sch:cashAndCashEquivalentsAtTheBeginningOfTheQuarter>
                  <sch:netCashProvidedByOperatingActivities>243.6</sch:netCashProvidedByOperatingActivities>
                  <sch:netCashProvidedByInvestingActivities>-24.4</sch:netCashProvidedByInvestingActivities>
                  <sch:netCashProvidedByFinancingActivities>-183.2</sch:netCashProvidedByFinancingActivities>
                  <sch:netIncreaseDecreaseInCashAndCashEquivalents>34.2</sch:netIncreaseDecreaseInCashAndCashEquivalents>
                  <sch:cashAndCashEquivalentsAtTheEndOfTheQuarter>118.6</sch:cashAndCashEquivalentsAtTheEndOfTheQuarter>
                  <sch:capitalExpenditure>-34.2</sch:capitalExpenditure>
               </sch:latestQuarter>
               <sch:previousQuarters>
                  <sch:previousQuarter>
                     <sch:quarterMonth>March</sch:quarterMonth>
                     <sch:quarterYear>2012</sch:quarterYear>
                     <sch:cashAndCashEquivalentsAtTheBeginningOfTheQuarter>84.4</sch:cashAndCashEquivalentsAtTheBeginningOfTheQuarter>
                     <sch:netCashProvidedByOperatingActivities>167.3</sch:netCashProvidedByOperatingActivities>
                     <sch:netCashProvidedByInvestingActivities>-1.4</sch:netCashProvidedByInvestingActivities>
                     <sch:netCashProvidedByFinancingActivities>-134.0</sch:netCashProvidedByFinancingActivities>
                     <sch:netIncreaseDecreaseInCashAndCashEquivalents>33.3</sch:netIncreaseDecreaseInCashAndCashEquivalents>
                     <sch:cashAndCashEquivalentsAtTheEndOfTheQuarter>117.7</sch:cashAndCashEquivalentsAtTheEndOfTheQuarter>
                     <sch:capitalExpenditure>-15.3</sch:capitalExpenditure>
                  </sch:previousQuarter>
                  <sch:previousQuarter>
                     <sch:quarterMonth>December</sch:quarterMonth>
                     <sch:quarterYear>2011</sch:quarterYear>
                     <sch:cashAndCashEquivalentsAtTheBeginningOfTheQuarter>89.5</sch:cashAndCashEquivalentsAtTheBeginningOfTheQuarter>
                     <sch:netCashProvidedByOperatingActivities>312.9</sch:netCashProvidedByOperatingActivities>
                     <sch:netCashProvidedByInvestingActivities>-73.4</sch:netCashProvidedByInvestingActivities>
                     <sch:netCashProvidedByFinancingActivities>-238.0</sch:netCashProvidedByFinancingActivities>
                     <sch:netIncreaseDecreaseInCashAndCashEquivalents>5.9</sch:netIncreaseDecreaseInCashAndCashEquivalents>
                     <sch:cashAndCashEquivalentsAtTheEndOfTheQuarter>84.4</sch:cashAndCashEquivalentsAtTheEndOfTheQuarter>
                     <sch:capitalExpenditure>-53.4</sch:capitalExpenditure>
                  </sch:previousQuarter>
                  ...
                  </sch:previousQuarters>
            </sch:quarterlyCashFlowStatements>
         </sch:return>
      </sch:GetCompanyFinancialDetailResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyFinancialDetailRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyFinancialDetailRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:GetCompanyFinancialDetail" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

GetCompanyFinancialSummary Available in Add-on: Advanced Financial Information

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

Request

Element Type Notes
uniqueId long Required Company ID or D-U-N-S Number

Response

Element Type Notes
return GetCompanyFinancialSummaryResponseWrapper
return​.basicFinancialInformation BasicFinancialInformation
return​.basicFinancialInformation​.companyType string 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.
return​.basicFinancialInformation​.exchanges ExchangeList
return​.basicFinancialInformation​.exchanges​.exchange Array of Exchange
return​.basicFinancialInformation​.exchanges​.exchange[]​.tickerSymbol string The stock ticker symbol for a company used to identify listed companies on the securities exchanges on which they trade.
return​.basicFinancialInformation​.exchanges​.exchange[]​.exchangeName string Name of the exchange where this company is traded.
return​.basicFinancialInformation​.location string Type of location for the company; headquarters, branch office, etc.
return​.basicFinancialInformation​.fiscalYearEnd string The month the fiscal year ends. Not all financial fiscal year ranges end in December, for example.
return​.basicFinancialInformation​.latestYearSales LatestYearSales
return​.basicFinancialInformation​.latestYearSales​.year string The year for the sales data
return​.basicFinancialInformation​.latestYearSales​.sales decimal Annual Sales in millions
return​.basicFinancialInformation​.oneYearSalesGrowthPct decimal The one year sales growth percent. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.basicFinancialInformation​.latestYearNetIncome LatestYearNetIncome
return​.basicFinancialInformation​.latestYearNetIncome​.year string The year for the net income data
return​.basicFinancialInformation​.latestYearNetIncome​.netIncome decimal Net income (in millions of USD)
return​.basicFinancialInformation​.oneYearNetIncomeGrowthPct decimal The one year net income growth percent
return​.basicFinancialInformation​.auditor string The name of the financial auditor for this company. An Auditor is a Certified Public Accountant who certifies that a company's financial statements meet GAAP (Generally Accepted Accounting Practices) standards or the standards for the associated country.
return​.annualIncomeStatements AnnualIncomeStatements
return​.annualIncomeStatements​.latestYear AnnualIncomeStatement
return​.annualIncomeStatements​.latestYear​.year string
return​.annualIncomeStatements​.latestYear​.revenue decimal Revenue in millions
return​.annualIncomeStatements​.latestYear​.grossProfit decimal The gross profit in millions of US Dollars claimed on the income statement.
return​.annualIncomeStatements​.latestYear​.operatingIncome decimal The operating income in millions (USD) claimed on the income statement
return​.annualIncomeStatements​.latestYear​.totalNetIncome decimal The total net income in millions (USD) claimed on the income statement.
return​.annualIncomeStatements​.latestYear​.dilutedEPS decimal The diluted earnings per share claimed on the income statement.
return​.annualIncomeStatements​.previousYears PreviousYears
return​.annualIncomeStatements​.previousYears​.previousYear Array of AnnualIncomeStatement
return​.annualIncomeStatements​.previousYears​.previousYear[]​.year string
return​.annualIncomeStatements​.previousYears​.previousYear[]​.revenue decimal Revenue in millions
return​.annualIncomeStatements​.previousYears​.previousYear[]​.grossProfit decimal The gross profit in millions of US Dollars claimed on the income statement.
return​.annualIncomeStatements​.previousYears​.previousYear[]​.operatingIncome decimal The operating income in millions (USD) claimed on the income statement
return​.annualIncomeStatements​.previousYears​.previousYear[]​.totalNetIncome decimal The total net income in millions (USD) claimed on the income statement.
return​.annualIncomeStatements​.previousYears​.previousYear[]​.dilutedEPS decimal The diluted earnings per share claimed on the income statement.
return​.quarterlyIncomeStatements QuarterlyIncomeStatements
return​.quarterlyIncomeStatements​.latestQuarter QuarterlyIncomeStatement
return​.quarterlyIncomeStatements​.latestQuarter​.quarterMonth string The month of the quarterly data
return​.quarterlyIncomeStatements​.latestQuarter​.quarterYear string The year of the quarterly data
return​.quarterlyIncomeStatements​.latestQuarter​.revenue decimal Revenue in millions
return​.quarterlyIncomeStatements​.latestQuarter​.grossProfit decimal The gross profit in millions of US Dollars claimed on the income statement.
return​.quarterlyIncomeStatements​.latestQuarter​.operatingIncome decimal The operating income in millions (USD) claimed on the income statement
return​.quarterlyIncomeStatements​.latestQuarter​.totalNetIncome decimal The total net income in millions (USD) claimed on the income statement.
return​.quarterlyIncomeStatements​.latestQuarter​.dilutedEPS decimal The diluted earnings per share claimed on the income statement.
return​.quarterlyIncomeStatements​.previousQuarters PreviousQuarters
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter Array of QuarterlyIncomeStatement
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.quarterMonth string The month of the quarterly data
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.quarterYear string The year of the quarterly data
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.revenue decimal Revenue in millions
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.grossProfit decimal The gross profit in millions of US Dollars claimed on the income statement.
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.operatingIncome decimal The operating income in millions (USD) claimed on the income statement
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.totalNetIncome decimal The total net income in millions (USD) claimed on the income statement.
return​.quarterlyIncomeStatements​.previousQuarters​.previousQuarter[]​.dilutedEPS decimal The diluted earnings per share claimed on the income statement.
return​.comparisonToIndustryAndMarket ComparisonToIndustryAndMarket
return​.comparisonToIndustryAndMarket​.company Comparison
return​.comparisonToIndustryAndMarket​.company​.priceSalesRatio decimal Price to sales ratio
return​.comparisonToIndustryAndMarket​.company​.priceEarningRatio decimal
return​.comparisonToIndustryAndMarket​.company​.priceBookRatio decimal Price to book ratio
return​.comparisonToIndustryAndMarket​.company​.priceCashFlowRatio decimal Price to cash flow ratio
return​.comparisonToIndustryAndMarket​.industryMedian Comparison
return​.comparisonToIndustryAndMarket​.industryMedian​.priceSalesRatio decimal Price to sales ratio
return​.comparisonToIndustryAndMarket​.industryMedian​.priceEarningRatio decimal
return​.comparisonToIndustryAndMarket​.industryMedian​.priceBookRatio decimal Price to book ratio
return​.comparisonToIndustryAndMarket​.industryMedian​.priceCashFlowRatio decimal Price to cash flow ratio
return​.comparisonToIndustryAndMarket​.marketMedian Comparison
return​.comparisonToIndustryAndMarket​.marketMedian​.priceSalesRatio decimal Price to sales ratio
return​.comparisonToIndustryAndMarket​.marketMedian​.priceEarningRatio decimal
return​.comparisonToIndustryAndMarket​.marketMedian​.priceBookRatio decimal Price to book ratio
return​.comparisonToIndustryAndMarket​.marketMedian​.priceCashFlowRatio decimal Price to cash flow ratio
return​.topCompetitors TopCompetitors
return​.topCompetitors​.competitor1 Competitor
return​.topCompetitors​.competitor1​.companyName string Company Name
return​.topCompetitors​.competitor1​.annualSales decimal The annual sales number (based on fiscal year end (FYE)) expressed in millions of US Dollars for this competitor
return​.topCompetitors​.competitor1​.employees unsignedLong The number of employees at the indicated top competitor's location. The total number of individuals engaged by a business entity to perform its business operations.
return​.topCompetitors​.competitor1​.marketCap decimal Market Cap (Capitalization) 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.
return​.topCompetitors​.competitor2 Competitor
return​.topCompetitors​.competitor2​.companyName string Company Name
return​.topCompetitors​.competitor2​.annualSales decimal The annual sales number (based on fiscal year end (FYE)) expressed in millions of US Dollars for this competitor
return​.topCompetitors​.competitor2​.employees unsignedLong The number of employees at the indicated top competitor's location. The total number of individuals engaged by a business entity to perform its business operations.
return​.topCompetitors​.competitor2​.marketCap decimal Market Cap (Capitalization) 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.
return​.topCompetitors​.competitor3 Competitor
return​.topCompetitors​.competitor3​.companyName string Company Name
return​.topCompetitors​.competitor3​.annualSales decimal The annual sales number (based on fiscal year end (FYE)) expressed in millions of US Dollars for this competitor
return​.topCompetitors​.competitor3​.employees unsignedLong The number of employees at the indicated top competitor's location. The total number of individuals engaged by a business entity to perform its business operations.
return​.topCompetitors​.competitor3​.marketCap decimal Market Cap (Capitalization) 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.
return​.annualBalanceSheets AnnualBalanceSheets
return​.annualBalanceSheets​.latestYear BalanceSheet
return​.annualBalanceSheets​.latestYear​.year string
return​.annualBalanceSheets​.latestYear​.quarterMonth string The month of the quarterly data
return​.annualBalanceSheets​.latestYear​.quarterYear string The year of the quarterly data
return​.annualBalanceSheets​.latestYear​.assets Assets Total assets (expressed in millions of US Dollars) of this company
return​.annualBalanceSheets​.latestYear​.assets​.currentAssets CurrentAssets
return​.annualBalanceSheets​.latestYear​.assets​.currentAssets​.cash decimal Cash includes currency on hand (in local currency which can include USD and can convert it into USD, Euros, British Pounds, Canadian Dollars, Japanese Yen, or Swedish Kronor) as well as demand deposits with banks or financial institutions
return​.annualBalanceSheets​.latestYear​.assets​.currentAssets​.netReceivables decimal
return​.annualBalanceSheets​.latestYear​.assets​.currentAssets​.inventories decimal A company's merchandise, raw materials, and finished and unfinished products which have not yet been sold.
return​.annualBalanceSheets​.latestYear​.assets​.currentAssets​.otherIncomeAssets decimal Other Income Assets includes prepayments, deferred charges, and amounts (other than trade accounts) due from parents and subsidiaries.
return​.annualBalanceSheets​.latestYear​.assets​.assetSummary AssetSummary
return​.annualBalanceSheets​.latestYear​.assets​.assetSummary​.totalCurrentAssets decimal
return​.annualBalanceSheets​.latestYear​.assets​.assetSummary​.netFixedAssets decimal Tangible assets that are held by an entity for use in the production or supply of goods and services, for rental to others, or for administrative purposes and that are expected to provide economic benefit for more than one year; net of accumulated depreciation.
return​.annualBalanceSheets​.latestYear​.assets​.assetSummary​.otherNonCurrentAssets decimal Assets that are not assigned to Net Fixed Assets or intangibles.
return​.annualBalanceSheets​.latestYear​.assets​.assetSummary​.totalAssets decimal The total amount of assets considered to be convertible into cash within a relatively short period of time, usually a year
return​.annualBalanceSheets​.latestYear​.liabilities Liabilities
return​.annualBalanceSheets​.latestYear​.liabilities​.currentLiabilities CurrentLiabilities
return​.annualBalanceSheets​.latestYear​.liabilities​.currentLiabilities​.accountsPayable decimal Expressed in millions of US dollars. Any money that a company owes its suppliers for goods and services purchased on credit and is expected to pay within the next year or operating cycle. Example: "36.4"
return​.annualBalanceSheets​.latestYear​.liabilities​.currentLiabilities​.shortTermDebt decimal All borrowings due within one year including current portions of long-term debt and capital leases as well as short-term debt such as bank loans and commercial paper
return​.annualBalanceSheets​.latestYear​.liabilities​.currentLiabilities​.otherCurrentLiabilities decimal Other obligations that are due within one year, includes tax payables
return​.annualBalanceSheets​.latestYear​.liabilities​.liabilitySummary LiabilitySummary
return​.annualBalanceSheets​.latestYear​.liabilities​.liabilitySummary​.totalCurrentLiabilities decimal The debts or obligations of the firm
return​.annualBalanceSheets​.latestYear​.liabilities​.liabilitySummary​.longTermDebt decimal Sum of the carrying values as of the balance sheet date of all long-term debt, which is debt initially having maturities due after one year or beyond the operating cycle, if longer, but excluding the portions thereof scheduled to be repaid within one year or the normal operating cycle, if longer. Long-term debt includes notes payable, bonds payable, mortgage loans, convertible debt, subordinated debt and other types of long term debt.
return​.annualBalanceSheets​.latestYear​.liabilities​.liabilitySummary​.otherNonCurrentLiabilities decimal Other obligations that are due after one year
return​.annualBalanceSheets​.latestYear​.liabilities​.liabilitySummary​.totalLiabilities decimal Probable future sacrifices of economic benefits arising from present obligations of an enterprise to transfer assets or provide services to others in the future as a result of past transactions or events.
return​.annualBalanceSheets​.latestYear​.shareholdersEquity ShareholdersEquity
return​.annualBalanceSheets​.latestYear​.shareholdersEquity​.equity Equity
return​.annualBalanceSheets​.latestYear​.shareholdersEquity​.equity​.preferredStockEquity decimal Preferred stock (all issues) at par value, as reported within the Shareholder's Equity section of the balance sheet.
return​.annualBalanceSheets​.latestYear​.shareholdersEquity​.equity​.commonStockEquity decimal Common stock (all issues) at par value (received in local currency (which can include USD) and convert it to USD, Euros, British Pounds, Canadian Dollars, Japanese Yen, or Swedish Kronor for use in our products. Stock prices are presented in actual values. Other financial amounts are typically presented in thousands, millions, or billions.), as reported within the Shareholder's Equity section of the balance sheet. This field is one component of Common Shareholder's Equity. Example: -743.9.
return​.annualBalanceSheets​.latestYear​.shareholdersEquity​.equitySummary EquitySummary
return​.annualBalanceSheets​.latestYear​.shareholdersEquity​.equitySummary​.totalEquity decimal Refers to the ratio of Current Debt and Long Term Debt to Common Equity
return​.annualBalanceSheets​.latestYear​.shareholdersEquity​.equitySummary​.sharesOutstanding decimal The latest total shares outstanding reported by the company; the most common source of this information is from the cover of the 10K, 10Q, or 20F filing. This value is displayed in millions of shares.
return​.annualBalanceSheets​.previousYears PreviousBalanceSheetYears
return​.annualBalanceSheets​.previousYears​.previousYear Array of BalanceSheet
return​.annualBalanceSheets​.previousYears​.previousYear[]​.year string
return​.annualBalanceSheets​.previousYears​.previousYear[]​.quarterMonth string The month of the quarterly data
return​.annualBalanceSheets​.previousYears​.previousYear[]​.quarterYear string The year of the quarterly data
return​.annualBalanceSheets​.previousYears​.previousYear[]​.assets Assets Total assets (expressed in millions of US Dollars) of this company
return​.annualBalanceSheets​.previousYears​.previousYear[]​.assets​.currentAssets CurrentAssets
return​.annualBalanceSheets​.previousYears​.previousYear[]​.assets​.currentAssets​.cash decimal Cash includes currency on hand (in local currency which can include USD and can convert it into USD, Euros, British Pounds, Canadian Dollars, Japanese Yen, or Swedish Kronor) as well as demand deposits with banks or financial institutions
return​.annualBalanceSheets​.previousYears​.previousYear[]​.assets​.currentAssets​.netReceivables decimal
return​.annualBalanceSheets​.previousYears​.previousYear[]​.assets​.currentAssets​.inventories decimal A company's merchandise, raw materials, and finished and unfinished products which have not yet been sold.
return​.annualBalanceSheets​.previousYears​.previousYear[]​.assets​.currentAssets​.otherIncomeAssets decimal Other Income Assets includes prepayments, deferred charges, and amounts (other than trade accounts) due from parents and subsidiaries.
return​.annualBalanceSheets​.previousYears​.previousYear[]​.assets​.assetSummary AssetSummary
return​.annualBalanceSheets​.previousYears​.previousYear[]​.assets​.assetSummary​.totalCurrentAssets decimal
return​.annualBalanceSheets​.previousYears​.previousYear[]​.assets​.assetSummary​.netFixedAssets decimal Tangible assets that are held by an entity for use in the production or supply of goods and services, for rental to others, or for administrative purposes and that are expected to provide economic benefit for more than one year; net of accumulated depreciation.
return​.annualBalanceSheets​.previousYears​.previousYear[]​.assets​.assetSummary​.otherNonCurrentAssets decimal Assets that are not assigned to Net Fixed Assets or intangibles.
return​.annualBalanceSheets​.previousYears​.previousYear[]​.assets​.assetSummary​.totalAssets decimal The total amount of assets considered to be convertible into cash within a relatively short period of time, usually a year
return​.annualBalanceSheets​.previousYears​.previousYear[]​.liabilities Liabilities
return​.annualBalanceSheets​.previousYears​.previousYear[]​.liabilities​.currentLiabilities CurrentLiabilities
return​.annualBalanceSheets​.previousYears​.previousYear[]​.liabilities​.currentLiabilities​.accountsPayable decimal Expressed in millions of US dollars. Any money that a company owes its suppliers for goods and services purchased on credit and is expected to pay within the next year or operating cycle. Example: "36.4"
return​.annualBalanceSheets​.previousYears​.previousYear[]​.liabilities​.currentLiabilities​.shortTermDebt decimal All borrowings due within one year including current portions of long-term debt and capital leases as well as short-term debt such as bank loans and commercial paper
return​.annualBalanceSheets​.previousYears​.previousYear[]​.liabilities​.currentLiabilities​.otherCurrentLiabilities decimal Other obligations that are due within one year, includes tax payables
return​.annualBalanceSheets​.previousYears​.previousYear[]​.liabilities​.liabilitySummary LiabilitySummary
return​.annualBalanceSheets​.previousYears​.previousYear[]​.liabilities​.liabilitySummary​.totalCurrentLiabilities decimal The debts or obligations of the firm
return​.annualBalanceSheets​.previousYears​.previousYear[]​.liabilities​.liabilitySummary​.longTermDebt decimal Sum of the carrying values as of the balance sheet date of all long-term debt, which is debt initially having maturities due after one year or beyond the operating cycle, if longer, but excluding the portions thereof scheduled to be repaid within one year or the normal operating cycle, if longer. Long-term debt includes notes payable, bonds payable, mortgage loans, convertible debt, subordinated debt and other types of long term debt.
return​.annualBalanceSheets​.previousYears​.previousYear[]​.liabilities​.liabilitySummary​.otherNonCurrentLiabilities decimal Other obligations that are due after one year
return​.annualBalanceSheets​.previousYears​.previousYear[]​.liabilities​.liabilitySummary​.totalLiabilities decimal Probable future sacrifices of economic benefits arising from present obligations of an enterprise to transfer assets or provide services to others in the future as a result of past transactions or events.
return​.annualBalanceSheets​.previousYears​.previousYear[]​.shareholdersEquity ShareholdersEquity
return​.annualBalanceSheets​.previousYears​.previousYear[]​.shareholdersEquity​.equity Equity
return​.annualBalanceSheets​.previousYears​.previousYear[]​.shareholdersEquity​.equity​.preferredStockEquity decimal Preferred stock (all issues) at par value, as reported within the Shareholder's Equity section of the balance sheet.
return​.annualBalanceSheets​.previousYears​.previousYear[]​.shareholdersEquity​.equity​.commonStockEquity decimal Common stock (all issues) at par value (received in local currency (which can include USD) and convert it to USD, Euros, British Pounds, Canadian Dollars, Japanese Yen, or Swedish Kronor for use in our products. Stock prices are presented in actual values. Other financial amounts are typically presented in thousands, millions, or billions.), as reported within the Shareholder's Equity section of the balance sheet. This field is one component of Common Shareholder's Equity. Example: -743.9.
return​.annualBalanceSheets​.previousYears​.previousYear[]​.shareholdersEquity​.equitySummary EquitySummary
return​.annualBalanceSheets​.previousYears​.previousYear[]​.shareholdersEquity​.equitySummary​.totalEquity decimal Refers to the ratio of Current Debt and Long Term Debt to Common Equity
return​.annualBalanceSheets​.previousYears​.previousYear[]​.shareholdersEquity​.equitySummary​.sharesOutstanding decimal The latest total shares outstanding reported by the company; the most common source of this information is from the cover of the 10K, 10Q, or 20F filing. This value is displayed in millions of shares.
return​.quarterlyBalanceSheets QuarterlyBalanceSheets
return​.quarterlyBalanceSheets​.latestQuarter BalanceSheet
return​.quarterlyBalanceSheets​.latestQuarter​.year string
return​.quarterlyBalanceSheets​.latestQuarter​.quarterMonth string The month of the quarterly data
return​.quarterlyBalanceSheets​.latestQuarter​.quarterYear string The year of the quarterly data
return​.quarterlyBalanceSheets​.latestQuarter​.assets Assets Total assets (expressed in millions of US Dollars) of this company
return​.quarterlyBalanceSheets​.latestQuarter​.assets​.currentAssets CurrentAssets
return​.quarterlyBalanceSheets​.latestQuarter​.assets​.currentAssets​.cash decimal Cash includes currency on hand (in local currency which can include USD and can convert it into USD, Euros, British Pounds, Canadian Dollars, Japanese Yen, or Swedish Kronor) as well as demand deposits with banks or financial institutions
return​.quarterlyBalanceSheets​.latestQuarter​.assets​.currentAssets​.netReceivables decimal
return​.quarterlyBalanceSheets​.latestQuarter​.assets​.currentAssets​.inventories decimal A company's merchandise, raw materials, and finished and unfinished products which have not yet been sold.
return​.quarterlyBalanceSheets​.latestQuarter​.assets​.currentAssets​.otherIncomeAssets decimal Other Income Assets includes prepayments, deferred charges, and amounts (other than trade accounts) due from parents and subsidiaries.
return​.quarterlyBalanceSheets​.latestQuarter​.assets​.assetSummary AssetSummary
return​.quarterlyBalanceSheets​.latestQuarter​.assets​.assetSummary​.totalCurrentAssets decimal
return​.quarterlyBalanceSheets​.latestQuarter​.assets​.assetSummary​.netFixedAssets decimal Tangible assets that are held by an entity for use in the production or supply of goods and services, for rental to others, or for administrative purposes and that are expected to provide economic benefit for more than one year; net of accumulated depreciation.
return​.quarterlyBalanceSheets​.latestQuarter​.assets​.assetSummary​.otherNonCurrentAssets decimal Assets that are not assigned to Net Fixed Assets or intangibles.
return​.quarterlyBalanceSheets​.latestQuarter​.assets​.assetSummary​.totalAssets decimal The total amount of assets considered to be convertible into cash within a relatively short period of time, usually a year
return​.quarterlyBalanceSheets​.latestQuarter​.liabilities Liabilities
return​.quarterlyBalanceSheets​.latestQuarter​.liabilities​.currentLiabilities CurrentLiabilities
return​.quarterlyBalanceSheets​.latestQuarter​.liabilities​.currentLiabilities​.accountsPayable decimal Expressed in millions of US dollars. Any money that a company owes its suppliers for goods and services purchased on credit and is expected to pay within the next year or operating cycle. Example: "36.4"
return​.quarterlyBalanceSheets​.latestQuarter​.liabilities​.currentLiabilities​.shortTermDebt decimal All borrowings due within one year including current portions of long-term debt and capital leases as well as short-term debt such as bank loans and commercial paper
return​.quarterlyBalanceSheets​.latestQuarter​.liabilities​.currentLiabilities​.otherCurrentLiabilities decimal Other obligations that are due within one year, includes tax payables
return​.quarterlyBalanceSheets​.latestQuarter​.liabilities​.liabilitySummary LiabilitySummary
return​.quarterlyBalanceSheets​.latestQuarter​.liabilities​.liabilitySummary​.totalCurrentLiabilities decimal The debts or obligations of the firm
return​.quarterlyBalanceSheets​.latestQuarter​.liabilities​.liabilitySummary​.longTermDebt decimal Sum of the carrying values as of the balance sheet date of all long-term debt, which is debt initially having maturities due after one year or beyond the operating cycle, if longer, but excluding the portions thereof scheduled to be repaid within one year or the normal operating cycle, if longer. Long-term debt includes notes payable, bonds payable, mortgage loans, convertible debt, subordinated debt and other types of long term debt.
return​.quarterlyBalanceSheets​.latestQuarter​.liabilities​.liabilitySummary​.otherNonCurrentLiabilities decimal Other obligations that are due after one year
return​.quarterlyBalanceSheets​.latestQuarter​.liabilities​.liabilitySummary​.totalLiabilities decimal Probable future sacrifices of economic benefits arising from present obligations of an enterprise to transfer assets or provide services to others in the future as a result of past transactions or events.
return​.quarterlyBalanceSheets​.latestQuarter​.shareholdersEquity ShareholdersEquity
return​.quarterlyBalanceSheets​.latestQuarter​.shareholdersEquity​.equity Equity
return​.quarterlyBalanceSheets​.latestQuarter​.shareholdersEquity​.equity​.preferredStockEquity decimal Preferred stock (all issues) at par value, as reported within the Shareholder's Equity section of the balance sheet.
return​.quarterlyBalanceSheets​.latestQuarter​.shareholdersEquity​.equity​.commonStockEquity decimal Common stock (all issues) at par value (received in local currency (which can include USD) and convert it to USD, Euros, British Pounds, Canadian Dollars, Japanese Yen, or Swedish Kronor for use in our products. Stock prices are presented in actual values. Other financial amounts are typically presented in thousands, millions, or billions.), as reported within the Shareholder's Equity section of the balance sheet. This field is one component of Common Shareholder's Equity. Example: -743.9.
return​.quarterlyBalanceSheets​.latestQuarter​.shareholdersEquity​.equitySummary EquitySummary
return​.quarterlyBalanceSheets​.latestQuarter​.shareholdersEquity​.equitySummary​.totalEquity decimal Refers to the ratio of Current Debt and Long Term Debt to Common Equity
return​.quarterlyBalanceSheets​.latestQuarter​.shareholdersEquity​.equitySummary​.sharesOutstanding decimal The latest total shares outstanding reported by the company; the most common source of this information is from the cover of the 10K, 10Q, or 20F filing. This value is displayed in millions of shares.
return​.quarterlyBalanceSheets​.previousQuarters PreviousBalanceSheetQuarters
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter Array of BalanceSheet
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.year string
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.quarterMonth string The month of the quarterly data
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.quarterYear string The year of the quarterly data
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.assets Assets Total assets (expressed in millions of US Dollars) of this company
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.assets​.currentAssets CurrentAssets
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.assets​.currentAssets​.cash decimal Cash includes currency on hand (in local currency which can include USD and can convert it into USD, Euros, British Pounds, Canadian Dollars, Japanese Yen, or Swedish Kronor) as well as demand deposits with banks or financial institutions
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.assets​.currentAssets​.netReceivables decimal
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.assets​.currentAssets​.inventories decimal A company's merchandise, raw materials, and finished and unfinished products which have not yet been sold.
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.assets​.currentAssets​.otherIncomeAssets decimal Other Income Assets includes prepayments, deferred charges, and amounts (other than trade accounts) due from parents and subsidiaries.
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.assets​.assetSummary AssetSummary
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.assets​.assetSummary​.totalCurrentAssets decimal
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.assets​.assetSummary​.netFixedAssets decimal Tangible assets that are held by an entity for use in the production or supply of goods and services, for rental to others, or for administrative purposes and that are expected to provide economic benefit for more than one year; net of accumulated depreciation.
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.assets​.assetSummary​.otherNonCurrentAssets decimal Assets that are not assigned to Net Fixed Assets or intangibles.
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.assets​.assetSummary​.totalAssets decimal The total amount of assets considered to be convertible into cash within a relatively short period of time, usually a year
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.liabilities Liabilities
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.liabilities​.currentLiabilities CurrentLiabilities
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.liabilities​.currentLiabilities​.accountsPayable decimal Expressed in millions of US dollars. Any money that a company owes its suppliers for goods and services purchased on credit and is expected to pay within the next year or operating cycle. Example: "36.4"
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.liabilities​.currentLiabilities​.shortTermDebt decimal All borrowings due within one year including current portions of long-term debt and capital leases as well as short-term debt such as bank loans and commercial paper
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.liabilities​.currentLiabilities​.otherCurrentLiabilities decimal Other obligations that are due within one year, includes tax payables
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.liabilities​.liabilitySummary LiabilitySummary
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.liabilities​.liabilitySummary​.totalCurrentLiabilities decimal The debts or obligations of the firm
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.liabilities​.liabilitySummary​.longTermDebt decimal Sum of the carrying values as of the balance sheet date of all long-term debt, which is debt initially having maturities due after one year or beyond the operating cycle, if longer, but excluding the portions thereof scheduled to be repaid within one year or the normal operating cycle, if longer. Long-term debt includes notes payable, bonds payable, mortgage loans, convertible debt, subordinated debt and other types of long term debt.
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.liabilities​.liabilitySummary​.otherNonCurrentLiabilities decimal Other obligations that are due after one year
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.liabilities​.liabilitySummary​.totalLiabilities decimal Probable future sacrifices of economic benefits arising from present obligations of an enterprise to transfer assets or provide services to others in the future as a result of past transactions or events.
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.shareholdersEquity ShareholdersEquity
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.shareholdersEquity​.equity Equity
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.shareholdersEquity​.equity​.preferredStockEquity decimal Preferred stock (all issues) at par value, as reported within the Shareholder's Equity section of the balance sheet.
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.shareholdersEquity​.equity​.commonStockEquity decimal Common stock (all issues) at par value (received in local currency (which can include USD) and convert it to USD, Euros, British Pounds, Canadian Dollars, Japanese Yen, or Swedish Kronor for use in our products. Stock prices are presented in actual values. Other financial amounts are typically presented in thousands, millions, or billions.), as reported within the Shareholder's Equity section of the balance sheet. This field is one component of Common Shareholder's Equity. Example: -743.9.
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.shareholdersEquity​.equitySummary EquitySummary
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.shareholdersEquity​.equitySummary​.totalEquity decimal Refers to the ratio of Current Debt and Long Term Debt to Common Equity
return​.quarterlyBalanceSheets​.previousQuarters​.previousQuarter[]​.shareholdersEquity​.equitySummary​.sharesOutstanding decimal The latest total shares outstanding reported by the company; the most common source of this information is from the cover of the 10K, 10Q, or 20F filing. This value is displayed in millions of shares.
return​.annualCashFlowStatements AnnualCashFlowStatements
return​.annualCashFlowStatements​.latestYear AnnualCashFlowStatement
return​.annualCashFlowStatements​.latestYear​.year string
return​.annualCashFlowStatements​.latestYear​.cashAndCashEquivalentsAtTheBeginningOfTheYear decimal Cash and cash equivalents for the current year in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash.
return​.annualCashFlowStatements​.latestYear​.netCashProvidedByOperatingActivities decimal Net operating cash flow, cash flow from operations in millions (USD)
return​.annualCashFlowStatements​.latestYear​.netCashProvidedByInvestingActivities decimal
return​.annualCashFlowStatements​.latestYear​.netCashProvidedByFinancingActivities decimal
return​.annualCashFlowStatements​.latestYear​.netIncreaseDecreaseInCashAndCashEquivalents decimal Net change in cash, increase or decrease in cash and cash equivalents from the beginning to the end of a statement period.
return​.annualCashFlowStatements​.latestYear​.cashAndCashEquivalentsAtTheEndOfTheYear decimal Cash and cash equivalents for the previous year in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash.
return​.annualCashFlowStatements​.latestYear​.capitalExpenditure decimal
return​.annualCashFlowStatements​.previousYears PreviousYearsCashFlowStatement
return​.annualCashFlowStatements​.previousYears​.previousYear Array of AnnualCashFlowStatement
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.year string
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.cashAndCashEquivalentsAtTheBeginningOfTheYear decimal Cash and cash equivalents for the current year in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash.
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.netCashProvidedByOperatingActivities decimal Net operating cash flow, cash flow from operations in millions (USD)
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.netCashProvidedByInvestingActivities decimal
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.netCashProvidedByFinancingActivities decimal
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.netIncreaseDecreaseInCashAndCashEquivalents decimal Net change in cash, increase or decrease in cash and cash equivalents from the beginning to the end of a statement period.
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.cashAndCashEquivalentsAtTheEndOfTheYear decimal Cash and cash equivalents for the previous year in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash.
return​.annualCashFlowStatements​.previousYears​.previousYear[]​.capitalExpenditure decimal
return​.quarterlyCashFlowStatements QuarterlyCashFlowStatements
return​.quarterlyCashFlowStatements​.latestQuarter QuarterlyCashFlowStatement
return​.quarterlyCashFlowStatements​.latestQuarter​.quarterMonth string The month of the quarterly data
return​.quarterlyCashFlowStatements​.latestQuarter​.quarterYear string The year of the quarterly data
return​.quarterlyCashFlowStatements​.latestQuarter​.cashAndCashEquivalentsAtTheBeginningOfTheQuarter decimal Cash and cash equivalents for the current quarter in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash. To find out when the beginning of the quarter is for an organization, refer to the co_financial_id which contains information about the period of time covered by the quarter. E.g. 15245000000000:FINL:1Q2012:201106 indicated that the quarter ending at the end of June 2011 (and thus starting at the first of April 2011) was the first quarter in the company's 2012 fiscal year.
return​.quarterlyCashFlowStatements​.latestQuarter​.netCashProvidedByOperatingActivities decimal Net operating cash flow, cash flow from operations in millions (USD)
return​.quarterlyCashFlowStatements​.latestQuarter​.netCashProvidedByInvestingActivities decimal
return​.quarterlyCashFlowStatements​.latestQuarter​.netCashProvidedByFinancingActivities decimal
return​.quarterlyCashFlowStatements​.latestQuarter​.netIncreaseDecreaseInCashAndCashEquivalents decimal Net change in cash, increase or decrease in cash and cash equivalents from the beginning to the end of a statement period.
return​.quarterlyCashFlowStatements​.latestQuarter​.cashAndCashEquivalentsAtTheEndOfTheQuarter decimal Cash and cash equivalents for the previous quarter in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash.
return​.quarterlyCashFlowStatements​.latestQuarter​.capitalExpenditure decimal
return​.quarterlyCashFlowStatements​.previousQuarters PreviousQuartersCashFlowStatement
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter Array of QuarterlyCashFlowStatement
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.quarterMonth string The month of the quarterly data
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.quarterYear string The year of the quarterly data
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.cashAndCashEquivalentsAtTheBeginningOfTheQuarter decimal Cash and cash equivalents for the current quarter in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash. To find out when the beginning of the quarter is for an organization, refer to the co_financial_id which contains information about the period of time covered by the quarter. E.g. 15245000000000:FINL:1Q2012:201106 indicated that the quarter ending at the end of June 2011 (and thus starting at the first of April 2011) was the first quarter in the company's 2012 fiscal year.
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.netCashProvidedByOperatingActivities decimal Net operating cash flow, cash flow from operations in millions (USD)
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.netCashProvidedByInvestingActivities decimal
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.netCashProvidedByFinancingActivities decimal
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.netIncreaseDecreaseInCashAndCashEquivalents decimal Net change in cash, increase or decrease in cash and cash equivalents from the beginning to the end of a statement period.
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.cashAndCashEquivalentsAtTheEndOfTheQuarter decimal Cash and cash equivalents for the previous quarter in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash.
return​.quarterlyCashFlowStatements​.previousQuarters​.previousQuarter[]​.capitalExpenditure decimal
return​.marketAnalysis MarketAnalysis
return​.marketAnalysis​.morningStar MorningStar
return​.marketAnalysis​.morningStar​.bullsSay string Bulls say of the company is a MorningStar financial report providing forecast for the most important arguments about the company in favor of owning its stock.
return​.marketAnalysis​.morningStar​.bearsSay string Bears say of the company is a MorningStar financial report providing forecast for the most important arguments about the company against owning its stock.

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyFinancialSummaryRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyFinancialSummaryRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

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

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyFinancialSummaryRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyFinancialSummaryRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:GetCompanyFinancialSummary" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

GetCompanyMarketData Available in Add-on: Advanced Financial Information

This call returns financial market data for a given company.

Request

Element Type Notes
uniqueId long Required Company ID or D-U-N-S Number

Response

Element Type Notes
return GetCompanyMarketDataResponseWrapper Required
return​.currentInformation CurrentInformation
return​.currentInformation​.lastCloseDate date The date of the last reported close price.
return​.currentInformation​.lastCloseAmount decimal The last reported close stock price.
return​.currentInformation​.fiftyTwoWeekHigh decimal The fifty two week stock price high
return​.currentInformation​.fiftyTwoWeekLow decimal The fifty two week stock price low
return​.currentInformation​.sixtyMonthBeta decimal The sixty month beta
return​.currentInformation​.marketCap decimal Market Cap (Capitalization) 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.
return​.currentInformation​.sharesOutstanding long The latest total shares outstanding reported by the company; the most common source of this information is from the cover of the 10K, 10Q, or 20F filing. This value is displayed in millions of shares.
return​.currentInformation​.dividendRate decimal The dividend rate for the company
return​.currentInformation​.dividendYield decimal The dividend yield for the company
return​.currentInformation​.numOfInstitutionalHolders long The number of institutions owning this companies stock
return​.currentInformation​.latestShortInterestRatio decimal The short interest ratio for this company
return​.currentInformation​.priceSalesRatio decimal Price to sales ratio
return​.currentInformation​.priceBookRatio decimal Price to book ratio
return​.currentInformation​.priceEarningsRatio decimal Price to earnings ratio
return​.currentInformation​.priceCashFlowRatio decimal Price to cash flow ratio
return​.currentInformation​.pctReturnOnAssets decimal Return on assets as a percentage. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.currentInformation​.pctReturnOnEquity decimal Return on equity as a percentage. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.currentInformation​.currentRatio decimal Current Ratio
return​.currentInformation​.longTermDebtToEquity decimal Long term debt to equity ratio for this company
return​.currentInformation​.pctOwnedByInstitutions decimal Percentage of the company stock owned by institutions. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.currentInformation​.latestNetInsiderTransactions long The amount of recent insider transactions
return​.growthRates GrowthRates
return​.growthRates​.twelveMonth GrowthRate
return​.growthRates​.twelveMonth​.pctRevenueGrowth decimal Percentage of revenue growth for 12, 36, and 60 months respectively. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthRates​.twelveMonth​.pctEpsGrowth decimal Percentage of EPS growth for 12, 36, and 60 months respectively. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthRates​.twelveMonth​.pctDividendGrowth decimal Percentage of dividend growth for 12, 36, and 60 months respectively. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthRates​.thirtySixMonth GrowthRate
return​.growthRates​.thirtySixMonth​.pctRevenueGrowth decimal Percentage of revenue growth for 12, 36, and 60 months respectively. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthRates​.thirtySixMonth​.pctEpsGrowth decimal Percentage of EPS growth for 12, 36, and 60 months respectively. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthRates​.thirtySixMonth​.pctDividendGrowth decimal Percentage of dividend growth for 12, 36, and 60 months respectively. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthRates​.sixtyMonth GrowthRate
return​.growthRates​.sixtyMonth​.pctRevenueGrowth decimal Percentage of revenue growth for 12, 36, and 60 months respectively. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthRates​.sixtyMonth​.pctEpsGrowth decimal Percentage of EPS growth for 12, 36, and 60 months respectively. Expressed as a whole number. To express 50%, for example, enter the input as '50'.
return​.growthRates​.sixtyMonth​.pctDividendGrowth decimal Percentage of dividend growth for 12, 36, and 60 months respectively. Expressed as a whole number. To express 50%, for example, enter the input as '50'.

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyMarketDataRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyMarketDataRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:GetCompanyMarketDataResponse>
         <sch:return>
            <sch:currentInformation>
               <sch:lastCloseDate>2012-10-05</sch:lastCloseDate>
               <sch:lastCloseAmount>82.95</sch:lastCloseAmount>
               <sch:fiftyTwoWeekHigh>86.52</sch:fiftyTwoWeekHigh>
               <sch:fiftyTwoWeekLow>60.43</sch:fiftyTwoWeekLow>
               <sch:sixtyMonthBeta>0.65</sch:sixtyMonthBeta>
               <sch:marketCap>3722.9619</sch:marketCap>
               <sch:sharesOutstanding>44882</sch:sharesOutstanding>
               <sch:dividendRate>1.52</sch:dividendRate>
               <sch:dividendYield>0.02</sch:dividendYield>
               <sch:numOfInstitutionalHolders xsi:nil="true"/>
               <sch:latestShortInterestRatio>6.47</sch:latestShortInterestRatio>
               <sch:priceSalesRatio>2.32</sch:priceSalesRatio>
               <sch:priceBookRatio>-4.51</sch:priceBookRatio>
               <sch:priceEarningsRatio>14.71</sch:priceEarningsRatio>
               <sch:priceCashFlowRatio>11.68</sch:priceCashFlowRatio>
               <sch:pctReturnOnAssets>15.26</sch:pctReturnOnAssets>
               <sch:pctReturnOnEquity xsi:nil="true"/>
               <sch:currentRatio>0.76</sch:currentRatio>
               <sch:longTermDebtToEquity xsi:nil="true"/>
               <sch:pctOwnedByInstitutions xsi:nil="true"/>
               <sch:latestNetInsiderTransactions xsi:nil="true"/>
            </sch:currentInformation>
            <sch:growthRates>
               <sch:twelveMonth>
                  <sch:pctRevenueGrowth>4.88</sch:pctRevenueGrowth>
                  <sch:pctEpsGrowth>6.02</sch:pctEpsGrowth>
                  <sch:pctDividendGrowth>2.86</sch:pctDividendGrowth>
               </sch:twelveMonth>
               <sch:thirtySixMonth>
                  <sch:pctRevenueGrowth>0.62</sch:pctRevenueGrowth>
                  <sch:pctEpsGrowth>-1.83</sch:pctEpsGrowth>
                  <sch:pctDividendGrowth>6.27</sch:pctDividendGrowth>
               </sch:thirtySixMonth>
               <sch:sixtyMonth>
                  <sch:pctRevenueGrowth>2.81</sch:pctRevenueGrowth>
                  <sch:pctEpsGrowth>7.37</sch:pctEpsGrowth>
                  <sch:pctDividendGrowth xsi:nil="true"/>
               </sch:sixtyMonth>
            </sch:growthRates>
         </sch:return>
      </sch:GetCompanyMarketDataResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyMarketDataRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyMarketDataRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:GetCompanyMarketData" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

GetCompanyNews Available in Add-on: News Information

Returns news items for a given DUNS number. This service requires a username and password in addition to the API-Key.

Request

Element Type Notes
uniqueId long Required Company ID or D-U-N-S Number
filter Array of string An optional category filter Available Values:
ExecutiveActivity
GeneralIndustry
ManagementChange
MergerAndAcquisition
NewProductOrAlliance
RegulationOrLitigation
WinsOrAwards
startDate date A date used to filter news items. Restricts to news items on or after the date
endDate date A date used to filter news items. Restricts to news items on or after the date.

Response

Element Type Notes
companyNews CompanyNews
companyNews​.duns string 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]*)".
companyNews​.name string The name of the company
companyNews​.newsItems NewsItems
companyNews​.newsItems​.newsItem Array of NewsItem
companyNews​.newsItems​.newsItem[]​.date string The timestamp for the news item
companyNews​.newsItems​.newsItem[]​.source string The publication source for the news item
companyNews​.newsItems​.newsItem[]​.category Array of string A broad-based category for the news item. Can appear multiple times (unbounded). Each company has a news/alerts section that states the following: "Choose the keyword groups that will be used to determine the types of alerts you receive in your daily e-mail digest." Those groups are as follows: Awards, Bankruptcy, Earnings Release, Executive Activity, executive announcement, Executive Quote, Expansion, Financial News, Funding, Management Change, Merger and Acquisition, New Alliance, New Product, Reduction, Restructure, Regulation or Litigation, Wins.
companyNews​.newsItems​.newsItem[]​.title string The title of the news item
companyNews​.newsItems​.newsItem[]​.text string The body of the news item
companyNews​.newsItems​.newsItem[]​.link string The link for the original news item

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyNewsRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyNewsRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:GetCompanyNewsResponse>
         <sch:companyNews>
            <sch:duns>884114609</sch:duns>
            <sch:name>Dun Bradstreet</sch:name>
            <sch:newsItems>
               <sch:newsItem>
                  <sch:date>Thu Oct 11 00:00:00 UTC 2...</sch:date>
                  <sch:source>Marketwire </sch:source>
                  <sch:category>Awards</sch:category>
                  <sch:category> New Product</sch:category>
                  ...
                  <sch:title>Millennium India Acquisit...</sch:title>
                  <sch:text>NEW YORK, NY--(Marketwire...</sch:text>
                  <sch:link>http://www.marketwire.com...</sch:link>
               </sch:newsItem>
               <sch:newsItem>
                  <sch:date>Fri Oct 05 00:00:00 UTC 2...</sch:date>
                  <sch:source>Website News</sch:source>
                  <sch:category>New Product</sch:category>
                  <sch:category> New Alliance</sch:category>
                  ...
                  <sch:title>D&amp;B Launches D&amp;B Alliance...</sch:title>
                  <sch:text/>
                  <sch:link>http://investor.dnb.com/r...</sch:link>
               </sch:newsItem>
               ...
               </sch:newsItems>
         </sch:companyNews>
      </sch:GetCompanyNewsResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetCompanyNewsRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetCompanyNewsRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:GetCompanyNews" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

GetFamilyTree 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.

Request

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

Response

Element Type Notes
return FamilyTreeResult
return​.number integer Hit number
return​.name string Company Name
return​.companyId long Company ID - Most likely this will be a DUNS number. However, there are Hoover's editorial ID's as another unique company ID (Example: 10483000000000). These company ID's may or may not have a corresponding DUNS number.
return​.duns string 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]*)".
return​.parentDuns string
return​.ultimateParentDuns string The ultimate parent company D-U-N-S Number for a family of companies
return​.revenue decimal Revenue in millions
return​.currencyType string Currency type of Revenue in one of the following USD (U.S. Dollar), CAD (Canadian Dollar), GBP (United Kingdom Pound), JPY (Japanese Yen), EUR (European Union Euro), or SEK (Swedish Krona). Available Values:
USD
GBP
CAD
EUR
JPY
SEK
return​.locationType string Company Location Type such as Single Location (0), Headquarters (1), Branch (2), Branch/Division (4), Subsidiary (5)
return​.city string City
return​.state string (1-30 characters) State
return​.country string Country
return​.additionalData FamilyTreeAdditionalData
return​.additionalData​.undeliverableAddress boolean Undeliverable address indicator
return​.additionalData​.outOfBusiness boolean Out of business indicator
return​.additionalData​.incompleteData boolean True if the company has incomplete data
return​.additionalData​.doNotMarketTo boolean True if the company is listed as do not market to.
return​.totalChildren integer Aggregate Total Number of Children for this unique ID
return​.children FamilyTreeChildren
return​.children​.child Array of FamilyTreeResult
return​.children​.child[]​.number integer Hit number
return​.children​.child[]​.name string Company Name
return​.children​.child[]​.companyId long Company ID - Most likely this will be a DUNS number. However, there are Hoover's editorial ID's as another unique company ID (Example: 10483000000000). These company ID's may or may not have a corresponding DUNS number.
return​.children​.child[]​.duns string 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]*)".
return​.children​.child[]​.parentDuns string
return​.children​.child[]​.ultimateParentDuns string The ultimate parent company D-U-N-S Number for a family of companies
return​.children​.child[]​.revenue decimal Revenue in millions
return​.children​.child[]​.currencyType string Currency type of Revenue in one of the following USD (U.S. Dollar), CAD (Canadian Dollar), GBP (United Kingdom Pound), JPY (Japanese Yen), EUR (European Union Euro), or SEK (Swedish Krona). Available Values:
USD
GBP
CAD
EUR
JPY
SEK
return​.children​.child[]​.locationType string Company Location Type such as Single Location (0), Headquarters (1), Branch (2), Branch/Division (4), Subsidiary (5)
return​.children​.child[]​.city string City
return​.children​.child[]​.state string (1-30 characters) State
return​.children​.child[]​.country string Country
return​.children​.child[]​.additionalData FamilyTreeAdditionalData
return​.children​.child[]​.additionalData​.undeliverableAddress boolean Undeliverable address indicator
return​.children​.child[]​.additionalData​.outOfBusiness boolean Out of business indicator
return​.children​.child[]​.additionalData​.incompleteData boolean True if the company has incomplete data
return​.children​.child[]​.additionalData​.doNotMarketTo boolean True if the company is listed as do not market to.
return​.children​.child[]​.totalChildren integer Aggregate Total Number of Children for this unique ID
return​.children​.child[]​.children FamilyTreeChildren
return​.children​.child[]​.children​.child Array of FamilyTreeResult
return​.children​.child[]​.children​.child[]​.number integer Hit number
return​.children​.child[]​.children​.child[]​.name string Company Name
return​.children​.child[]​.children​.child[]​.companyId long Company ID - Most likely this will be a DUNS number. However, there are Hoover's editorial ID's as another unique company ID (Example: 10483000000000). These company ID's may or may not have a corresponding DUNS number.
return​.children​.child[]​.children​.child[]​.duns string 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]*)".
return​.children​.child[]​.children​.child[]​.parentDuns string
return​.children​.child[]​.children​.child[]​.ultimateParentDuns string The ultimate parent company D-U-N-S Number for a family of companies
return​.children​.child[]​.children​.child[]​.revenue decimal Revenue in millions
return​.children​.child[]​.children​.child[]​.currencyType string Currency type of Revenue in one of the following USD (U.S. Dollar), CAD (Canadian Dollar), GBP (United Kingdom Pound), JPY (Japanese Yen), EUR (European Union Euro), or SEK (Swedish Krona). Available Values:
USD
GBP
CAD
EUR
JPY
SEK
return​.children​.child[]​.children​.child[]​.locationType string Company Location Type such as Single Location (0), Headquarters (1), Branch (2), Branch/Division (4), Subsidiary (5)
return​.children​.child[]​.children​.child[]​.city string City
return​.children​.child[]​.children​.child[]​.state string (1-30 characters) State
return​.children​.child[]​.children​.child[]​.country string Country
return​.children​.child[]​.children​.child[]​.additionalData FamilyTreeAdditionalData
return​.children​.child[]​.children​.child[]​.additionalData​.undeliverableAddress boolean Undeliverable address indicator
return​.children​.child[]​.children​.child[]​.additionalData​.outOfBusiness boolean Out of business indicator
return​.children​.child[]​.children​.child[]​.additionalData​.incompleteData boolean True if the company has incomplete data
return​.children​.child[]​.children​.child[]​.additionalData​.doNotMarketTo boolean True if the company is listed as do not market to.
return​.children​.child[]​.children​.child[]​.totalChildren integer Aggregate Total Number of Children for this unique ID
return​.children​.child[]​.children​.child[]​.children FamilyTreeChildren
return​.children​.child[]​.children​.child[]​.children​.child Array of FamilyTreeResult

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetFamilyTreeRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetFamilyTreeRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:GetFamilyTreeResponse>
         <sch:return>
            <sch:name>The Dun &amp; Bradstreet Corp...</sch:name>
            <sch:companyId>10483000000000</sch:companyId>
            <sch:duns>884114609</sch:duns>
            <sch:ultimateParentDuns>884114609</sch:ultimateParentDuns>
            <sch:parentDuns>884114609</sch:parentDuns>
            <sch:revenue>1758.50</sch:revenue>
            <sch:currencyType>USD</sch:currencyType>
            <sch:locationType>HEADQUARTERS</sch:locationType>
            <sch:city>Short Hills</sch:city>
            <sch:state>NJ</sch:state>
            <sch:country>United States</sch:country>
            <sch:additionalData>
               <sch:undeliverableAddress>false</sch:undeliverableAddress>
               <sch:outOfBusiness>false</sch:outOfBusiness>
               <sch:incompleteData>false</sch:incompleteData>
               <sch:doNotMarketTo>false</sch:doNotMarketTo>
            </sch:additionalData>
            <sch:totalChildren>84</sch:totalChildren>
            <sch:children>
               <sch:child>
                  <sch:number>1</sch:number>
                  <sch:name>Dun &amp; Bradstreet Internat...</sch:name>
                  <sch:companyId>49977515</sch:companyId>
                  <sch:duns>049977515</sch:duns>
                  <sch:ultimateParentDuns>884114609</sch:ultimateParentDuns>
                  <sch:parentDuns>884114609</sch:parentDuns>
                  <sch:revenue>110.50</sch:revenue>
                  <sch:currencyType>USD</sch:currencyType>
                  <sch:locationType>HEADQUARTERS</sch:locationType>
                  <sch:city>Short Hills</sch:city>
                  <sch:state>NJ</sch:state>
                  <sch:country>United States</sch:country>
                  <sch:additionalData>
                     <sch:undeliverableAddress>false</sch:undeliverableAddress>
                     <sch:outOfBusiness>false</sch:outOfBusiness>
                     <sch:incompleteData>false</sch:incompleteData>
                     <sch:doNotMarketTo>false</sch:doNotMarketTo>
                  </sch:additionalData>
                  <sch:children>
                     <sch:child>
                        <sch:number>2</sch:number>
                        <sch:name>DUN &amp; BRADSTREET INTERNAT...</sch:name>
                        <sch:companyId>657215901</sch:companyId>
                        <sch:duns>657215901</sch:duns>
                        <sch:ultimateParentDuns>884114609</sch:ultimateParentDuns>
                        <sch:parentDuns>049977515</sch:parentDuns>
                        <sch:revenue xsi:nil="true"/>
                        <sch:currencyType xsi:nil="true"/>
                        <sch:locationType>BRANCH</sch:locationType>
                        <sch:city>Taipei City</sch:city>
                        <sch:state>Taipei</sch:state>
                        <sch:country>Taiwan</sch:country>
                        <sch:additionalData>
                           <sch:undeliverableAddress>false</sch:undeliverableAddress>
                           <sch:outOfBusiness>false</sch:outOfBusiness>
                           <sch:incompleteData>false</sch:incompleteData>
                           <sch:doNotMarketTo>false</sch:doNotMarketTo>
                        </sch:additionalData>
                     </sch:child>
                     <sch:child>
                        <sch:number>3</sch:number>
                        <sch:name>D &amp; B HOLDINGS (UK)</sch:name>
                        <sch:companyId>220034438</sch:companyId>
                        <sch:duns>220034438</sch:duns>
                        <sch:ultimateParentDuns>884114609</sch:ultimateParentDuns>
                        <sch:parentDuns>049977515</sch:parentDuns>
                        <sch:revenue xsi:nil="true"/>
                        <sch:currencyType xsi:nil="true"/>
                        <sch:locationType>HEADQUARTERS</sch:locationType>
                        <sch:city>Marlow</sch:city>
                        <sch:state>Buckinghamshire</sch:state>
                        <sch:country>England</sch:country>
                        <sch:additionalData>
                           <sch:undeliverableAddress>false</sch:undeliverableAddress>
                           <sch:outOfBusiness>false</sch:outOfBusiness>
                           <sch:incompleteData>false</sch:incompleteData>
                           <sch:doNotMarketTo>false</sch:doNotMarketTo>
                        </sch:additionalData>
                        <sch:children>
                           <sch:child>
                              <sch:number>4</sch:number>
                              <sch:name>D &amp; B Group, Ltd.</sch:name>
                              <sch:companyId>19644983</sch:companyId>
                              <sch:duns>019644983</sch:duns>
                              <sch:ultimateParentDuns>884114609</sch:ultimateParentDuns>
                              <sch:parentDuns>220034438</sch:parentDuns>
                              <sch:revenue>0.33</sch:revenue>
                              <sch:currencyType>USD</sch:currencyType>
                              <sch:locationType>HEADQUARTERS</sch:locationType>
                              <sch:city>Short Hills</sch:city>
                              <sch:state>NJ</sch:state>
                              <sch:country>United States</sch:country>
                              <sch:additionalData>
                                 <sch:undeliverableAddress>false</sch:undeliverableAddress>
                                 <sch:outOfBusiness>false</sch:outOfBusiness>
                                 <sch:incompleteData>false</sch:incompleteData>
                                 <sch:doNotMarketTo>false</sch:doNotMarketTo>
                              </sch:additionalData>
                              <sch:children>
                                 <sch:child>
                                    <sch:number>5</sch:number>
                                    <sch:name>D &amp; B GROUP LTD</sch:name>
                                    <sch:companyId>291762474</sch:companyId>
                                    <sch:duns>291762474</sch:duns>
                                    <sch:ultimateParentDuns>884114609</sch:ultimateParentDuns>
                                    <sch:parentDuns>019644983</sch:parentDuns>
                                    <sch:revenue xsi:nil="true"/>
                                    <sch:currencyType xsi:nil="true"/>
                                    <sch:locationType>BRANCH</sch:locationType>
                                    <sch:city>Marlow</sch:city>
                                    <sch:state>Buckinghamshire</sch:state>
                                    <sch:country>England</sch:country>
                                    <sch:additionalData>
                                       <sch:undeliverableAddress>false</sch:undeliverableAddress>
                                       <sch:outOfBusiness>false</sch:outOfBusiness>
                                       <sch:incompleteData>false</sch:incompleteData>
                                       <sch:doNotMarketTo>false</sch:doNotMarketTo>
                                    </sch:additionalData>
                                 </sch:child>
                              </sch:children>
                           </sch:child>
                        </sch:children>
                     </sch:child>
                     ...
                     </sch:children>
               </sch:child>
               <sch:child>
                  <sch:number>38</sch:number>
                  <sch:name>Dun &amp; Bradstreet Ventures...</sch:name>
                  <sch:companyId>158134655</sch:companyId>
                  <sch:duns>158134655</sch:duns>
                  <sch:ultimateParentDuns>884114609</sch:ultimateParentDuns>
                  <sch:parentDuns>884114609</sch:parentDuns>
                  <sch:revenue>1.10</sch:revenue>
                  <sch:currencyType>USD</sch:currencyType>
                  <sch:locationType>SINGLE_LOCATION</sch:locationType>
                  <sch:city>Short Hills</sch:city>
                  <sch:state>NJ</sch:state>
                  <sch:country>United States</sch:country>
                  <sch:additionalData>
                     <sch:undeliverableAddress>false</sch:undeliverableAddress>
                     <sch:outOfBusiness>false</sch:outOfBusiness>
                     <sch:incompleteData>false</sch:incompleteData>
                     <sch:doNotMarketTo>false</sch:doNotMarketTo>
                  </sch:additionalData>
               </sch:child>
               ...
               </sch:children>
         </sch:return>
      </sch:GetFamilyTreeResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetFamilyTreeRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetFamilyTreeRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:GetFamilyTree" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

GetMarketAnalysisReport Included in Base Package

This call returns a Morningstar market analysis for the specified company. Please note not all companies have reports.

Request

Element Type Notes
uniqueId long Required Company ID or D-U-N-S Number

Response

Element Type Notes
message string (up to 1000 characters) Required Detailed message on success or failure of market analysis report retrieval. Success = "The market analysis report is attached." Failure = "The company does not have a report."
report base64Binary Required Base 64 encoded binary data of the PDF report

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetMarketAnalysisReportRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetMarketAnalysisReportRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:GetMarketAnalysisReportResponse>
         <sch:message>The market analysis repor...</sch:message>
         <sch:report>JVBERi0xLjYKJeTjz9IKNzkgM...</sch:report>
      </sch:GetMarketAnalysisReportResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:GetMarketAnalysisReportRequest>
         <ns0:uniqueId>884114609</ns0:uniqueId>
      </ns0:GetMarketAnalysisReportRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:GetMarketAnalysisReport" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

AdvancedPersonSearch Included in Base Package

Returns search result of people based on various criteria.

Request

Element Type Notes
bal Required
bal​.maxRecords integer Maximum records to retrieve (1-200).
bal​.hitOffset integer Zero-based offset used to indicate at what record to start returning results.
bal​.sortDirection string Sort direction types are Ascending or Descending Available Values:
Ascending
Descending
bal​.companySize CompanySize
bal​.companySize​.employeesFrom long Employees Lower Bound. The definition of employee depends on which part of the organization is referenced in the family tree.
bal​.companySize​.employeesTo long Employees Upper Bound. The definition of employee depends on which part of the organization is referenced in the family tree.
bal​.companySize​.employeesGrowthFrom double Total Employees Growth Percentage Lower Bound
bal​.companySize​.employeesGrowthTo double Total Employees Growth Percentage Upper Bound
bal​.companySize​.employeesThisLocationFrom long Employees at this Location Lower Bound
bal​.companySize​.employeesThisLocationTo long Employees at this Location Upper Bound
bal​.companySize​.marketCapFrom decimal 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.
bal​.companySize​.marketCapTo decimal 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.
bal​.companySize​.salesFrom decimal Annual Sales ($ mil) Lower Bound
bal​.companySize​.salesTo decimal Annual Sales ($ mil) Upper Bound
bal​.companySize​.salesGrowthFrom double Annual Sales Growth (%) Lower Bound
bal​.companySize​.salesGrowthTo double Annual Sales Growth (%) Upper Bound
bal​.companyType CompanyType 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.
bal​.companyType​.locationType Array of integer Company Location Type such as Single Location (0), Headquarters (1), Branch (2), Branch/Division (4), Subsidiary (5)
bal​.companyType​.ownershipType Array of integer 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).
bal​.companyType​.subsidiaryStatus Array of integer 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).
bal​.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.
bal​.financialData FinancialData
bal​.financialData​.advertisingExpenseFrom decimal Advertising Expense (expressed in millions of US Dollars) Lower Bound
bal​.financialData​.advertisingExpenseTo decimal Advertising Expense (expressed in millions of US Dollars) Upper Bound
bal​.financialData​.assetsFrom decimal Assets (expressed in millions of US Dollars) Lower Bound
bal​.financialData​.assetsTo decimal Assets (expressed in millions of US Dollars) Upper Bound
bal​.financialData​.filingDateFrom date Filing Date Lower Bound
bal​.financialData​.filingDateTo date Filing Date Upper Bound
bal​.financialData​.fiscalYearEnd Array of long The month the fiscal year ends. Not all financial fiscal year ranges end in December, for example.
bal​.financialData​.incomeFrom decimal Net Income (expressed in millions of US Dollars) Lower Bound
bal​.financialData​.incomeGrowthFrom double Net Income Growth (%) Lower Bound
bal​.financialData​.incomeGrowthTo double Net Income Growth (%) Upper Bound
bal​.financialData​.incomeTo decimal Net Income (expressed in millions of US Dollars) Upper Bound
bal​.financialData​.offerFrom decimal US IPO Data - Offer Amount (expressed in milions of USD) Lower Bound
bal​.financialData​.offerTo decimal US IPO Data - Offer Amount (expressed in milions of USD) Upper Bound
bal​.financialData​.priceRangeFrom decimal US IPO Data - Price Range ($) Lower Bound
bal​.financialData​.priceRangeTo decimal US IPO Data - Price Range ($) Upper Bound
bal​.financialData​.researchExpenseFrom decimal R&D Expense ($ mil) Lower Bound
bal​.financialData​.researchExpenseTo decimal R&D Expense ($ mil) Upper Bound
bal​.financialData​.tradingDateFrom date Trading Date Lower Bound
bal​.financialData​.tradingDateTo date Trading Date Upper Bound
bal​.financialData​.underwriterId Array of long 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.
bal​.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
bal​.industry Industry
bal​.industry​.dnbIndustryCode Array of integer D&B Industry Code
bal​.industry​.primaryOnly boolean Restricts the search to only the primary company industry
bal​.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.
bal​.industry​.nAICSRange Array of StringRange
bal​.industry​.nAICSRange[]​.from string NAICS Code Range Lower Bound
bal​.industry​.nAICSRange[]​.to string NAICS Code Range Upper Bound
bal​.industry​.uSSIC Array of string US SIC Code: "SIC" (Standard Industrial Classification) is an industry code system developed by the US Government.
bal​.industry​.uSSICRange Array of StringRange
bal​.industry​.uSSICRange[]​.from string SIC Code Range Lower Bound
bal​.industry​.uSSICRange[]​.to string SIC Code Range Upper Bound
bal​.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.
bal​.industry​.uKSICRange Array of StringRange
bal​.industry​.uKSICRange[]​.from string UKSIC Code Range Lower Bound
bal​.industry​.uKSICRange[]​.to string UKSIC Code Range Upper Bound
bal​.location CompanyLocation Type of location for the company; headquarters, branch office, etc.
bal​.location​.areaCode Array of string US or Canadian Phone Number Area Code
bal​.location​.streetAddress Array of string Street Address
bal​.location​.county Array of County Company County
bal​.location​.county[]​.countyId string County ID
bal​.location​.county[]​.state string State
bal​.location​.county[]​.countryId long Country ID - D&B-assigned code which identifies the country where the business is located.
bal​.location​.city Array of string City
bal​.location​.countryId Array of long Country ID - D&B-assigned code which identifies the country where the business is located.
bal​.location​.globalState Array of string Global State/Province
bal​.location​.metropolitanId Array of long US Metropolitan Area
bal​.location​.regionId Array of long D&B world region code which identifies the region where the business is located.
bal​.location​.usStateCanadaProvince Array of string US State/Canada Province
bal​.location​.postalCode Array of string Postal Code
bal​.location​.usZipCodeRange Array of Range
bal​.location​.usZipCodeRange[]​.from long US ZIP Code Range Lower Bound
bal​.location​.usZipCodeRange[]​.to long US ZIP Code Range Upper Bound
bal​.location​.zipAreaSearch ZipAreaSearch
bal​.location​.zipAreaSearch​.scale string Units to search in: miles or kilometers Available Values:
miles
kilometers
bal​.location​.zipAreaSearch​.radius double Number of miles or kilometers to search within
bal​.location​.zipAreaSearch​.zipCode string Zipcode to search within (78745 in the example)
bal​.location​.latLongSearch LatLongSearch
bal​.location​.latLongSearch​.scale string Units to search in: miles or kilometers Available Values:
miles
kilometers
bal​.location​.latLongSearch​.radius double Number of miles or kilometers to search within
bal​.location​.latLongSearch​.latitude double
bal​.location​.latLongSearch​.longitude double Longitude component of geo location
bal​.location​.allAny string Denotes whether all or any company location criteria are matched Available Values:
all
any
bal​.location​.ukCounty Array of string UK County name
bal​.specialtyCriteria SpecialtyCriteria
bal​.specialtyCriteria​.auditorId Array of long Obtain the Auditors ID value from the GetAdvancedSearchLookups call. Example: 'id' 1551 corresponds to PricewaterhouseCoopers AB
bal​.specialtyCriteria​.companyKeyword string Company Keyword
bal​.specialtyCriteria​.duns Array of long 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]*)".
bal​.specialtyCriteria​.dunsFrom long D-U-N-S Number lower limit
bal​.specialtyCriteria​.dunsTo long D-U-N-S Number upper limit
bal​.specialtyCriteria​.exchangeId Array of long The ID associated with the exchange where the company's stock is traded.
bal​.specialtyCriteria​.rankingId Array of long Ranking ID
bal​.specialtyCriteria​.ukRegistration Array of string UK Registration Number. Unique identifier assigned to UK companies by the government's Companies House. Example: 3443456
bal​.specialtyCriteria​.ukVat Array of string United Kingdom's Value Added Tax Number. Example: 906565610
bal​.specialtyCriteria​.yearFoundingFrom long Year of Founding or Change in Control Lower Bound
bal​.specialtyCriteria​.yearFoundingTo long Year of Founding or Change in Control (YYYY) Upper Bound
bal​.specialtyCriteria​.ultimateParentDuns Array of long The ultimate parent company D-U-N-S Number for a family of companies
bal​.specialtyCriteria​.primaryUrl Array of string Primary URL for the company
bal​.specialtyCriteria​.companyName string Company Name
bal​.specialtyCriteria​.stockTicker Array of string Stock Ticker
bal​.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.
bal​.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.
bal​.specialtyCriteria​.squareFootageFrom long Company square foot range from
bal​.specialtyCriteria​.squareFootageTo long Company square foot range to
bal​.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
bal​.specialtyCriteria​.legalStatus Array of string Legal Status of the company Available Values:
Corporation
Partnership
Proprietorship
NationalGovernmentEntity
RegionalLocalGovernmentEntity
JointVenture
NonProfitOrganization
CooperativeMutualOrganization
ForeignCompany
bal​.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
bal​.specialtyCriteria​.importer boolean Importer flag which identifies whether or not a company imports for re-manufacture or sale
bal​.specialtyCriteria​.exporter boolean Exporter flag which identifies whether or not a company exports products to other countries.
bal​.orderBy string Order by orderByTypes: CompanyName, CompanyType, CountryName, CityName, StateName, PhoneNumber, FaxNumber, SalesGrowth12Mon, TotalAssets, SalesUS, EmployeesTotal, EmployeesHere, FiscalYearEndMonth, MarketCap, NetIncomeGrowth12Mon, EmployeeGrowth12Mon, ROE, ROA, EarningsComparison, BookValueComparison, NetIncome, PersonFirstName, PersonLastName, PersonTitle Available Values:
CompanyName
CompanyType
CountryName
CityName
StateName
PhoneNumber
FaxNumber
SalesGrowth12Mon
TotalAssets
SalesUS
EmployeesTotal
EmployeesHere
FiscalYearEndMonth
MarketCap
NetIncomeGrowth12Mon
EmployeeGrowth12Mon
ROE
ROA
EarningsComparison
BookValueComparison
NetIncome
PersonFirstName
PersonLastName
PersonTitle
bal​.people People
bal​.people​.lastName Array of string Person Last Name
bal​.people​.firstName Array of string Person First Name
bal​.people​.ageFrom integer Person Age Lower Bound
bal​.people​.ageTo integer Person Age Upper Bound
bal​.people​.bonusFrom decimal Person Bonus ($) Lower Bound
bal​.people​.bonusTo decimal Person Bonus ($) Upper Bound
bal​.people​.salaryFrom decimal Person Salary ($) Lower Bound
bal​.people​.salaryTo decimal Person Salary ($) Upper Bound
bal​.people​.totalPayFrom decimal Person Total Pay ($) Lower Bound
bal​.people​.totalPayTo decimal Person Total Pay ($) Upper Bound
bal​.people​.jobFunctionId Array of integer Identifies a job function that may be independent of job title. Management Responsibility Code (MRC) identifies the title of the principal or manager for the subject.
bal​.people​.keywordsIn Array of string Keywords In. When relating to PeopleKeywordsInType, the enumeration values are "title" and "bio" strings. Available Values:
title
bio
bal​.people​.keywordSelect string Person Keyword

Response

Element Type Notes
return PersonResponseWrapper
return​.people PersonSearchResultSet
return​.people​.firstHit integer First Hit
return​.people​.hits integer The total number of hits in this response.
return​.people​.lastHit integer 1-based last hit number
return​.people​.totalHits integer
return​.people​.hit Array of PersonSearchResultHit
return​.people​.hit[]​.hitNumber integer The hit number indicates the result number in the search.
return​.people​.hit[]​.coOfficialResults CoOfficialResultFields
return​.people​.hit[]​.coOfficialResults​.companyId long Company ID - Most likely this will be a DUNS number. However, there are Hoover's editorial ID's as another unique company ID (Example: 10483000000000). These company ID's may or may not have a corresponding DUNS number.
return​.people​.hit[]​.coOfficialResults​.duns string 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]*)".
return​.people​.hit[]​.coOfficialResults​.companyName string Company Name
return​.people​.hit[]​.coOfficialResults​.nonMarketableCompany NonMarketableReasons Non-marketable company reason such as 'Invalid address', 'Out of business', 'Key data missing/needing revision', 'Requested no marketing contact'
return​.people​.hit[]​.coOfficialResults​.nonMarketableCompany​.reason Array of string Reason for non-marketable status; Non-marketable company reasons: 'Invalid address', 'Out of business', 'Key data missing/needing revision', 'Requested no marketing contact' Available Values:
Invalid address
Out of business
Key data missing/needing revision
Requested no marketing contact
return​.people​.hit[]​.coOfficialResults​.coOfficialId long Company's official ID that is 7 - 16 digits long. This element differs from the unique company ID (which is the DUNS number or company ID).
return​.people​.hit[]​.coOfficialResults​.fullName string Person Full Name
return​.people​.hit[]​.coOfficialResults​.firstName string Person First Name
return​.people​.hit[]​.coOfficialResults​.lastName string Person Last Name
return​.people​.hit[]​.coOfficialResults​.middleName string Person Middle Name
return​.people​.hit[]​.coOfficialResults​.suffix string Person Suffix
return​.people​.hit[]​.coOfficialResults​.title string Person Title
return​.people​.hit[]​.coOfficialResults​.connectMail ConnectMail Wrapper element for ConnectMail indicators
return​.people​.hit[]​.coOfficialResults​.connectMail​.connectMailNameSource boolean
return​.people​.hit[]​.coOfficialResults​.connectMail​.connectMailEmailSource boolean Indicates if official's email address is a ConnectMail contact
return​.people​.hit[]​.coOfficialResults​.connectMail​.connectMailPhoneSource boolean Indicates if official's phone number is a ConnectMail contact
return​.people​.hit[]​.coOfficialResults​.connectMail​.connectMailSource string Source of the primary contact. If it's true, then the primary contact's source is "ConnectMail". So, in order to view the primary contact, you should have purchased the contact. If connectMailNameSource is false, then the primary contact's name will be available to you by default.

Sample Request XML

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:AdvancedPersonSearchRequest>
         <ns0:bal>
            <ns0:maxRecords>10</ns0:maxRecords>
            <ns0:hitOffset>0</ns0:hitOffset>
            <ns0:sortDirection>Ascending</ns0:sortDirection>
            <ns0:companyType>
               <ns0:locationType>1</ns0:locationType>
            </ns0:companyType>
            <ns0:financialData>
               <ns0:assetsFrom>1</ns0:assetsFrom>
            </ns0:financialData>
            <ns0:location>
               <ns0:countryId>76</ns0:countryId>
            </ns0:location>
            <ns0:specialtyCriteria>
               <ns0:legalStatus>Corporation</ns0:legalStatus>
            </ns0:specialtyCriteria>
            <ns0:orderBy>SalesUS</ns0:orderBy>
            <ns0:people>
               <ns0:lastName>Mathew</ns0:lastName>
               <ns0:firstName>Sara</ns0:firstName>
               <ns0:keywordsIn>title</ns0:keywordsIn>
               <ns0:keywordsIn>bio</ns0:keywordsIn>
               <ns0:keywordSelect>CEO</ns0:keywordSelect>
            </ns0:people>
         </ns0:bal>
      </ns0:AdvancedPersonSearchRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>

Sample Response XML

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope>
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:AdvancedPersonSearchResponse>
         <sch:return>
            <sch:people>
               <sch:firstHit>1</sch:firstHit>
               <sch:hits>1</sch:hits>
               <sch:lastHit>1</sch:lastHit>
               <sch:totalHits>1</sch:totalHits>
               <sch:hit>
                  <sch:hitNumber>1</sch:hitNumber>
                  <sch:coOfficialResults>
                     <sch:companyId>10483000000000</sch:companyId>
                     <sch:duns>884114609</sch:duns>
                     <sch:companyName>The Dun &amp; Bradstreet Corp...</sch:companyName>
                     <sch:coOfficialId>1073021000000000</sch:coOfficialId>
                     <sch:fullName>Sara S. Mathew</sch:fullName>
                     <sch:firstName>Sara</sch:firstName>
                     <sch:lastName>Mathew</sch:lastName>
                     <sch:middleName>S.</sch:middleName>
                     <sch:suffix/>
                     <sch:title>Chairman and CEO</sch:title>
                     <sch:connectMail>
                        <sch:connectMailNameSource>false</sch:connectMailNameSource>
                        <sch:connectMailEmailSource>true</sch:connectMailEmailSource>
                        <sch:connectMailPhoneSource>false</sch:connectMailPhoneSource>
                        <sch:connectMailSource>D&amp;B</sch:connectMailSource>
                     </sch:connectMail>
                  </sch:coOfficialResults>
               </sch:hit>
            </sch:people>
         </sch:return>
      </sch:AdvancedPersonSearchResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CURL Example

curl -d '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:ns0="http://applications.dnb.com/webservice/schema/" xmlns:ns1="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://applications.dnb.com/webservice/schema/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <sch:API-KEY><!-- your API-KEY --></sch:API-KEY>
      <sch:username><!-- your username --></sch:username>
      <sch:password><!-- your password --></sch:password>
   </SOAP-ENV:Header>
   <ns1:Body>
      <ns0:AdvancedPersonSearchRequest>
         <ns0:bal>
            <ns0:maxRecords>10</ns0:maxRecords>
            <ns0:hitOffset>0</ns0:hitOffset>
            <ns0:sortDirection>Ascending</ns0:sortDirection>
            <ns0:companyType>
               <ns0:locationType>1</ns0:locationType>
            </ns0:companyType>
            <ns0:financialData>
               <ns0:assetsFrom>1</ns0:assetsFrom>
            </ns0:financialData>
            <ns0:location>
               <ns0:countryId>76</ns0:countryId>
            </ns0:location>
            <ns0:specialtyCriteria>
               <ns0:legalStatus>Corporation</ns0:legalStatus>
            </ns0:specialtyCriteria>
            <ns0:orderBy>SalesUS</ns0:orderBy>
            <ns0:people>
               <ns0:lastName>Mathew</ns0:lastName>
               <ns0:firstName>Sara</ns0:firstName>
               <ns0:keywordsIn>title</ns0:keywordsIn>
               <ns0:keywordsIn>bio</ns0:keywordsIn>
               <ns0:keywordSelect>CEO</ns0:keywordSelect>
            </ns0:people>
         </ns0:bal>
      </ns0:AdvancedPersonSearchRequest>
   </ns1:Body>
</SOAP-ENV:Envelope>' -H "SOAPAction: sch:AdvancedPersonSearch" -H "Content-Type: text/xml" -i 'http://dnbdirect-api.dnb.com/DnBAPI-10'

FindPersonByKeyword Included in Base Package

Returns search result of people based on keyword. The keyword may be a person's name or part of a name.

Request

Element Type Notes
maxRecords integer Maximum records to retrieve (1-200).
hitOffset integer Zero-based offset used to indicate at what record to start returning results.
sortDirection string Sort direction types are Ascending or Descending Available Values:
Ascending
Descending
keyword string Required Keyword or phrase
dunsFrom long D-U-N-S Number lower limit
dunsTo long D-U-N-S Number upper limit
nonMarketableCompanyFilterOptions NonMarketableFilterOptions
nonMarketableCompanyFilterOptions​.includeUndeliverableAddress boolean If true, will return all the unmarketable company records which have undeliverable addresses.
nonMarketableCompanyFilterOptions​.includeOutOfBusiness boolean If true, will return all the unmarketable company records that are out of business.
nonMarketableCompanyFilterOptions​.includeIncompleteData boolean If true, will return all the unmarketable company records which have incomplete data.
orderBy string Order by orderByTypes: CompanyName, CompanyType, CountryName, CityName, StateName, PhoneNumber, FaxNumber, SalesGrowth12Mon, TotalAssets, SalesUS, EmployeesTotal, EmployeesHere, FiscalYearEndMonth, MarketCap, NetIncomeGrowth12Mon, EmployeeGrowth12Mon, ROE, ROA, EarningsComparison, BookValueComparison, NetIncome, PersonFirstName, PersonLastName, PersonTitle Available Values:
CompanyName
CompanyType
CountryName
CityName
StateName
PhoneNumber
FaxNumber
SalesGrowth12Mon
TotalAssets
SalesUS
EmployeesTotal
EmployeesHere
FiscalYearEndMonth
MarketCap
NetIncomeGrowth12Mon
EmployeeGrowth12Mon
ROE
ROA
EarningsComparison
BookValueComparison
NetIncome
PersonFirstName
PersonLastName
PersonTitle
returnSearchNavigation boolean If set to true, navigators will be returned in the response which can be used to enable drill down into search results for additional refinement. Navigators are additional criteria available for a set of results.
searchNavigation PersonSearchNavigation
searchNavigation​.jobFunctionSearchNavigation JobFunctionSearchNavigation
searchNavigation​.jobFunctionSearchNavigation​.jobFunctionSearchNavigationValue Array of string A job function navigation link that can be fed back into other calls.
searchNavigation​.locationSearchNavigation LocationSearchNavigation
searchNavigation​.locationSearchNavigation​.countryNavigation Array of CountryNavigation
searchNavigation​.locationSearchNavigation​.countryNavigation[]​.countryNavigationValue string A country navigation link that can be fed back into other calls.
searchNavigation​.locationSearchNavigation​.countryNavigation[]​.stateNavigation Array of StateNavigation
searchNavigation​.locationSearchNavigation​.countryNavigation[]&