Loading

Direct 2.0
Collapse

Search & Build-a-List - Company

Also known as Locating Companies

ProductD&B Direct 2.0, D&B Direct Onboard
Product Code(s)Not Applicable
Options(s)Basic, Advanced
Monitoring AvailableNo
InterfaceREST
MethodGET
Format(s)JSON
ServiceEntityList
{version}6.4
6.4 Released OnOctober 6, 2017

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

Update History

  • October 6, 2017 (v6.4 SOAP & REST): Version 6.4 is now available for Entity List service.
  • January 29, 2016 (v6.2 SOAP & REST): The response elements PrimaryAddress LatitudeMeasurement and PrimaryAddress LongitudeMeasurement are added to Find Company response. The UnitofSize attribute is added to Sales Revenue Amount response for Find Competitor.
  • December 12, 2014 (v6.1 SOAP & REST): Changes to the FindContact and Find Company operations include: 1. Added the following enumerations to InclusionDataEnum – IncludeNonMarketable, IncludeDelisted; and 2. Added the following enumerations to SortBasisText - Relevancy.
  • October 25, 2013 (v6.0 SOAP & REST): The following changes apply: IndustryTypeCode has been changed from a free-form text field to an enumerated type; Multiple postal code ranges may now be specified on requests; MarketingRiskClassCode may now include a value of 0 indicating "unknown"; InclusionDataDescription may now include a value of "IncludeNonMarketableOnly"; Three new filters provide the ability to screen on publicly traded companies, descendants of publicly traded companies, and organizations having a manufacturing facility; Added a new sort criteria: ConsolidatedEmployeeQuantity. This field is also included on the response; and Two new search facets that correspond to the publicly traded company filters.

Feature Request

IMPORTANT: Please see the new Online Services Security Enhancement Release, effective December 14, 2018.

Overview

There are several options available when implementing this feature.

1. Keyword Search (Basic/Advanced): An organization keyword is required in addition to setting the search mode to 'Basic'. The organization keyword (KeywordText) will be compared against any company names (past, present, synonyms and tradestyles) and stock ticker symbols. An option exists (in Advanced search) to limit the search comparison to specific fields.

Keyword search criteria are NOT case sensitive (i.e. "SAMPLE", "Sample" and "sample" will return the same results). Multiple keywords may be specified in either keyword criteria field, separated by spaces.

This feature supports a wild card pattern in the keyword search criteria, which allows an asterisk to be appended to, embedded in, or placed at the start of the keyword parameter.

The optional D&B D-U-N-S Number range may be provided when compiling lists in excess of 10,000 results.

2. Inclusion Rules (Basic/Advanced): By default, organizations with certain operating conditions will be excluded from the results. An option is available to include the following: undeliverable address records, out of business records, incomplete data records, and only non-marketable* businesses.

*In general, a record that meets the following criteria is considered marketable: it has been updated within the last 24 months; it contains a complete business name, valid physical or mailing address, and valid Standard Industry Classification Code; and it is believed to be in business.

NOTE: This rule does not exclude/include de-listed companies (i.e., a company that has requested to be excluded from direct marketing use cases).

3. Sorting Results (Basic/Advanced): By default, the results from this service will be in descending order by Annual Sales, unless specified differently in the request. Both the sort direction and a primary sort field can be designated in the request.

4. Pagination (Basic/Advanced): Options exist to designate the maximum number of records per request, and the starting row number. The maximum number of records this feature will return on a single request is 10,000. The default page length is 25 records.

The remaining options are available only in the advanced version (search mode set to 'Advanced') of this feature.

5. Geographic Proximity (Advanced only): Any combination of longitude+latitude coordinates or postal code, telephone number (full or partial) or street address may be passed to produce a list of matching organizations. By default the criteria provided will be applied using "AND" logic, however, an option is available to alternatively apply "OR" logic to the request.

When performing a search using longitude+latitude, a radius and scale (miles or kilometers) must be supplied. This option is only available when the country code specified is "US" or "CA".

When a postal code is provided, a country code must also be specified.

When providing a U.S. postal code as a criteria, leading zeros are required in the request. For example, "01234" is correct, while "1234" is not correct.

If a postal code is provided, this service will identify the longitude+latitude coordinates for the central point of the respective geographical area. This option is only applicable when the country code specified is "US".

When providing a telephone number as a criteria, exclude any non-numeric characters and spaces. (e.g. "(800) 555-1212" should be supplied as "8005551212")

6. Company Information (Advanced only): Filter for companies by location type, D&B Prescreen Score, ownership type, stock ticker and exchange, D-U-N-S Number, legal status, year of founding, subsidiary status, diversity status (minority owned, women owned and ethnicity classification), occupancy status (owns/rents), franchise status and foreign trade.

7. Industry (Advanced only): Filter for companies by Hoover's Industries, SIC Codes, and NAIC Codes, either by a specific industry code or range. An option exists to search only on an organization's primary industry code.

8. Company Size (Advanced only): Filter for companies by sales, market cap, employees and facility size.

9. Financial Information (Advanced only): filter for companies by net income, assets, fiscal year end, auditors, and rankings/indices.

10. IPO Data (Advanced only): Filter for companies by IPO date, offer amount, price range and underwriters.

Minimum Requirements

The details in this section override the Optional/Required values listed in the Request Specification table.

  1. The field SearchModeDescription must be set to a value of Basic or Advanced for this feature to work properly (for this use case).
  2. When performing a search using longitude+latitude, a radius measurement and unit code (3353 for miles or 3349 for kilometers) must be supplied.

Data Layer Entitlement

For customers in U.S. and Canadian markets, the API is provisioned for specific collections of products, reports, and/or features (collectively referred to as data layers) for production and trial usage. Entitlement is not required for testing in the sandbox environment.

  • The BASIC feature is entitled as "Search/Lookup for Companies" for D&B Direct 2.0 customers.
  • The ADVANCED feature is entitled as "Detailed Search & Build-a-List - Company/Industry" for D&B Direct 2.0 customers.

For customers in the UK, Ireland, Belgium, Netherlands and Luxembourg markets, the API is provisioned as a specific set of data layers for production, trial, and sandbox usage.

  • This particular data layer is included in the D&B Direct Onboard 2.0 suite.

Specification

The D&B Direct 2.0 API supports HTTP compression. To utilize this option, add the following line to the header of your request: Accept-Encoding: gzip,deflate

Sample Request (Basic)
GET https://direct.dnb.com/V6.4/organizations?KeywordText=Gorman%20Manufacturing&SearchModeDescription=Basic&findcompany=true&InclusionDataDescription=IncludeNonMarketable
Authorization: <My Token>
Sample Request (Advanced)
GET https://direct.dnb.com/V6.4/organizations?KeywordText=Gorman%20Manufacturing&SearchModeDescription=Advanced&findcompany=true&InclusionDataDescription=IncludeNonMarketable
Authorization: <MyToken>

Input parameters that include a "-n" designation may be repeated on the request, using a sequence number. For example, for the parameter "example-n", create a request like https://{endpoint}?{other parameters}&example-1={value}&example-2={value} and so on. If a single instance of the parameter is used, it still requires a "-1" suffix.

Basic Advanced Name Characteristics
Y Y ApplicationTransactionID string, up to 64 chars, Optional

A number assigned by the calling application to uniquely identify this request.

Y Y TransactionTimestamp dateTime, Optional

The date and time when this request was created. When the request is from an intermediary, such as a workflow manager or service bus, this is the date and time when the message was sent to the D&B function, i.e., the date and time when the xml document was created by the requesting intermediary.

Y Y SubmittingOfficeID string, up to 64 chars, Optional

A number that identifies the system or the software application from where this request originated. / A number used to uniquely identfy the D&B business segment or delivery channel from where this request originated.

N Y DUNSNumber-n (Can repeat up to 10 times) string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional

The numeric value assigned by Dun & Bradstreet to uniquely identify the contact organization .This subject identifier under the Data Universal Numbering System. This is a numeric which is always 9 digits; the leading digit or digits may be zero.

N Y OrganizationName OrganizationNameSimpleType up to 240 chars, Optional
N Y WebPageAddress-n (Can repeat up to 10 times) string, up to 240 chars, Optional
N Y StreetAddressLine-n (Can repeat up to 10 times) string, up to 240 chars, Optional
N Y PrimaryTownName-n (Can repeat up to 10 times) PrimaryTownNameType up to 240 chars, Optional
N Y MetropolitanStatisticalAreaUSCensusCode-n (Can repeat up to 10 times) string, up to 16 chars, Optional
N Y CountyGEOREFID-n (Can repeat up to 10 times) string, up to 13 chars, Optional
N Y TerritoryName-n (Can repeat up to 10 times) TerritoryNameType up to 64 chars, Optional
N Y PostalCode-n (Can repeat up to 10 times) string, up to 16 chars, Optional
N Y PostalCodeLowRangeValue-n string, up to 16 chars, Optional

The lower limit of a range for the identifier used by the local country Postal Authority to identify a particular geographic location. For example, in Belgium, Postal Code 9000 identifies the town of GHENT.

N Y PostalCodeHighRangeValue-n string, up to 16 chars, Optional

The upper limit of a range for the identifier used by the local country Postal Authority to identify a particular geographic location. For example, in Belgium, Postal Code 9000 identifies the town of GHENT.

N Y CountryISOAlpha2Code-n (Can repeat up to 10 times) string, at least 2 chars, up to 2 chars, Optional
N Y CountryGroupGEOREFID-n (Can repeat up to 10 times) string, up to 16 chars, Optional
N Y RadiusSearchPostalCode string, up to 32 chars, Optional
N Y RadiusSearchCountryISOAlpha2Code string, at least 2 chars, up to 2 chars, Optional
N Y RadiusMeasurement decimal, up to 5 digits, maximum of 2 decimal places, Optional
N Y RadiusMeasurementUnitCode integer, up to 7 digits, Optional

Possible values: 3353 [miles]; 3349 [kilometre]

N Y RadiusSearchLatitudeMeasurement LatitudeMeasurementType up to 9 digits, maximum of 6 decimal places, Optional
N Y RadiusSearchLongitudeMeasurement LongitudeMeasurementType up to 10 digits, maximum of 6 decimal places, Optional
N Y TelephoneNumberAreaCode-n string, at least 1 char, up to 16 chars, Required
N Y FamilyTreeMemberRoleCode-n (can repeat up to 4 times) integer, up to 7 digits, Optional

Possible values: 9141 [Parent/Headquarters] - for Parent; HQ or Parent & HQ; 12769 [Branch] - for Branch or Division; 9159 [Subsidiary]

N Y StandaloneOrganizationIndicator StandaloneOrganizationIndicatorType, Optional
N Y IndustryCodeTypeCode

Possible values: 3599 -USSIC; 19295 - UKSIC; 700 - NAICS; 25838 - DnB Industry Code

N Y IndustryCode-n string, up to 16 chars, Optional

Full or partial industry code. For full industry codes, exact matches will be returned. For partial industry codes, matching candidates that begin with the partial code will be returned.

N Y IndustryCodeLowRangeValue string, up to 16 chars, Optional
N Y IndustryCodeHighRangeValue string, up to 16 chars, Optional
N Y PrimaryIndustryCodeOnlyIndicator boolean, Optional
N Y LegalFormCode-n (can repeat up to 10 times) integer, up to 7 digits, Optional

Possible values: 451 (Corporation); 452 (Partnership); 453 (Proprietorship); 454 (NationalGovernmentEntity); 455 (RegionalLocalGovernmentEntity); 456 (JointVenture); 457 (NonProfitOrganization); 461 (CooperativeMutualOrganization); 469 (ForeignCompany)

N Y ControlOwnershipTypeCode-n (can repeat up to 10 times) integer, up to 7 digits, Optional

Possible values: 9057 [Publicly owned]; 9058 [Privately owned]; 9059 [State owned]

N Y ControlOwnershipFromYear integer, Optional
N Y ControlOwnershipToYear integer, Optional
N Y OrganizationStartFromYear integer, Optional
N Y OrganizationStartToYear integer, Optional
N Y MarketingRiskClassCode-n (can repeat up to 4 times) MarketingRiskClassCodeEnum up to 7 digits, Optional

Possible values: 10925 [Low]; 10926 [Moderate]; 10927 [High]; 0 [Unknown]

N Y GlobalUltimateDUNSNumber-n(can repeat up to 10 times) string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional
N Y FiscalPeriodEndMonth-n (can repeat up to 12 times) MonthType, Optional
N Y AuditorID-n (can repeat up to 10 times) string, up to 256 chars, Optional
N Y UnderwriterID-n (can repeat up to 10 times) string, up to 256 chars, Optional
Y Y DUNSNumberLowRangeValue string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional

The minimum DUNS Number of the companies to be listed in the search result. This is used for search within range values.

Y Y DUNSNumberHighRangeValue string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional

The maximum DUNS Number of the companies to be listed in the search result. This is used for search within range values.

N Y SalesLowRangeAmount decimal, Optional
N Y SalesLowRangeAmountCurrencyISOAlpha3Code

Possible values: USD

N Y SalesHighRangeAmount decimal, Optional
N Y SalesHighRangeAmountCurrencyISOAlpha3Code

Possible values: USD

N Y TotalAssetLowRangeAmount decimal, Optional
N Y TotalAssetLowRangeAmountCurrencyISOAlpha3Code

Possible values: USD

N Y TotalAssetHighRangeAmount decimal, Optional
N Y TotalAssetHighRangeAmountCurrencyISOAlpha3Code

Possible values: USD

N Y MarketCapitalizationLowRangeAmount decimal, Optional
N Y MarketCapitalizationLowRangeAmountCurrencyISOAlpha3Code

Possible values: USD

N Y MarketCapitalizationHighRangeAmount decimal, Optional
N Y MarketCapitalizationHighRangeAmountCurrencyISOAlpha3Code

Possible values: USD

N Y NetIncomeLowRangeAmount decimal, Optional
N Y NetIncomeLowRangeAmountCurrencyISOAlpha3Code

Possible values: USD

N Y NetIncomeHighRangeAmount decimal, Optional
N Y NetIncomeHighRangeAmountCurrencyISOAlpha3Code

Possible values: USD

N Y NetIncomeGrowthLowRangePercentage decimal, up to 7 digits, maximum of 2 decimal places, Optional
N Y NetIncomeGrowthHighRangePercentage decimal, up to 7 digits, maximum of 2 decimal places, Optional
N Y IndividualEntityEmployeeLowRangeQuantity integer, Optional
N Y IndividualEntityEmployeeHighRangeQuantity integer, Optional
N Y ConsolidatedEmployeeLowRangeQuantity integer, Optional
N Y ConsolidatedEmployeeHighRangeQuantity integer, Optional
N Y ConsolidatedEmployeesGrowthLowRangePercentage decimal, up to 7 digits, maximum of 2 decimal places, Optional
N Y ConsolidatedEmployeesGrowthHighRangePercentage decimal, up to 7 digits, maximum of 2 decimal places, Optional
N Y SalesGrowthLowRangePercentage decimal, up to 7 digits, maximum of 2 decimal places, Optional
N Y SalesGrowthHighRangePercentage decimal, up to 7 digits, maximum of 2 decimal places, Optional
N Y PremisesAreaLowRangeMeasurement integer, Optional
N Y PremisesAreaHighRangeMeasurement integer, Optional
N Y OccupancyCode-n integer, up to 7 digits, Optional

Possible values: 1129 [Rents]; 1128 [Owns]

N Y PubliclyTradedCompanyIndicator boolean, Optional

When 'true' indicates that the organization offers its securities to general public, typically through a stock exchange. When 'false' indicates that the organization does not offer its securities to general public.

N Y UpwardFamilyMemberPubliclyTradedCompanyIndicator boolean, Optional

When 'true' indicates that an organization higher up in the family tree of the subject offers its securities to general public, typically through a stock exchange. When 'false' indicates that none of the organization(s) higher up in the family tree of the subject offer securities to general public.

N Y StockExchangeNameCode-n integer, up to 7 digits, Optional
N Y StockExchangeTickerName string, up to 100 chars, Optional

Text by which this subject is identified at this Stock Exchange for share trading purposes, e.g., DNB.

N Y InitialPublicOfferingFilingFromDate date, Optional
N Y InitialPublicOfferingFilingToDate date, Optional
N Y InitialPublicOfferingTradingFromDate date, Optional
N Y InitialPublicOfferingTradingToDate date, Optional
N Y InitialPublicOfferingLowRangeAmount decimal, Optional
N Y InitialPublicOfferingLowRangeAmountCurrencyISOAlpha3Code

Possible values: USD

N Y InitialPublicOfferingHighRangeAmount decimal, Optional
N Y InitialPublicOfferingHighRangeAmountCurrencyISOAlpha3Code

Possible values: USD

N Y InitialPublicOfferingShareValueLowRangeAmount decimal, Optional
N Y InitialPublicOfferingShareValueLowRangeAmountCurrencyISOAlpha3Code

Possible values: USD

N Y InitialPublicOfferingShareValueHighRangeAmount decimal, Optional
N Y InitialPublicOfferingShareValueHighRangeAmountCurrencyISOAlpha3Code

Possible values: USD

N Y MinorityOwnedIndicator boolean, Optional
N Y FemaleOwnedIndicator boolean, Optional
N Y EthnicClassificationCode-n integer, up to 7 digits, Optional

Possible values: 10881 (Chinese; Filipino; Japanese; Korean; Vietnamese; or other Asian origin); 10882 (Black or African American); 10884 (Hispanic; Latino; or Spanish origin); 10885 (Indian Subcontinent origin); 10883 (American Indian; Alaska Native; or Native Hawaiian); 0 (Unknown)

Y Y KeywordText string, up to 256 chars, Optional
N Y OrganizationIdentificationNumberTypeCode-n Attribute
N Y OrganizationIdentificationNumber-n string, at least 1 char, up to 40 chars, Optional

A number assigned by an external body or by D&B which either uniquely identifies or helps to identify an organization.

N Y FranchisingIndicator boolean, Optional

When 'true' indicates that the organization participates in a franchising relationship. When 'false' indicates that the organization does not participate in a franchising relationship.

N Y ImportIndicator boolean, Optional

When 'true' indicates that the subject company imports a quantity of goods from other countries.

N Y ExportIndicator boolean, Optional

When 'true' indicates that the subject company exports a quantity of goods to other countries.

N Y ManufacturingIndicator boolean, Optional

When 'true' indicates that the subject has a manufacturing facility. When 'false' indicates that the subject does not have a manufacturing facility; however as this is the assumed condition there is no requirement to create this tag to represent this fact.

N Y ReturnSalesNavigatorIndicator boolean, Optional

When 'true' the sales navigator will be returned. When 'false' the sales navigator will not be returned. If not specified, the default is FALSE.

N Y SalesNavigatorLowRangeAmount-n decimal, Optional

If only SalesLowRangeAmount is specified, the range will be SalesLowRangeAmount and higher.

N Y SalesNavigatorHighRangeAmount-n decimal, Optional

If only SalesHighRangeAmount is specified, the range will be SalesHighRangeAmount and lower.

N Y ReturnConsolidatedEmployeeQuantityNavigatorIndicator boolean, Optional

When 'true' the consolidated employee count navigator will be returned. When 'false' the consolidated employee count navigator will not be returned. If not specified, the default is FALSE.

N Y ConsolidatedEmployeeNavigatorLowRangeQuantity-n integer, Optional

If only ConsolidatedEmployeeLowRangeCount is specified, the range will be ConsolidatedEmployeeLowRangeCount and higher.

N Y ConsolidatedEmployeeNavigatorHighRangeQuantity-n integer, Optional

If only ConsolidatedEmployeeHighRangeCount is specified, the range will be ConsolidatedEmployeeHighRangeCount and lower.

N Y ReturnIndividualEmployeeQuantityNavigatorIndicator boolean, Optional

When 'true' the individual employee count navigator will be returned. When 'false' the individual employee count navigator will not be returned. If not specified, the default is FALSE.

N Y IndividualEmployeeNavigatorLowRangeQuantity-n integer, Optional

If only IndividualEmployeeLowRangeCount is specified, the range will be IndividualEmployeeLowRangeCount and higher.

N Y IndividualEmployeeNavigatorHighRangeQuantity-n integer, Optional

If only IndividualEmployeeHighRangeCount is specified, the range will be IndividualEmployeeHighRangeCount and lower.

N Y ReturnLocationNavigatorIndicator boolean, Optional

When 'true' the location navigator will be returned. When 'false' the location navigator will not be returned. If not specified, the default is FALSE.

N Y LocationNavigatorType-n LocationNavigatorTypeEnum, Optional

Possible values: Country; Territory

N Y ReturnIndustryNavigatorIndicator boolean, Optional

When 'true' the industry navigator will be returned. When 'false' the industry navigator will not be returned. If not specified, the default is FALSE.

N Y IndustryNavigatorIndustryTypeCode-n integer, up to 7 digits, Optional

Possible values: 700 [NAICS]; 19295 [UK SIC]; 3599 [US SIC]; 25838 [Hoovers Industry code]

N Y ReturnFamilyTreeMemberRoleNavigatorIndicator boolean, Optional

When 'true' the family tree member role navigator will be returned. When 'false' the family tree member role navigator will not be returned. If not specified, the default is FALSE.

N Y ReturnStandaloneOrganizationNavigatorIndicator boolean, Optional

When 'true' the standalone organization navigator will be returned. When 'false' the standalone organization navigator will not be returned. If not specified, the default is FALSE.

N Y ReturnControlOwnershipTypeNavigatorIndicator boolean, Optional

When 'true' the control ownership type navigator will be returned. When 'false' the control ownership type navigator will not be returned. If not specified, the default is FALSE.

N Y ReturnUpwardFamilyMemberPubliclyTradedCompanyNavigator boolean, Optional

When ON (set to 1), the upward family member publicly traded company navigator will be returned. When 'false' the upward family member publicly traded company navigator will not be returned. If not specified, the default is FALSE.

N Y ReturnPubliclyTradedCompanyNavigator boolean, Optional

When ON (set to 1), the publicly traded company navigator will be returned. When 'false' the publicly traded company navigator will not be returned. If not specified, the default is FALSE.

Y Y ExactLocationFindIndicator boolean, Optional

Possible values: default "true"

Y Y SortDirectionText SortDirectionEnum, Optional

Possible values: Ascending; Descending

Y Y CandidateMaximumQuantity integer, up to 6 digits, Optional
Y Y CandidatePerPageMaximumQuantity integer, less than or equal to 10000, Optional
Y Y CandidateDisplayStartSequenceNumber integer, less than or equal to 10000, Optional
Y Y SearchModeDescription SearchModeEnum, Optional

Text describing the nature of search to be applied during the search process.

Possible values: Basic; Advanced

Y Y InclusionDataDescription-n InclusionDataEnum, Optional

Text that denotes an inclusion requirement that the Search process should apply to allow subjects from being returned as candidates. For example if the value is specified as Out of Business, then the Search process should return candidates that have an Operating Status which denotes Out Of Business.

Possible values: IncludeUndeliverableAddressSubject; IncludeOutofBusiness; IncludeIncompleteData; IncludeNonMarketableOnly; IncludeNonMarketable; IncludeDelisted

Y Y KeywordScopeText InclusionParameterenum, Optional

Text denoting the type of parameter value provided in KeywordText to be used by the service to perform the search process.

Possible values: OrganizationName; StockExchangeTickerName

Y Y SortBasisText SortBasisTextEnum, Optional

Parameter value using which search candidates will be sorted in the response.

Possible values: ConsolidatedEmployeeQuantity; CountryISOAlpha2Code; DUNS Number; FamilyTreeMemberRole; OrganizationPrimaryName; PostalCode; PostalCodeExtensionCode; PrimaryTownName; SalesRevenueAmount; StandaloneOrganizationIndicator; StreetAddressLine; TelephoneNumber; TerritoryAbbreviatedName; TerritoryOfficialName; TradeStyleName; Relevancy, MarketabilityIndicator

Y Y CustomerReferenceText-n string, at least 1 char, up to 240 chars, Optional (up to 5x)
Y Y CustomerBillingEndorsementText string, at least 1 char, up to 240 chars, Optional

Endpoint

Use the following endpoint for requesting this feature. The {version} is dependent on the underlying service delivering the response.

NOTE: While "organizations" is part of this endpoint, there is no service by this name. Many D&B Direct calls have a similar structure; however, the {version} component is based on the SERVICE to which a given product is associated.

REST (EntityList)
GET https://direct.dnb.com/V{version}/organizations?findcompany

Testing

This operation will return a static set of results in the D&B Direct test environment (sandbox), regardless of the request parameters.

Feature Response

NOTE: The D&B Direct REST implementation uses the BadgerFish approach for JSON with some minor variations.

Specification

The following is a list of the possible data fields returned by this operation in the JSON response. Samples are provided for testing successful and failed retrieval, and to demonstrate the basic layout of a response. The data returned in samples may not represent actual values that this feature will deliver.

NOTE: The D-U-N-S Number returned in the response will be a nine-digit zero-padded, numeric value.

Sample Response (Basic)
{
  "FindCompanyResponse": {
    "@ServiceVersionNumber": "6.4",
    "TransactionDetail": {
      "ApplicationTransactionID": "Service Governance Samples - EntityListV6.4",
      "ServiceTransactionID": "Id-cfb9a956eb5c000018ff0000a59059f1-1",
      "TransactionTimestamp": "2016-01-28T01:48:48"
    },
    "TransactionResult": {
      "SeverityText": "Information",
      "ResultID": "CM000",
      "ResultText": "Success"
    },
    "FindCompanyResponseDetail": {
      "CandidateMatchedQuantity": 1,
      "CandidateReturnedQuantity": 1,
      "FindCandidate": [
        {
          "DUNSNumber": "804735132",
          "OrganizationPrimaryName": {
            "OrganizationName": {
              "$": "Gorman Manufacturing Company, Inc."
            }
          },
          "PrimaryAddress": {
            "StreetAddressLine": [
              {
                "LineText": "492 Koller Street"
              }
            ],
            "PrimaryTownName": "San Francisco",
            "CountryISOAlpha2Code": "US",
            "PostalCode": "94110",
            "TerritoryOfficialName": "California",
            "TerritoryAbbreviatedName": "CA",
            "CountryOfficialName": "United States",
            "LatitudeMeasurement": 12.34567,
            "LongitudeMeasurement": -12.34567,
            "GeographicalPrecisionText": {
              "@DNBCodeValue": 0,
              "$": "Unknown"
            },
            "MetropolitanStatisticalAreaUSCensusCode": [
              "41860"
            ]
          },
          "TelephoneNumber": {
            "TelecommunicationNumber": "6505550000"
          },
          "FamilyTreeMemberRole": [
            {
              "FamilyTreeMemberRoleText": {
                "@DNBCodeValue": 12771,
                "$": "Headquarters"
              }
            }
          ],
          "StandaloneOrganizationIndicator": false,
          "SubjectHandling": [
            {
              "SubjectHandlingText": {
                "@DNBCodeValue": 7974,
                "$": "Do not call"
              }
            }
          ],
          "ManufacturingIndicator": true,
          "ConsolidatedEmployeeDetails": {
            "TotalEmployeeQuantity": 125
          },
          "SalesRevenueAmount": {
            "@CurrencyISOAlpha3Code": "USD",
            "@UnitOfSize": "Thousand",
            "$": 19465.134
          },
          "DisplaySequence": 1
        }
      ]
    }
  }
}

Sample Response (Advanced)
{
  "FindCompanyResponse": {
    "@ServiceVersionNumber": "6.4",
    "TransactionDetail": {
      "ApplicationTransactionID": "Id-e9a8c52d527270b101bb170d-1",
      "ServiceTransactionID": "Id-e9a8c52d527270b101bb170d-1",
      "TransactionTimestamp": "2017-10-04T11:01:06"
    },
    "TransactionResult": {
      "SeverityText": "Information",
      "ResultID": "CM000",
      "ResultText": "Success"
    },
    "FindCompanyResponseDetail": {
      "CandidateMatchedQuantity": 4,
      "CandidateReturnedQuantity": 4,
      "FindCandidate": [
        {
          "DUNSNumber": "053499156",
          "OrganizationPrimaryName": {
            "OrganizationName": {
              "$": "J Gorman Paving and Seal Coating"
            }
          },
          "MarketabilityIndicator": true,
          "PrimaryAddress": {
            "StreetAddressLine": [
              {
                "LineText": "220 275 State Route 10 E"
              }
            ],
            "PrimaryTownName": "Succasunna",
            "CountryISOAlpha2Code": "US",
            "PostalCode": "07876",
            "PostalCodeExtensionCode": "1358",
            "TerritoryOfficialName": "New Jersey",
            "TerritoryAbbreviatedName": "NJ",
            "CountryOfficialName": "United States",
            "MetropolitanStatisticalAreaUSCensusCode": [
              "35620"
            ]
          },
          "TelephoneNumber": {
            "TelecommunicationNumber": "9732077750"
          },
          "StandaloneOrganizationIndicator": true,
          "IndustryCode": [
            {
              "@TypeText": "D&B Standard Industry Code",
              "@DNBCodeValue": 3599,
              "IndustryCode": {
                "$": "16110200"
              },
              "IndustryCodeDescription": [
                {
                  "@IndustryCodeDescriptionLengthCode": 2121,
                  "$": "SURFACING AND PAVING"
                }
              ]
            }
          ],
          "ConsolidatedEmployeeDetails": {
            "TotalEmployeeQuantity": 2
          },
          "PubliclyTradedCompanyIndicator": false,
          "UpwardFamilyMemberPubliclyTradedCompanyIndicator": false,
          "SalesRevenueAmount": {
            "@CurrencyISOAlpha3Code": "USD",
            "@UnitOfSize": "Million",
            "$": 0.14
          },
          "DisplaySequence": 1
        },
        {
          "DUNSNumber": "125163910",
          "OrganizationPrimaryName": {
            "OrganizationName": {
              "$": "Howard Gorman"
            }
          },
          "TradeStyleName": [
            {
              "OrganizationName": {
                "$": "JAS SURGICAL"
              }
            }
          ],
          "MarketabilityIndicator": true,
          "PrimaryAddress": {
            "StreetAddressLine": [
              {
                "LineText": "5 Rickland Dr"
              }
            ],
            "PrimaryTownName": "Dover",
            "CountryISOAlpha2Code": "US",
            "PostalCode": "07869",
            "PostalCodeExtensionCode": "4304",
            "TerritoryOfficialName": "New Jersey",
            "TerritoryAbbreviatedName": "NJ",
            "CountryOfficialName": "United States",
            "MetropolitanStatisticalAreaUSCensusCode": [
              "35620"
            ]
          },
          "TelephoneNumber": {
            "TelecommunicationNumber": "9734421768"
          },
          "StandaloneOrganizationIndicator": true,
          "IndustryCode": [
            {
              "@TypeText": "D&B Standard Industry Code",
              "@DNBCodeValue": 3599,
              "IndustryCode": {
                "$": "50470300"
              },
              "IndustryCodeDescription": [
                {
                  "@IndustryCodeDescriptionLengthCode": 2121,
                  "$": "MEDICAL EQUIP,SUPPS"
                }
              ]
            }
          ],
          "ConsolidatedEmployeeDetails": {
            "TotalEmployeeQuantity": 1
          },
          "PubliclyTradedCompanyIndicator": false,
          "UpwardFamilyMemberPubliclyTradedCompanyIndicator": false,
          "SalesRevenueAmount": {
            "@CurrencyISOAlpha3Code": "USD",
            "@UnitOfSize": "Million",
            "$": 0.092
          },
          "DisplaySequence": 2
        },
        {
          "DUNSNumber": "102456949",
          "OrganizationPrimaryName": {
            "OrganizationName": {
              "$": "Brian O'Gorman Flooring Inc"
            }
          },
          "MarketabilityIndicator": true,
          "PrimaryAddress": {
            "StreetAddressLine": [
              {
                "LineText": "633 Dorothy Ln"
              }
            ],
            "PrimaryTownName": "Landing",
            "CountryISOAlpha2Code": "US",
            "PostalCode": "07850",
            "PostalCodeExtensionCode": "1410",
            "TerritoryOfficialName": "New Jersey",
            "TerritoryAbbreviatedName": "NJ",
            "CountryOfficialName": "United States",
            "MetropolitanStatisticalAreaUSCensusCode": [
              "35620"
            ]
          },
          "TelephoneNumber": {
            "TelecommunicationNumber": "9733987470"
          },
          "StandaloneOrganizationIndicator": true,
          "IndustryCode": [
            {
              "@TypeText": "D&B Standard Industry Code",
              "@DNBCodeValue": 3599,
              "IndustryCode": {
                "$": "17520000"
              },
              "IndustryCodeDescription": [
                {
                  "@IndustryCodeDescriptionLengthCode": 2121,
                  "$": "FLOOR WORK  NEC"
                }
              ]
            }
          ],
          "ConsolidatedEmployeeDetails": {
            "TotalEmployeeQuantity": 1
          },
          "PubliclyTradedCompanyIndicator": false,
          "UpwardFamilyMemberPubliclyTradedCompanyIndicator": false,
          "SalesRevenueAmount": {
            "@CurrencyISOAlpha3Code": "USD",
            "@UnitOfSize": "Million",
            "$": 0.07
          },
          "DisplaySequence": 3
        },
        {
          "DUNSNumber": "019951598",
          "OrganizationPrimaryName": {
            "OrganizationName": {
              "$": "Marilyn O'Gorman"
            }
          },
          "MarketabilityIndicator": true,
          "PrimaryAddress": {
            "StreetAddressLine": [
              {
                "LineText": "67 Crestview Ln"
              }
            ],
            "PrimaryTownName": "Mount Arlington",
            "CountryISOAlpha2Code": "US",
            "PostalCode": "07856",
            "PostalCodeExtensionCode": "1390",
            "TerritoryOfficialName": "New Jersey",
            "TerritoryAbbreviatedName": "NJ",
            "CountryOfficialName": "United States",
            "MetropolitanStatisticalAreaUSCensusCode": [
              "35620"
            ]
          },
          "TelephoneNumber": {
            "TelecommunicationNumber": "9733980687"
          },
          "StandaloneOrganizationIndicator": true,
          "IndustryCode": [
            {
              "@TypeText": "D&B Standard Industry Code",
              "@DNBCodeValue": 3599,
              "IndustryCode": {
                "$": "73899999"
              },
              "IndustryCodeDescription": [
                {
                  "@IndustryCodeDescriptionLengthCode": 2121,
                  "$": "ATVTY AT NON COMMRCL"
                }
              ]
            }
          ],
          "ConsolidatedEmployeeDetails": {
            "TotalEmployeeQuantity": 1
          },
          "PubliclyTradedCompanyIndicator": false,
          "UpwardFamilyMemberPubliclyTradedCompanyIndicator": false,
          "SalesRevenueAmount": {
            "@CurrencyISOAlpha3Code": "USD",
            "@UnitOfSize": "Million",
            "$": 0.057
          },
          "DisplaySequence": 4
        }
      ]
    }
  }
}

Basic Advanced Name Characteristics
Y Y FindCompanyResponse Aggregate
Y Y FindCompanyResponse @ServiceVersionNumber
Y Y FindCompanyResponse { TransactionDetail Aggregate, Required

Records information necessary to process a particular request. Examples of a request is the ordering of a product.

Y Y FindCompanyResponse { TransactionDetail { ApplicationTransactionID string, up to 64 chars, Optional

A number assigned by the calling application to uniquely identify this request.

Y Y FindCompanyResponse { TransactionDetail { ServiceTransactionID string, up to 64 chars, Required

A number assigned by the D&B service to uniquely identify this transaction.

Y Y FindCompanyResponse { TransactionDetail { TransactionTimestamp dateTime, Required

The date and time when this request was submitted or the date and time when the requesting intermediary, such as a workflow manager or service bus, sent the message to the D&B function, i.e., the date and time when the xml document was created by the requesting intermediary.

Y Y End: FindCompanyResponse } TransactionDetail /Aggregate
Y Y FindCompanyResponse { TransactionResult Aggregate, Required

Records the different outcomes of the transaction.

Y Y FindCompanyResponse { TransactionResult { SeverityText string, Required
Y Y FindCompanyResponse { TransactionResult { ResultID string, up to 32 chars, Required
Y Y FindCompanyResponse { TransactionResult { ResultText string, up to 512 chars, Optional
Y Y FindCompanyResponse { TransactionResult { ResultMessage Aggregate, Optional (Array)
Y Y FindCompanyResponse { TransactionResult { ResultMessage { ResultDescription string, up to 512 chars, Required

Text that describes the additional information regarding the outcome of the transaction.

Y Y End: FindCompanyResponse } TransactionResult } ResultMessage /Aggregate
Y Y End: FindCompanyResponse } TransactionResult /Aggregate
Y Y FindCompanyResponse { FindCompanyResponseDetail Aggregate, Optional

Records data relating to responses for search based on organization related information. This may include such details as the number of candidates that matched the search criteria,candidate information etc.

Y Y FindCompanyResponse { FindCompanyResponseDetail { CandidateMatchedQuantity integer, Required

The number of subjects identified as possible prospects in the D&B repository.

Y Y FindCompanyResponse { FindCompanyResponseDetail { CandidateReturnedQuantity integer, Optional

The number of subjects actually returned as possible prospects in the D&B repository based on the search criteria.

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate Aggregate, Optional (Array)

Records the details of the candidates that matched the search criteria.

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { DUNSNumber string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Required
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { OrganizationPrimaryName Aggregate, Required
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { OrganizationPrimaryName { OrganizationName string, up to 256 chars, Required
Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate } OrganizationPrimaryName /Aggregate
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { TradeStyleName Aggregate, Optional (Array)
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { TradeStyleName { OrganizationName string, up to 256 chars, Required
Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate } TradeStyleName /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { MarketabilityIndicator boolean, Optional

When 'true' indicates that the record satisfies D&B marketability rules. When 'false' indicates that the record does not satisfy D&B marketability rules; however, there is no requirement to create this tag to represent this fact.

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress Aggregate, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { StreetAddressLine Aggregate, Optional (Array)
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { StreetAddressLine { LineText string, up to 240 chars, Required
Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate } PrimaryAddress } StreetAddressLine /Aggregate
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { PrimaryTownName string, up to 64 chars, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { CountryISOAlpha2Code string, at least 2 chars, up to 2 chars, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { PostalCode string, up to 16 chars, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { PostalCodeExtensionCode string, up to 16 chars, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { TerritoryOfficialName string, up to 64 chars, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { TerritoryAbbreviatedName string, up to 64 chars, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { CountryOfficialName string, up to 64 chars, Optional

The legal name of the country for this address.

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { MetropolitanStatisticalAreaUSCensusCode string, Optional (Array)

A Geographical Region with a relatively high population density at its core and close economic ties throughout the area.

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { LatitudeMeasurement decimal, up to 9 digits, maximum of 6 decimal places , Optional

The angular distance north or south from the Earth's equator measured through 90 degrees expressed in decimal numbers.

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { LongitudeMeasurement decimal, up to 10 digits, maximum of 6 decimal places , Optional

The angular distance east or west from the prime (Greenwich) meridian measured through 180 degrees expressed in decimal numbers.

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { GeographicalPrecisionText string, up to 64 chars, Optional

Text that identifies the accuracy of the match used for an address, e.g., Street Segment .1 to .2 miles, Block Group .2 to .4 mile U.S. ZIP + 4.

Possible Values: 30246[ZipPlus4 Centroid] 30247[PO Box Location Centroid] 30248[State or Province Centroid] 30249[County Centroid] 30250[ZipPlus2 Centroid] 30252[Town Centroid] 30253[Locality Centroid] 30254 [Street Intersection Centroid] 30255[Sub Locality Centroid] 30256[Street Segment Centroid] 30257[Street Address Centroid] 30258[Postal Code Centroid]

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { GeographicalPrecisionText @DNBCodeValue Attribute, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PrimaryAddress { MetropolitanStatisticalAreaUSCensusCode string, Optional (Array)

A Geographical Region with a relatively high population density at its core and close economic ties throughout the area.

Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate } PrimaryAddress /Aggregate
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { MailingAddress Aggregate, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { MailingAddress { StreetAddressLine Aggregate, Optional (Array)
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { MailingAddress { StreetAddressLine { LineText string, up to 240 chars, Required
Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate } MailingAddress } StreetAddressLine /Aggregate
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { MailingAddress { PrimaryTownName string, up to 64 chars, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { MailingAddress { CountryISOAlpha2Code string, at least 2 chars, up to 2 chars, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { MailingAddress { PostalCode string, up to 16 chars, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { MailingAddress { PostalCodeExtensionCodestring, up to 64 chars, Optional

 

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { MailingAddress { TerritoryOfficialName string, up to 64 chars, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { MailingAddress { TerritoryAbbreviatedName string, up to 64 chars, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { MailingAddress { CountryOfficialName string, up to 64 chars, Optional

The legal name of the country for this address.

Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate } MailingAddress /Aggregate
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { TelephoneNumber Aggregate, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { TelephoneNumber { TelecommunicationNumber string, at least 1 char, up to 50 chars, Required
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { TelephoneNumber { InternationalDialingCode integer, up to 7 digits, Optional
Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate } TelephoneNumber /Aggregate
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { FacsimileNumber Aggregate, Optional

An entry loop which can allow multiple Facsimile contact information used for data communication with the subject.

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { FacsimileNumber { TelecommunicationNumber string, at least 1 char, up to 50 chars, Required
Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate } FacsimileNumber /Aggregate
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { FamilyTreeMemberRole Aggregate, Optional (Array)
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { FamilyTreeMemberRole { FamilyTreeMemberRoleText string, up to 256 chars, Optional

Possible values: 9141 [Parent/Headquarters] - for Parent; HQ or Parent & HQ; 12769 [Branch] - for Branch or Division; 9159 [Subsidiary]

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { FamilyTreeMemberRole { FamilyTreeMemberRoleText @DNBCodeValue integer, up to 7 digits, Attribute (1x)

Possible values: 9141 [Parent/Headquarters] - for Parent; HQ or Parent & HQ; 12769 [Branch] - for Branch or Division; 9159 [Subsidiary]

Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate } FamilyTreeMemberRole /Aggregate
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { StandaloneOrganizationIndicator boolean, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { SubjectHandling Aggregate, Optional (Array)

An entry loop records the type of special handling a subject is to receive from D&B (or a D&B partner, e.g., IBM, Bonnier) e.g., the subject is not to be contacted by us, by calling or any other means, at the organization's request.

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { SubjectHandling { SubjectHandlingText string, up to 256 chars, Required

Text specifying the manner in which the Subject is to receive special care from D&B when it is being contacted; e.g., do not call, do not send information requests. In many cases this process was specifically requested by the Subject.

Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate } SubjectHandling /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { IndustryCode Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of several business activities in which an organization is actively engaged using standardized coding schemes such as European NACE and U.S. Standard Industry Classifications (SIC).

N Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { IndustryCode @DNBCodeValue integer, up to 7 digits, Attribute (1x)

Possible values: 3599 -USSIC

N Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { IndustryCode { IndustryCode string, up to 16 chars, Optional

An alphanumeric value identifying a business activity based on the scheme specified by the typeText. For instance, 1611 represents the highway and street construction industry in the U.S. SIC (Standard Industrial Classification) system. Clarification Note: These are generally external codes created by an external authoritative body, like the U.S. Office of Management and Budget (OMB), but D&B may have created extensions to more precisely define an activity, as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).

N Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { IndustryCode { IndustryCodeDescription string, up to 256 chars, Optional (Array)

Text that describes the business activity based on the scheme specified by the attribute typeText. E.g., 'highway and street construction' is the description of industry code 1611 in the U.S. SIC (Standard Industrial Classification) system.

N Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { IndustryCode { IndustryCodeDescription @IndustryCodeDescriptionLengthCode
Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate } IndustryCode /Aggregate
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { ManufacturingIndicator boolean, Optional

When 'true' indicates that the subject has a manufacturing facility. When 'false' indicates that the subject does not have a manufacturing facility; however as this is the assumed condition there is no requirement to create this tag to represent this fact.

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { ConsolidatedEmployeeDetails Aggregate, Optional

Records current employee data which includes all employees who are engaged in the operations of the legal entity (including employees located at branch locations) as well as all employees who are engaged in the operations of every direct descendant in its family tree (based on controlling interest), i.e., subsidiaries. Note: An organization which is classified by D&B as a branch" location cannot have a "Consolidated" employee figure."

Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { ConsolidatedEmployeeDetails { TotalEmployeeQuantity long, Optional

A number that defines how many people are directly engaged and paid by the organization to perform or support its business operations.

Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate } ConsolidatedEmployeeDetails /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { PubliclyTradedCompanyIndicator boolean, Optional

When 'true' indicates that the organization offers its securities to general public, typically through a stock exchange. When 'false' indicates that the organization does not offer its securities to general public.

N Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { UpwardFamilyMemberPubliclyTradedCompanyIndicator boolean, Optional

When 'true' indicates that an organization higher up in the family tree of the subject offers its securities to general public, typically through a stock exchange. When 'false' indicates that none of the organization(s) higher up in the family tree of the subject offer securities to general public.

N Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { StockExchangeDetails Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of any Stock Exchanges on which the subject's shares are traded.

N Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { StockExchangeDetails { StockExchangeName string, up to 256 chars, Optional

The name of a Stock Exchange on which the subject's shares are traded.

N Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { StockExchangeDetails { StockExchangeName @DNBCodeValue integer, up to 7 digits, Attribute (1x)
N Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { StockExchangeDetails { StockExchangeTickerName string, up to 100 chars, Optional

Text by which this subject is identified at this Stock Exchange for share trading purposes, e.g., DNB.

Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate } StockExchangeDetails /Aggregate
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { SalesRevenueAmount decimal, Optional
Y Y FindCompanyResponse { FindCompanyResponseDetail { FindCandidate { DisplaySequence integer, up to 5 digits, Optional
Y Y End: FindCompanyResponse } FindCompanyResponseDetail } FindCandidate /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail Aggregate, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { SalesNavigatorDetail Aggregate, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { SalesNavigatorDetail { SalesNavigatorRange Aggregate, Optional (Array)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { SalesNavigatorDetail { SalesNavigatorRange { SalesNavigatorLowRangeAmount decimal, Optional

If only SalesLowRangeAmount is specified, the range will be SalesLowRangeAmount and higher.

N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { SalesNavigatorDetail { SalesNavigatorRange { SalesNavigatorLowRangeAmount @CurrencyISOAlpha3Code string, up to 3 chars, Attribute (1x)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { SalesNavigatorDetail { SalesNavigatorRange { SalesNavigatorLowRangeAmount @UnitOfSize string, up to 12 chars, Attribute (1x)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { SalesNavigatorDetail { SalesNavigatorRange { SalesNavigatorLowRangeAmount @ReliabilityText string, up to 256 chars, Attribute (1x)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { SalesNavigatorDetail { SalesNavigatorRange { SalesNavigatorHighRangeAmount decimal, Optional

If only SalesHighRangeAmount is specified, the range will be SalesHighRangeAmount and lower.

N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { SalesNavigatorDetail { SalesNavigatorRange { SalesNavigatorHighRangeAmount @CurrencyISOAlpha3Code string, up to 3 chars, Attribute (1x)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { SalesNavigatorDetail { SalesNavigatorRange { SalesNavigatorHighRangeAmount @UnitOfSize string, up to 12 chars, Attribute (1x)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { SalesNavigatorDetail { SalesNavigatorRange { SalesNavigatorHighRangeAmount @ReliabilityText string, up to 256 chars, Attribute (1x)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { SalesNavigatorDetail { SalesNavigatorRange { CandidateMatchedQuantity integer, Required

The number of subjects identified as possible prospects in the D&B repository.

N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } SalesNavigatorDetail } SalesNavigatorRange /Aggregate
N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } SalesNavigatorDetail /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { ConsolidatedEmployeeQuantityNavigatorDetail Aggregate, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { ConsolidatedEmployeeQuantityNavigatorDetail { ConsolidatedEmployeeQuantityRange Aggregate, Optional (Array)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { ConsolidatedEmployeeQuantityNavigatorDetail { ConsolidatedEmployeeQuantityRange { ConsolidatedEmployeeLowRangeQuantity integer, Optional

If only ConsolidatedEmployeeLowRangeCount is specified, the range will be ConsolidatedEmployeeLowRangeCount and higher.

N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { ConsolidatedEmployeeQuantityNavigatorDetail { ConsolidatedEmployeeQuantityRange { ConsolidatedEmployeeHighRangeQuantity integer, Optional

If only ConsolidatedEmployeeHighRangeCount is specified, the range will be ConsolidatedEmployeeHighRangeCount and lower.

N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { ConsolidatedEmployeeQuantityNavigatorDetail { ConsolidatedEmployeeQuantityRange { CandidateMatchedQuantity integer, Required

The number of subjects identified as possible prospects in the D&B repository.

N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { LocationNavigatorDetail { LocationNavigator { LocationNavigator LocationNavigator , Optional
N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } ConsolidatedEmployeeQuantityNavigatorDetail } ConsolidatedEmployeeQuantityRange /Aggregate
N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } ConsolidatedEmployeeQuantityNavigatorDetail /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndividualEmployeeQuantityNavigatorDetail Aggregate, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndividualEmployeeQuantityNavigatorDetail { IndividualEmployeeQuantityRange Aggregate, Optional (Array)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndividualEmployeeQuantityNavigatorDetail { IndividualEmployeeQuantityRange { IndividualEmployeeLowRangeQuantity integer, Optional

If only IndividualEmployeeLowRangeCount is specified, the range will be IndividualEmployeeLowRangeCount and higher.

N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndividualEmployeeQuantityNavigatorDetail { IndividualEmployeeQuantityRange { IndividualEmployeeHighRangeQuantity integer, Optional

If only IndividualEmployeeHighRangeCount is specified, the range will be IndividualEmployeeHighRangeCount and lower.

N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndividualEmployeeQuantityNavigatorDetail { IndividualEmployeeQuantityRange { CandidateMatchedQuantity integer, Required

The number of subjects identified as possible prospects in the D&B repository.

N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } IndividualEmployeeQuantityNavigatorDetail } IndividualEmployeeQuantityRange /Aggregate
N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } IndividualEmployeeQuantityNavigatorDetail /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { LocationNavigatorDetail Aggregate, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { LocationNavigatorDetail { LocationNavigator Aggregate, Required (Array)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { LocationNavigatorDetail { LocationNavigator { LocationType LocationNavigatorTypeEnum, Required
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { LocationNavigatorDetail { LocationNavigator { LocationCode string, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { LocationNavigatorDetail { LocationNavigator { LocationName string, Required
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { LocationNavigatorDetail { LocationNavigator { CandidateMatchedQuantity integer, Required

The number of subjects identified as possible prospects in the D&B repository.

N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } LocationNavigatorDetail } LocationNavigator /Aggregate
N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } LocationNavigatorDetail /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndustryNavigatorDetail Aggregate, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndustryNavigatorDetail { IndustryCode Aggregate, Optional (Array)

Only results matching the specified industry code(s) will be returned.

N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndustryNavigatorDetail { IndustryCode { IndustryCode IndustryCodeType, Required
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndustryNavigatorDetail { IndustryCode { IndustryCode @TypeText string, up to 256 chars, Attribute (1x)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndustryNavigatorDetail { IndustryCode { IndustryCode @DNBCodeValue integer, up to 7 digits, Attribute (1x)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndustryNavigatorDetail { IndustryCode { IndustryCode @DNBCodeTableNumber integer, up to 7 digits, Attribute (1x)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndustryNavigatorDetail { IndustryCode { IndustryCode { IndustryCode string, up to 16 chars, Optional

An alphanumeric value identifying a business activity based on the scheme specified by the typeText. For instance, 1611 represents the highway and street construction industry in the U.S. SIC (Standard Industrial Classification) system. Clarification Note: These are generally external codes created by an external authoritative body, like the U.S. Office of Management and Budget (OMB), but D&B may have created extensions to more precisely define an activity, as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).

N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndustryNavigatorDetail { IndustryCode { IndustryCode { IndustryCodeDescription string, up to 256 chars, Optional (Array)

Text that describes the business activity based on the scheme specified by the attribute typeText. E.g., 'highway and street construction' is the description of industry code 1611 in the U.S. SIC (Standard Industrial Classification) system.

N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndustryNavigatorDetail { IndustryCode { IndustryCode { IndustryCodeDescription @IndustryCodeDescriptionLengthCode
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndustryNavigatorDetail { IndustryCode { IndustryCode { IndustryExplanationText string, up to 3000 chars, Optional

Free form text describing the business activity.

N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndustryNavigatorDetail { IndustryCode { IndustryCode { DisplaySequence integer, Optional

A number which may be used to define the order in which this industry code should be presented relative to other industry codes of the same type where the lower the number the earlier the data is presented.

N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } IndustryNavigatorDetail } IndustryCode } IndustryCode /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { IndustryNavigatorDetail { IndustryCode { CandidateMatchedQuantity integer, Required

The number of subjects identified as possible prospects in the D&B repository.

N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } IndustryNavigatorDetail } IndustryCode /Aggregate
N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } IndustryNavigatorDetail /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { FamilyTreeMemberRoleNavigatorDetail Aggregate, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { FamilyTreeMemberRoleNavigatorDetail { FamilyTreeMemberRole Aggregate, Optional (Array)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { FamilyTreeMemberRoleNavigatorDetail { FamilyTreeMemberRole { FamilyTreeMemberRole Aggregate, Required
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { FamilyTreeMemberRoleNavigatorDetail { FamilyTreeMemberRole { FamilyTreeMemberRole { FamilyTreeMemberRoleText string, up to 256 chars, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { FamilyTreeMemberRoleNavigatorDetail { FamilyTreeMemberRole { FamilyTreeMemberRole { FamilyTreeMemberRoleText @DNBCodeValue integer, up to 7 digits, Attribute (1x)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { FamilyTreeMemberRoleNavigatorDetail { FamilyTreeMemberRole { FamilyTreeMemberRole { FamilyTreeMemberRoleText @DNBCodeTableNumber integer, up to 7 digits, Attribute (1x)
N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } FamilyTreeMemberRoleNavigatorDetail } FamilyTreeMemberRole } FamilyTreeMemberRole /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { FamilyTreeMemberRoleNavigatorDetail { FamilyTreeMemberRole { CandidateMatchedQuantity integer, Required

The number of subjects identified as possible prospects in the D&B repository.

N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } FamilyTreeMemberRoleNavigatorDetail } FamilyTreeMemberRole /Aggregate
N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } FamilyTreeMemberRoleNavigatorDetail /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { StandaloneOrganizationNavigatorDetail Aggregate, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { StandaloneOrganizationNavigatorDetail { CandidateMatchedQuantity integer, Required

The number of subjects identified as possible prospects in the D&B repository.

N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } StandaloneOrganizationNavigatorDetail /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { ControlOwnershipTypeNavigatorSpecification Aggregate, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { ControlOwnershipTypeNavigatorSpecification { ControlOwnershipType Aggregate, Optional (Array)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { ControlOwnershipTypeNavigatorSpecification { ControlOwnershipType { ControlOwnershipTypeText string, up to 256 chars, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { ControlOwnershipTypeNavigatorSpecification { ControlOwnershipType { ControlOwnershipTypeText @DNBCodeValue integer, up to 7 digits, Attribute (1x)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { ControlOwnershipTypeNavigatorSpecification { ControlOwnershipType { ControlOwnershipTypeText @DNBCodeTableNumber integer, up to 7 digits, Attribute (1x)
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { ControlOwnershipTypeNavigatorSpecification { ControlOwnershipType { CandidateMatchedQuantity integer, Required

The number of subjects identified as possible prospects in the D&B repository.

N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } ControlOwnershipTypeNavigatorSpecification } ControlOwnershipType /Aggregate
N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } ControlOwnershipTypeNavigatorSpecification /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { UpwardFamilyMemberPubliclyTradedCompanyNavigatorDetail Aggregate, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { UpwardFamilyMemberPubliclyTradedCompanyNavigatorDetail { CandidateMatchedQuantity integer, Required

The number of subjects identified as possible prospects in the D&B repository.

N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } UpwardFamilyMemberPubliclyTradedCompanyNavigatorDetail /Aggregate
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { PubliclyTradedCompanyNavigatorDetail Aggregate, Optional
N Y FindCompanyResponse { FindCompanyResponseDetail { NavigatorDetail { PubliclyTradedCompanyNavigatorDetail { CandidateMatchedQuantity integer, Required

The number of subjects identified as possible prospects in the D&B repository.

N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail } PubliclyTradedCompanyNavigatorDetail /Aggregate
N Y End: FindCompanyResponse } FindCompanyResponseDetail } NavigatorDetail /Aggregate
Y Y FindCompanyResponse { FindCompanyResponseDetail { InquiryReferenceDetail Aggregate, Optional

Records data that allows the customer to specify information to be linked to this request in order to support subsequent searches.

Y Y FindCompanyResponse { FindCompanyResponseDetail { InquiryReferenceDetail { CustomerReferenceText string, at least 1 char, up to 240 chars, Optional (Up to 5x)
Y Y FindCompanyResponse { FindCompanyResponseDetail { InquiryReferenceDetail { CustomerBillingEndorsementText string, at least 1 char, up to 240 chars, Optional
Y Y End: FindCompanyResponse } FindCompanyResponseDetail } InquiryReferenceDetail /Aggregate
Y Y End: FindCompanyResponse } FindCompanyResponseDetail /Aggregate
Y Y End: FindCompanyResponse /Aggregate

Lists of possible values (when present) are subject to change. Additional values not presented in this documentation may be delivered in the response and should be anticipated in any implementation.

Empty/NULL Values

A NULL returned for an element indicates that the information was not provided to D&B when the related data items were collected. The absence of a value for a particular item should not be considered indicative of any implied value (e.g., NULL for a boolean indicator is NOT the same as a value of 'false').

Abbreviated Territory Names

When present, the Territory Abbreviated Name field will contain local abbreviations, which may be based on standard designations. For companies domiciled in the United States or Canada, this field will contain the second component of ISO 3166-2 codes. For example, the ISO 3166-2:US code for New Jersey is "US-NJ" and the value "NJ" will be delivered in this field. Similarly, the ISO 3166-2:CA code for Ontario is "CA-ON" and the value "ON" will be delivered in this field.

Response Codes & Error Handling

Successful service requests will return a CM000 response code in the TransactionResult ResultID field. Otherwise, one of the D&B Direct standard response codes will be returned.

This operation may return the following response codes: CM002, CM003, CM004, CM005, CM007, CM012, CM018, CM022, and SC001-SC009.

D&B Direct 2.0 API requests are provided on a metered basis; and may require entitlement prior to use in the production environment. In addition, a concurrency limit (QPS) is monitored to ensure that it is not exceeded. An error code will be returned in the event that a transaction is throttled.

Qualified usage (e.g., a successful response) is tracked and billed according to the terms & conditions of the customer's contract. The response codes CM000, CM010, PD002 and PD015 are considered successful. A built-in feature exists to prevent duplicate billing when multiple successful requests with the same criteria are submitted on the same calendar day (which is based on Eastern Standard Time [GMT-5]).

Search operations that involve pagination will only be recorded once -- upon the initial search request. Therefore, customer online usage (OLUS) reports will display a single entry for each unique combination of search criteria requested.

Business Elements

While D&B Direct uses a product canonical naming model in the request/response, many customers may be more familiar with the following business element labels.

Basic Advanced Business Element Name Description
N Y Count of Publicly Traded Companies

PCM XPath: //NavigatorDetail/ PubliclyTradedCompanyNavigatorDetail/ CandidateMatchedQuantity

N Y Count of Upward Family Member Publicly Traded Companies

PCM XPath: //NavigatorDetail/ UpwardFamilyMemberPubliclyTradedCompanyNavigatorDetail/ CandidateMatchedQuantity

Y Y Country Code The two-letter country code, defined by the International Organization for Standardization (ISO) ISO 3166-1 scheme, where the company is located.

PCM XPath: //FindCandidate/ PrimaryAddress/ CountryOfficialName

Y Y D-U-N-S Number

PCM XPath: //FindCandidate/ DUNSNumber

Y Y Employee Quantity (All Locations)

PCM XPath: //FindCandidate/ ConsolidatedEmployeeDetails/ TotalEmployeeQuantity

Y Y Family Tree Member Role (HQ/Branch/Subsidiary)

PCM XPath: //FindCandidate/ FamilyTreeMemberRole/ FamilyTreeMemberRoleText

Y Y Fax Number Main facsimile number of the business.

PCM XPath: //FindCandidate/ FacsimileNumber/ TelecommunicationNumber

N Y Industry Code This code represents the locally used activity code. These are generally regionally based industry identification systems. Examples include 1972 U.S. SIC, SBA, APE, and NACE.

PCM XPath: //FindCandidate/ IndustryCode/ IndustryCode

Y Y Latitude The angular distance of the organization's primary physical address north or south from the Earth's equator measured through 90 degrees expressed in decimal numbers.

PCM XPath: //FindCandidate/ PrimaryAddress/ LatitudeMeasurement

Y Y Longitude The angular distance of the organization's primary physical address east or west from an imaginary line (called the prime meridian) that goes from the North Pole to the South Pole measured through 90 degrees expressed in decimal numbers.

PCM XPath: //FindCandidate/ PrimaryAddress/ LongitudeMeasurement

Y Y Mailing Country Code The three digit code associated with the country name of the mailing address.

PCM XPath: //FindCandidate/ MailingAddress/ CountryOfficialName

Y Y Mailing Postal Code The postal code where the business has its mail delivered.

PCM XPath: //FindCandidate/ MailingAddress/ PostalCode

Y Y Mailing Street Address

PCM XPath: //FindCandidate/ MailingAddress/ StreetAddressLine/ LineText

Y Y Mailing Territory Abbreviated Name

PCM XPath: //FindCandidate/ MailingAddress/ TerritoryAbbreviatedName

Y Y Mailing Territory Name

PCM XPath: //FindCandidate/ MailingAddress/ TerritoryOfficialName

Y Y Mailing Town Name The mailing city associated with the mailing address.

PCM XPath: //FindCandidate/ MailingAddress/ PrimaryTownName

Y Y Manufacturing Indicator Indicates whether or not manufacturing is done at this location.

PCM XPath: //FindCandidate/ ManufacturingIndicator

N Y Marketability Indicator Indicates whether or not the subject record satisfies D&B's global marketability rules

PCM XPath: //FindCandidate/ MarketabilityIndicator

Y Y Postal Code Zip code from inquiry request

PCM XPath: //FindCandidate/ PrimaryAddress/ PostalCode

Y Y Primary Business Name

PCM XPath: //FindCandidate/ OrganizationPrimaryName/ OrganizationName

N Y Publicly Traded Company Indicator

PCM XPath: //FindCandidate/ PubliclyTradedCompanyIndicator

Y Y Sales Revenue Amount (US Dollars)

PCM XPath: //FindCandidate/ SalesRevenueAmount

Y Y Standalone Organization Indicator

PCM XPath: //FindCandidate/ StandaloneOrganizationIndicator

N Y Stock Exchange Name A code used to identify the Stock Exchange at which the subjects Ticker Name is registered.

PCM XPath: //FindCandidate/ StockExchangeDetails/ StockExchangeName

N Y Stock Ticker Name

PCM XPath: //FindCandidate/ StockExchangeDetails/ StockExchangeTickerName

Y Y Street Address

PCM XPath: //FindCandidate/ PrimaryAddress/ StreetAddressLine/ LineText

Y Y Subject Handling Text

PCM XPath: //FindCandidate/ SubjectHandling/ SubjectHandlingText

Y Y Telephone Number The subjects Telephone Number within the telephone exchange. e.g., 422000 for D&B, High Wycombe, UKThis will also include the exchange code in those countries where this is applicable.If the telephone number cannot be parsed into its component parts then

PCM XPath: //FindCandidate/ TelephoneNumber/ TelecommunicationNumber

Y Y Telephone Number International Dialing Code International dialing code for country

PCM XPath: //FindCandidate/ TelephoneNumber/ InternationalDialingCode

Y Y Territory Abbreviated Name

PCM XPath: //FindCandidate/ PrimaryAddress/ TerritoryAbbreviatedName

Y Y Territory Name

PCM XPath: //FindCandidate/ PrimaryAddress/ TerritoryOfficialName

Y Y Town Name The name of the city or town in which the business is physically located.

PCM XPath: //FindCandidate/ PrimaryAddress/ PrimaryTownName

Y Y Trade Style Name Text recording the trade style name of the company. Trade styles are additional business names used by a company, also referred to as a DBA (doing business as) or AKA (also known as) name.

PCM XPath: //FindCandidate/ TradeStyleName/ OrganizationName

N Y Upward Family Member Publicly Traded Company Indicator

PCM XPath: //FindCandidate/ UpwardFamilyMemberPubliclyTradedCompanyIndicator

The preceding list is not presented in the order, nor manner, in which the information is packaged and delivered via the D&B Direct API. Legend: [C] = may be included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitored using an aggregate or attribute XPath.

Feature Notes

For the BASIC search option, the relevancy sort utilizes weighted values based on the match rate in the name and revenue fields, along with additional considerations.

For the ADVANCED search option, the relevancy option utilizes a proprietary algorithm for returning the best-matched results, taking into consideration input parameters sent in the request, along with additional weighted factors.