Find Industry Codes
Product | D&B Direct 2.0, D&B Direct Onboard |
Product Code(s) | Not Applicable |
Options(s) | None |
Monitoring Available | No |
Interface | REST |
Method | GET |
Format(s) | JSON |
Service | EntityList |
{version} | 6.2 |
6.2 Released On | January 29, 2016 |
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
GET https://direct.dnb.com/V6.1/industries?KeywordText=hardware&findindustry=true 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.
Name | Characteristics |
---|---|
IndustryCodeTypeCode-n | Attribute Possible values: 19295 [UK SIC 2007]; 3599 [D&B Standard Industry Code]; 700 [NAICS] |
IndustryCode-n | 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). |
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. |
SortDirectionText | SortDirectionEnum, Optional Text that indicates the direction of sorting; e.g., Ascending,Descending. |
SortBasisText | FindIndustrySortBasis, Optional Text denoting the data based on which the result set should be sorted; e.g., IndustryCode, IndustryDescription |
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. |
CustomerReferenceText-n | string, at least 1 char, up to 240 chars, Optional (up to 5x) |
CustomerBillingEndorsementText | string at least 1 chars. 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.
REST (EntityList) |
---|
GET https://direct.dnb.com/V{version}/industries?findindustry |
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.
{"FindIndustryResponse": { "@ServiceVersionNumber": "6.0", "TransactionDetail": { "ServiceTransactionID": "Id-1baefd935255a8fd17db990e-1", "TransactionTimestamp": "2013-10-09T15:05:33" }, "TransactionResult": { "SeverityText": "Information", "ResultID": "CM000", "ResultText": "Success", "ResultMessage": [{"ResultDescription": "Industry Code Data Successfully Retrieved"}] }, "FindIndustryResponseDetail": {"IndustryCode": [ { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1858", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Electrical, Plumbing & Hardware Wholesalers" }], "IndustryExplanationText": "electrical, plumbing, and hardware equipment, materials, and supplies." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1179", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Window Covering & Wall Covering Manufacturing" }], "IndustryExplanationText": "manufacture products that cover windows and walls. Window coverings include blinds, curtains, drapes, screens, and shades, along with related hardware. Wall coverings include wallpaper." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1533", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Floor & Window Coverings Stores" }], "IndustryExplanationText": "sell floor coverings and window treatments. Floor covering products can include carpets and rugs, and floor tile and vinyl floor coverings. Window treatment products include curtains, drapes, blinds, and shades. Companies that primarily retail ceramic or wood floor coverings are not included in this industry." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1095", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Network Security Device Manufacturing" }], "IndustryExplanationText": "design and manufacture firewall and virtual private network (VPN) appliances, cryptographic accelerator cards, card-based network access systems, and other network security hardware. Network security devices allow for data privacy, protection, and encryption of Web-based communications and transactions." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1123", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Asset Management Software" }], "IndustryExplanationText": "design, develop, market, and support software for tracking, monitoring, and managing enterprise assets and inventory, such as computer hardware, software, labor, materials, tools, and equipment. This software is marketed to large corporations, government agencies, and schools, among other customers." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1120", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Technology & Office Equipment Leasing" }], "IndustryExplanationText": "lease computer hardware, IT infrastructure equipment, and office machinery. Products include computers, copiers, and printers, as well as security, storage, and networking equipment. Companies in this industry may provide leasing services, such as financing and technical support." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1130", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Development Tools, Operating Systems & Utilities Software" }], "IndustryExplanationText": "Companies in this industry design, develop, publish, and support software. Development tools are applications used by software developers to create, debug, and maintain other programs. Operating systems manage computer hardware resources and allow applications to run. Utilities software is used to tune the computer hardware, operating system or application software by performing tasks including disk storage utilities, system profilers, anti-virus, data compression, and network managers." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1539", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Home Centers & Hardware Stores" }], "IndustryExplanationText": "tools, building materials, paint and wallpaper, garden supplies, and other items used in home improvement, maintenance, and construction." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1395", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Hardware & Fastener Manufacturing" }], "IndustryExplanationText": "manufacture fasteners and other precision turned products. Examples of fasteners include bolts, nuts, rivets, and screws used to fasten metal, wood, and other materials together. Companies that manufacture cotter pins, hooks, and washers are also included in this industry." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1454", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Motion Picture Equipment Manufacturing" }], "IndustryExplanationText": "manufacture equipment used to create motion pictures. Types of equipment include cameras, audio recording and mixing devices, lights, editing systems, and other hardware. The products manufactured are professional grade and differ from audio and video equipment intended for personal and consumer use. Companies that make computer software used to edit footage are covered separately." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1146", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Storage & Systems Management Software" }], "IndustryExplanationText": "design, develop, publish, and support software for managing and monitoring computer hardware, software, and network infrastructure. Applications are made to automtate and manage data storage, data backup and recovery, and data replication. Makers of this software market to customers in the enterprise, government, and education sectors." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1113", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "ATM & Other Self-Service Terminal Manufacturing" }], "IndustryExplanationText": "design and manufacture automated teller machines (ATMs), banking kiosks, lottery ticket terminals, and other self-service terminals. Such specialized computer systems combine hardware and software to perform specific functions. Companies that manufacture point-of-sale retail systems are not included in this industry." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1627", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Industrial Equipment Wholesalers" }], "IndustryExplanationText": "<p>Companies in this industry distribute industrial equipment, machinery, and/or related components and parts. Distributed goods include manufacturing and assembling machinery, construction equipment, earthmoving machines, cranes, hardware, pumps, motors, and other equipment. Supplies like bearings, gaskets, packing materials, and containers are also distributed. Consisting of wholesalers, this industry's companies employ trade agents, brokers, and other personnel who serve as middlemen between buyers and sellers.<\/p>" }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "2047", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Building Material Dealers" }], "IndustryExplanationText": "materials and supplies used in the construction and maintenance of buildings." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1401", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Fabricated Metal Product Manufacturing" }], "IndustryExplanationText": "iron, steel, or other metals into metal parts and finished products." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1207", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Toy & Game Manufacturing" }], "IndustryExplanationText": "toys, games, puzzles, and collectibles." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1149", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Construction Sector" }], "IndustryExplanationText": "engage primarily in the construction and maintenance of buildings or infrastructure projects such as roads and bridges. General as well as specialty contractors are included. Establishments primarily engaged in preparing sites for new construction and establishments primarily engaged in subdividing land for sale as building sites also are included in this sector." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1388", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Industrial Manufacturing" }], "IndustryExplanationText": "manufacture products for industrial use, including rubber and plastic products, packaging and containers, paper and paper products, and textiles. Many products in this industry are sold primarily for use by businesses rather than directly by consumers." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1173", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Electronic Toys & Games Manufacturing" }], "IndustryExplanationText": "electronic gaming devices, electronic toys and games, and accessories." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1136", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Entertainment & Games Software" }], "IndustryExplanationText": "entertainment and games software." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1994", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Wood Window & Door Manufacturing" }], "IndustryExplanationText": "wooden windows and doors." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1941", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Paint & Wallpaper Stores" }], "IndustryExplanationText": "paint and wallpaper products." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1119", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Information Technology Services" }], "IndustryExplanationText": "services related to information technology, such as consulting, installation, systems integration, software development, and support." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1109", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Data Storage Systems Manufacturing" }], "IndustryExplanationText": "Companies in this industry design and manufacture data storage systems based on magnetic and optical technologies. Utilizing fixed and removable media, products range from disk drives for personal computers to large-scale data storage systems for enterprise applications." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1525", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Computer & Software Stores" }], "IndustryExplanationText": "personal computers, networking equipment, peripherals, and software to individuals, businesses, and other end-users through retail stores, Web sites, and direct marketing." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1843", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Computer Manufacturing" }], "IndustryExplanationText": "computers and peripheral equipment." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1547", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Internet & Mail-Order Retail" }], "IndustryExplanationText": "products over the Internet or via catalogs, toll-free telephone numbers, or electronic media such as interactive television." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1881", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Garden Centers & Farm Supply Stores" }], "IndustryExplanationText": "nursery and garden products that are predominately grown elsewhere." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1526", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Consumer Electronics & Appliances Stores" }], "IndustryExplanationText": "consumer electronics and appliances including TVs, VCRs, DVD players, PCs, wireless and conventional phones, stereos and speakers, video game consoles, and various home appliances." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1554", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Office Supply Stores" }], "IndustryExplanationText": "sell office supplies and stationery. These establishments include office supply stores, school supply stores, and stationery stores. Companies that retail new office equipment and furniture are also included in this industry." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1605", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Freight Forwarding Services" }], "IndustryExplanationText": "the movement of freight by various transportation methods, including air, sea, and land, on behalf of exporters and importers." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1996", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Handtool, Cutlery & Flatware Manufacturing" }], "IndustryExplanationText": "cutlery, flatware, and handtools." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1946", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Pet & Pet Supplies Stores" }], "IndustryExplanationText": "pets, pet foods, and pet supplies." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1942", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Painting & Wall Covering Contractors" }], "IndustryExplanationText": "interior and exterior wall painting and wall covering services." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1976", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Sign Manufacturing" }], "IndustryExplanationText": "signs and related displays." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1444", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Fast-Food & Quick-Service Restaurants" }], "IndustryExplanationText": "eating places that provide a quick dining experience." }, { "@TypeText": "D&B Hoovers Industry Code", "@DNBCodeValue": 25838, "IndustryCode": "1093", "IndustryCodeDescription": [ { "@IndustryCodeDescriptionLengthCode": 9120, "$": "Computer Networking Equipment Manufacturing" }], "IndustryExplanationText": "network access and communication devices, routing and switching equipment, storage networking equipment, and wireless networking products." } ]} }}
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.