Industry Code (NAICS / NACE)

GET/v0/industry

Validates an industry classification code against NAICS 2022 (North American Industry Classification System, ~2100 codes) and NACE Rev. 2 (EU Statistical Classification, ~1000 codes). Automatically detects the classification system or accepts an explicit system parameter. Returns the code description, hierarchy level, parent, and full ancestor chain.

Guides: Node.js · Python

Try it

Query Parameters

Param	Type	Required	Description
value	string	Yes	Industry code (e.g. `5132` for NAICS, `62.01` for NACE)
system	string	No	Classification system: `naics` or `nace` (auto-detected if omitted)

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/industry?value=5132&system=naics"

Response Fields

Field	Type	Description
valid	boolean	Whether the code was found
system	string	NAICS or NACE
edition	string	Classification edition (e.g. "2022" for NAICS, "Rev. 2" for NACE)
code	string	The matched code
description	string	Code description / title
level	string	Hierarchy level (NAICS: sector / subsector / industry_group / industry / national_industry; NACE: section / division / group / class)
parent	string \| null	Parent code
hierarchy	array	Full ancestor chain from top to parent
error	string	Error message when not found

Example Response — NAICS

{
  "valid": true,
  "system": "NAICS",
  "edition": "2022",
  "code": "5132",
  "description": "Software Publishers",
  "level": "industry_group",
  "parent": "513",
  "hierarchy": [
    { "code": "51", "description": "Information" },
    { "code": "513", "description": "Publishing Industries" }
  ]
}

Example Response — NACE

{
  "valid": true,
  "system": "NACE",
  "edition": "Rev. 2",
  "code": "62.01",
  "description": "Computer programming activities",
  "level": "class",
  "parent": "62.0",
  "hierarchy": [
    { "code": "J", "description": "INFORMATION AND COMMUNICATION" },
    { "code": "62", "description": "Computer programming, consultancy and related activities" },
    { "code": "62.0", "description": "Computer programming, consultancy and related activities" }
  ]
}

GET/v0/industry/list

Returns industry codes for a given classification system. Filter by hierarchy level or parent code.

Query Parameters

Param	Type	Required	Description
system	string	Yes	`naics` or `nace`
level	string	No	Filter by level (e.g. sector, division)
parent	string	No	Filter by parent code

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/industry/list?system=naics&level=sector"

Example Response

[
  { "code": "11", "level": "sector", "parent": null, "description": "Agriculture, Forestry, Fishing and Hunting" },
  { "code": "21", "level": "sector", "parent": null, "description": "Mining, Quarrying, and Oil and Gas Extraction" },
  { "code": "22", "level": "sector", "parent": null, "description": "Utilities" },
  ...
]