Find Industry Codes

Returns D&B industry codes that match the specified keyword.

Feature Request

IMPORTANT: Please see the new Online Services Security Enhancement Release, effective November 09, 2020.

Overview

When requesting this feature, a valid Industrial Classification code (explanation below) or keyword is required. Multiple codes may be submitted in a single request, however, only one keyword may be submitted per request.

Sorting Results: By default, the results from this service will be ascending by ???. Optionally, both the sort direction and a primary sort field can be designated on the request.

Pagination: This feature provides a single set of results.

Industrial Classifications

Any of the following may be used to initiate a request from this feature;

NAICS Code: The North American Industry Classification System (NAICS) was developed jointly by the U.S., Canada, and Mexico to provide new comparability in statistics about business activity across North America.

SIC Code (US): A four-digit numeric coding system developed by the United States government for the classification of industrial activities. The Standard Industrial Classification (SIC) was replaced by NAICS starting in 1997.

SIC Code (UK): An industry coding scheme defined by the UK government's Office for National Statistics Classifications and Harmonisation based on the Classification of Economic Activities (NACE) Revision.2 classification.

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.

• This 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

<soapenv:Envelope xmlns:ent="http://services.dnb.com/EntityListServiceV2.0" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header>
      <wsse:Security soapenv:mustUnderstand="0" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
         <wsse:UsernameToken wsu:Id="UsernameToken-1">
            <wsse:Username>MyUsername</wsse:Username>
            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">MyPassword</wsse:Password>
         </wsse:UsernameToken>
      </wsse:Security>    
   </soapenv:Header>
   <soapenv:Body>
      <ent:FindIndustryRequest ServiceVersionNumber="4.0">
         <TransactionDetail>
            <ApplicationTransactionID>ID</ApplicationTransactionID>
         </TransactionDetail>
         <FindIndustryRequestDetail>
            <InquiryDetail>
               <IndustryCode DNBCodeValue="3599">
                  <IndustryCode>011</IndustryCode>
               </IndustryCode>
            </InquiryDetail>
         </FindIndustryRequestDetail>
      </ent:FindIndustryRequest>
   </soapenv:Body>
</soapenv:Envelope>

Endpoint

Use the following endpoint with the downloadable WSDL to request this feature.

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

Specification

The following is a list of the possible data fields returned by this operation in the XML 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.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Body xmlns:ent="http://services.dnb.com/EntityListServiceV2.0">
      <ent:FindIndustryResponse ServiceVersionNumber="6.0">
         <TransactionDetail>
            <ApplicationTransactionID>ID</ApplicationTransactionID>
            <ServiceTransactionID>Id-091a1dff523cb58a17fb742e-1</ServiceTransactionID>
            <TransactionTimestamp>2013-09-20T16:52:26</TransactionTimestamp>
         </TransactionDetail>
         <TransactionResult>
            <SeverityText>Information</SeverityText>
            <ResultID>CM000</ResultID>
            <ResultText>Success</ResultText>
            <ResultMessage>
               <ResultDescription>Industry Code Data Successfully Retrieved</ResultDescription>
            </ResultMessage>
         </TransactionResult>
         <FindIndustryResponseDetail>
            <IndustryCode TypeText="D&amp;B Hoovers Industry Code" DNBCodeValue="25838">
               <IndustryCode>1015</IndustryCode>
               <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Crop Production</IndustryCodeDescription>
               <IndustryExplanationText>crops used mainly for food and fiber.</IndustryExplanationText>
            </IndustryCode>
            <IndustryCode TypeText="D&amp;B Hoovers Industry Code" DNBCodeValue="25838">
               <IndustryCode>1938</IndustryCode>
               <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Oilseed Farming</IndustryCodeDescription>
               <IndustryExplanationText>soybean and other oilseed crops and seeds.</IndustryExplanationText>
            </IndustryCode>
            <IndustryCode TypeText="D&amp;B Hoovers Industry Code" DNBCodeValue="25838">
               <IndustryCode>2027</IndustryCode>
               <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Grain Farming</IndustryCodeDescription>
               <IndustryExplanationText>fibrous grains and grain seeds.</IndustryExplanationText>
            </IndustryCode>
            <IndustryCode TypeText="D&amp;B Hoovers Industry Code" DNBCodeValue="25838">
               <IndustryCode>2026</IndustryCode>
               <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Agriculture &amp; Forestry Sector</IndustryCodeDescription>
               <IndustryExplanationText>grow crops, raise animals, raise and harvest fish, and harvest timber. Companies may operate farms, ranches, greenhouses, nurseries, orchards, or hatcheries. Besides producers, the sector includes companies that provide support services for agricultural operations, such as soil preparation, planting, and harvesting.</IndustryExplanationText>
            </IndustryCode>
         </FindIndustryResponseDetail>
      </ent:FindIndustryResponse>
   </soapenv:Body>
</soapenv:Envelope>

NOTE: There may be additional request and/or response elements specified in the WSDL that are not applicable for D&B Direct customers. Data elements that are not listed on this page are currently unused by this operation.

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: CM001, CM002, CM003, CM004, CM005, CM007, CM012, CM018, 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]).

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.

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 each matching result, this feature returns the D&B industry code, industry code name and a short overview explaining the industry.

An option exists to return only industries that have information available in the Research - Industry Code product.

• © Dun & Bradstreet, Inc. 2019 – 2024. All rights reserved.