Find Industry Codes
Product | D&B Direct 2.0, D&B Direct Onboard |
Product Code(s) | Not Applicable |
Option(s) | None |
Monitoring Available | No |
Interface | SOAP |
WSDL | download |
Format(s) | XML |
Service | EntityList |
Operation | FindIndustry |
{version} | 6.4 |
6.4 Released On | October 6, 2017 |
Returns D&B industry codes that match the specified keyword.
Update History
No modifications have been made to this data layer since the initial release.
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="1" wsu:Id="Id-0001354195101822-0000000031631e87-1" 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-2"> <wsse:Username>MyUserName</wsse:Username> <wsse:Password>MyPassword</wsse:Password> </wsse:UsernameToken> </wsse:Security> </soapenv:Header> <soapenv:Body> <ent:FindIndustryRequest ServiceVersionNumber="6.4"> <TransactionDetail> <ApplicationTransactionID>Test123</ApplicationTransactionID> </TransactionDetail> <FindIndustryRequestDetail> <InquiryDetail> <KeywordText>Petroleum</KeywordText> </InquiryDetail> <FindIndustrySpecification> <SortDirectionText>Ascending</SortDirectionText> <SortBasisText>IndustryDescription</SortBasisText> <ReturnOnlyPremiumIndustryIndicator>false</ReturnOnlyPremiumIndustryIndicator> </FindIndustrySpecification> <InquiryReferenceDetail> <CustomerReferenceText>CompanySearch1</CustomerReferenceText> <CustomerBillingEndorsementText>CompanySearch1</CustomerBillingEndorsementText> </InquiryReferenceDetail> </FindIndustryRequestDetail> </ent:FindIndustryRequest> </soapenv:Body> </soapenv:Envelope>
Name | Characteristics |
---|---|
FindIndustryRequest | Aggregate |
FindIndustryRequest. FindIndustryRequestDetail | Aggregate, Required Records the search criteria to find the potential list of industries and the parameters to refine the search result. |
FindIndustryRequest. FindIndustryRequestDetail. InquiryDetail | Aggregate, Required Records search criteria to find the potential list of industries; e.g., US SIC, UK SIC, Keyword |
FindIndustryRequest. FindIndustryRequestDetail. InquiryDetail. 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. Currently only the industry coding schemes UK SIC, US SIC and NAICS are supported. |
FindIndustryRequest. FindIndustryRequestDetail. InquiryDetail. IndustryCode@DNBCodeValue | Attribute Possible values: 19295 [UK SIC 2007]; 3599 [D&B Standard Industry Code]; 700 [NAICS] |
FindIndustryRequest. FindIndustryRequestDetail. InquiryDetail. 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). |
FindIndustryRequest. FindIndustryRequestDetail. InquiryDetail. KeywordText | string up to 256 chars., Optional Text used as an index term to retrieve search results. KeywordText can consist of a word, phrase or an alphanumerical term. |
END: FindIndustryRequest. FindIndustryRequestDetail. InquiryDetail | /Aggregate |
FindIndustryRequest. FindIndustryRequestDetail. FindIndustrySpecification | Aggregate, Optional Records the parameters for refining the search result. |
FindIndustryRequest. FindIndustryRequestDetail. FindIndustrySpecification. SortDirectionText | SortDirectionEnum, Optional Text that indicates the direction of sorting; e.g., Ascending,Descending. |
FindIndustryRequest. FindIndustryRequestDetail. FindIndustrySpecification. SortBasisText | FindIndustrySortBasis, Optional Text denoting the data based on which the result set should be sorted; e.g., IndustryCode, IndustryDescription |
FindIndustryRequest. FindIndustryRequestDetail. FindIndustrySpecification. ReturnOnlyPremiumIndustryIndicator | boolean, Optional When true (set to 1), only the industries part of First Research Industry List have to be listed in the search response. When false (set to 0), all the industries that match the search criteria have to be listed in the search response. |
END: FindIndustryRequest. FindIndustryRequestDetail. FindIndustrySpecification | /Aggregate |
FindIndustryRequest. FindIndustryRequestDetail. InquiryReferenceDetail | Aggregate, Optional (Array) Records data that allows the customer to specify information to be linked to this request in order to support subsequent searches. |
FindIndustryRequest. FindIndustryRequestDetail. InquiryReferenceDetail. CustomerReferenceText | string at least 1 chars. up to 240 chars., Optional(Up to 5x) |
FindIndustryRequest. FindIndustryRequestDetail. InquiryReferenceDetail. CustomerBillingEndorsementText | string at least 1 chars. up to 240 chars., Optional |
END: FindIndustryRequest. FindIndustryRequestDetail. InquiryReferenceDetail | /Aggregate |
END: FindIndustryRequest. FindIndustryRequestDetail | /Aggregate |
END: FindIndustryRequest | /Aggregate |
Endpoint
Use the following endpoint with the downloadable WSDL to request this feature.
SOAP (EntityList) |
---|
https://direct.dnb.com/EntityList/V{version} |
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/" 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" xmlns:ser="http://services.dnb.com/ServiceHeaderV2.0"> <soapenv:Body> <ns2:FindIndustryResponse ServiceVersionNumber="6.4" xmlns:ns3="http://services.dnb.com/TransactionFaultV2.0" xmlns:ns2="http://services.dnb.com/EntityListServiceV2.0"> <TransactionDetail> <ApplicationTransactionID>Test123</ApplicationTransactionID> <ServiceTransactionID>Id-76dfc859c53a0200193a0700b3e7d48c-1</ServiceTransactionID> <TransactionTimestamp>2017-09-25T10:50:30</TransactionTimestamp> </TransactionDetail> <TransactionResult> <SeverityText>Information</SeverityText> <ResultID>CM000</ResultID> <ResultText>Success</ResultText> <ResultMessage> <ResultDescription>Industry Code Data Successfully Retrieved</ResultDescription> </ResultMessage> </TransactionResult> <FindIndustryResponseDetail> <CandidateMatchedQuantity>41</CandidateMatchedQuantity> <CandidateReturnedQuantity>25</CandidateReturnedQuantity> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>2016</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Asphalt Products Manufacturing</IndustryCodeDescription> <IndustryExplanationText>manufacture asphalt and tar paving materials, as well as roofing cements and coatings. This industry also includes companies that saturated purchased mats and felts with purchased asphalt or tar.</IndustryExplanationText> <DisplaySequence>8</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1822</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Biofuel Manufacturing</IndustryCodeDescription> <IndustryExplanationText>manufacture ethanol and biodiesel.</IndustryExplanationText> <DisplaySequence>16</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1023</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Boat Building</IndustryCodeDescription> <IndustryExplanationText>pleasure boats, sail boats, or yachts.</IndustryExplanationText> <DisplaySequence>19</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1088</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Chemical Wholesalers</IndustryCodeDescription> <IndustryExplanationText>chemicals and/or gases.</IndustryExplanationText> <DisplaySequence>25</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1279</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Crude Petroleum Pipelines</IndustryCodeDescription> <IndustryExplanationText>provide transportation of crude oil via pipeline. Companies that provide pipeline transportation of refined petroleum products and natural gas are covered separately.</IndustryExplanationText> <DisplaySequence>7</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1611</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Deep Sea Freight Transportation</IndustryCodeDescription> <IndustryExplanationText>the international overseas shipping of freight.</IndustryExplanationText> <DisplaySequence>15</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1861</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Engineering Services</IndustryCodeDescription> <IndustryExplanationText>engineering services, including the design and development of machines, materials, processes, structures, and systems.</IndustryExplanationText> <DisplaySequence>22</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1401</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Fabricated Metal Product Manufacturing</IndustryCodeDescription> <IndustryExplanationText>iron, steel, or other metals into metal parts and finished products.</IndustryExplanationText> <DisplaySequence>12</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1878</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Fuel Oil & LP Gas Dealers</IndustryCodeDescription> <IndustryExplanationText>fuel oil and liquefied petroleum gas.</IndustryExplanationText> <DisplaySequence>1</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1286</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Geophysical Surveying & Mapping Services</IndustryCodeDescription> <IndustryExplanationText>provide geophysical surveying and related analysis services. Geophysical surveys can include gravity, magnetic, or seismic surveys and may be used to help locate resources such as oil, gas, and minerals. Companies that perform geophysical surveys and mapping for engineering purposes are also included in this industry.</IndustryExplanationText> <DisplaySequence>9</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1295</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Hazardous Waste Services</IndustryCodeDescription> <IndustryExplanationText>operate treatment or disposal facilities that specialize in hazardous waste. This industry also includes companies that collect and transport hazardous waste within a local area.</IndustryExplanationText> <DisplaySequence>20</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1087</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Industrial Chemical Manufacturing</IndustryCodeDescription> <IndustryExplanationText>basic inorganic and organic chemicals, including acids, alcohols, aromatics, benzene, ethylene, industrial gases, methanol, olefins, polyethylene, and polypropylene.</IndustryExplanationText> <DisplaySequence>17</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1612</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Inland Water Freight Transportation</IndustryCodeDescription> <IndustryExplanationText>provide transportation of freight on lakes, rivers, or intracoastal waterways (except the Great Lakes system).</IndustryExplanationText> <DisplaySequence>14</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1623</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Less-Than-Truckload Carriers</IndustryCodeDescription> <IndustryExplanationText>provide transportation of less-than-truckload (LTL) shipments. LTL carriers consolidate multiple shipments into a single truckload. These establishments may offer regional, interregional, and long-distance freight hauling.</IndustryExplanationText> <DisplaySequence>21</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>2040</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Metal Valve & Pipe Fitting Manufacturing</IndustryCodeDescription> <IndustryExplanationText>metal valves and pipe fittings, including industrial valves; fluid power valves and hose fittings; plumbing fixture fittings and trim; and other metal valves and pipe fittings.</IndustryExplanationText> <DisplaySequence>24</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1284</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Oil & Gas Exploration & Production</IndustryCodeDescription> <IndustryExplanationText>upstream oil and gas activities, such as the exploration, development, and production of crude petroleum and/or natural gas.</IndustryExplanationText> <DisplaySequence>6</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1287</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Oil & Gas Field Equipment Manufacturing</IndustryCodeDescription> <IndustryExplanationText>manufacture machinery and equipment used in oil and gas exploration and production. Makers of water well drilling machinery also are included in the industry.</IndustryExplanationText> <DisplaySequence>11</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1288</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Oil & Gas Field Services</IndustryCodeDescription> <IndustryExplanationText>services related to exploration and production of crude oil and natural gas, including drilling as well as support services.</IndustryExplanationText> <DisplaySequence>10</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1278</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Oil & Gas Transportation & Storage</IndustryCodeDescription> <IndustryExplanationText>provide pipeline transportation or storage of crude oil, natural gas, and other refined petroleum products. The industry also includes establishments that operate natural gas gathering and processing systems.</IndustryExplanationText> <DisplaySequence>5</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>2015</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Petroleum & Coal Products Manufacturing</IndustryCodeDescription> <IndustryExplanationText>manufacture coal and petroleum products. Goods include asphalt paving material, lubricating oil, and other petroleum products. This industry includes petroleum refineries.</IndustryExplanationText> <DisplaySequence>2</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1264</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Petroleum & Petroleum Products Wholesalers</IndustryCodeDescription> <IndustryExplanationText>the wholesale distribution of petroleum and petroleum products, except those with bulk liquid storage facilities. This includes packaged and bottled petroleum products distributors, truck jobbers, and others marketing petroleum products wholesale.</IndustryExplanationText> <DisplaySequence>3</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>2038</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Petroleum Refining</IndustryCodeDescription> <IndustryExplanationText/> <DisplaySequence>13</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1282</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Refined Petroleum Pipelines</IndustryCodeDescription> <IndustryExplanationText>operate pipelines used to transport refined petroleum products, including gasoline, fuel oil, and liquid natural gas. This industry also includes companies that operate booster pumping stations.</IndustryExplanationText> <DisplaySequence>4</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1610</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Water Transportation Services</IndustryCodeDescription> <IndustryExplanationText>provide transportation of freight and passengers over water. Included in the industry are providers of deep sea, coastal, and Great Lakes water transportation, as well as providers of inland water transportation. Operators of ferries and cruise ships are part of this industry.</IndustryExplanationText> <DisplaySequence>18</DisplaySequence> </IndustryCode> <IndustryCode TypeText="D&B Hoovers Industry Code" DNBCodeValue="25838"> <IndustryCode>1800</IndustryCode> <IndustryCodeDescription IndustryCodeDescriptionLengthCode="9120">Wholesale Sector</IndustryCodeDescription> <IndustryExplanationText>merchandise to other businesses.</IndustryExplanationText> <DisplaySequence>23</DisplaySequence> </IndustryCode> </FindIndustryResponseDetail> </ns2: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.
Name | Description |
---|---|
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: //IndustryCode/ IndustryCode |
Industry Code Description | PCM XPath: //IndustryCode/ IndustryCodeDescription |
Short Overview | A short overivew about the industry PCM XPath: //IndustryCode/ IndustryExplanationText |
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.