Industry Code Validation in Node.js — NAICS & NACE Classification

1. What are industry codes?

Industry classification codes are standardised systems for categorising the economic activities of businesses and organisations. They assign a numeric (or alphanumeric) code to every type of business activity — from agriculture and mining to software development and financial services.

The two most widely used systems are NAICS (North American Industry Classification System), used by the United States, Canada, and Mexico, and NACE (Nomenclature statistique des Activités économiques dans la Communauté Européenne), the standard across the European Union.

These codes appear everywhere: business registrations, tax filings, regulatory reports, loan applications, insurance underwriting, and KYC (Know Your Customer) processes. They provide a common language for government agencies, financial institutions, and businesses to describe what a company does.

Both systems are periodically revised — NAICS was last updated in 2022 and NACE uses Rev. 2 as its current edition. Using outdated codes can lead to misclassification, compliance issues, and rejected filings.

2. NAICS vs NACE comparison

While both systems serve the same purpose — classifying business activities — they differ in structure, geography, and granularity.

3. Code structure and hierarchy

Both NAICS and NACE organise industries into a tree-like hierarchy, from broad sectors down to specific activity types.

NAICS structure (2–6 digits)

NACE structure (Sections A–U)

4. Why industry code validation matters

5. The right solution

The IsValid Industry Code API provides two endpoints: a validate endpoint that checks whether an industry code is valid and returns its description, hierarchy, and system information, and a list endpoint that returns all codes for a given system, level, or parent code.

Get your free API key at isvalid.dev. The free tier includes 100 calls per day — enough for most development and low-volume production use.

Full parameter reference and response schema: Industry Code Validation API docs →

6. Node.js code example

Using the isvalid-sdk Node.js SDK or the built-in fetch API. Install with npm install isvalid-sdk.

// industry-validator.mjs
import { IsValid } from "isvalid-sdk";

const iv = new IsValid({ apiKey: process.env.ISVALID_API_KEY });

// ── Validate a NAICS code ───────────────────────────────────────────────

const result = await iv.industry("541511");

console.log(result.valid);       // true
console.log(result.system);      // 'NAICS'
console.log(result.description); // 'Custom Computer Programming Services'
console.log(result.level);       // '6-digit'
console.log(result.hierarchy);   // [{ code: '54', description: '...' }, ...]

// ── Validate a NACE code ────────────────────────────────────────────────

const nace = await iv.industry("62.01", { system: "nace" });

console.log(nace.valid);       // true
console.log(nace.system);      // 'NACE'
console.log(nace.description); // 'Computer programming activities'
console.log(nace.edition);     // 'Rev. 2'
console.log(nace.level);       // 'class'
console.log(nace.parent);      // '62.0'

// ── Check a sector-level NAICS code ─────────────────────────────────────

const sector = await iv.industry("54");

console.log(sector.description); // 'Professional, Scientific, and Technical Services'
console.log(sector.level);       // '2-digit'
console.log(sector.edition);     // '2022'

// List all 4-digit NAICS industry groups under sector 54
const groups = await iv.industry.list({
  system: "naics",
  level: "4-digit",
  parent: "54",
});

for (const g of groups) {
  console.log(`${g.code} — ${g.description}`);
}
// → 5411 — Legal Services
// → 5412 — Accounting, Tax Preparation, Bookkeeping...
// → ...
// → 5415 — Computer Systems Design and Related Services
// → ...

// app.mjs (Express)
import express from "express";
import { IsValid } from "isvalid-sdk";

const app = express();
app.use(express.json());

const iv = new IsValid({ apiKey: process.env.ISVALID_API_KEY });

app.post("/businesses", async (req, res) => {
  const { name, industryCode, country } = req.body;

  // Determine the system based on region
  const system = ["US", "CA", "MX"].includes(country) ? "naics" : "nace";

  // Validate the industry code
  const check = await iv.industry(industryCode, { system });

  if (!check.valid) {
    return res.status(400).json({
      error: "Invalid industry code",
      hint: `Provide a valid ${system.toUpperCase()} code`,
    });
  }

  // Use the validated data
  const business = await saveBusiness({
    name,
    industryCode: check.code,
    industryDescription: check.description,
    industrySystem: check.system,
    industryLevel: check.level,
    hierarchy: check.hierarchy,
    country,
  });

  res.json({ success: true, business });
});

app.listen(3000);

7. cURL example

Validate a NAICS code:

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

Validate a NACE code:

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

Validate a NAICS sector:

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

List NAICS codes under a parent:

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

8. Understanding the response

Response for a NAICS code:

{
  "valid": true,
  "system": "NAICS",
  "edition": "2022",
  "code": "541511",
  "description": "Custom Computer Programming Services",
  "level": "6-digit",
  "parent": "54151",
  "hierarchy": [
    { "code": "54", "description": "Professional, Scientific, and Technical Services" },
    { "code": "541", "description": "Professional, Scientific, and Technical Services" },
    { "code": "5415", "description": "Computer Systems Design and Related Services" },
    { "code": "54151", "description": "Computer Systems Design and Related Services" }
  ]
}

Response for a NACE code:

{
  "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" }
  ]
}

Invalid industry code:

{
  "valid": false
}

9. Edge cases to handle

// Code 519130 was valid in NAICS 2017 but restructured in 2022
const old = await iv.industry("519130");
console.log(old.valid); // may be false in 2022 edition

// Always validate against the current edition
const current = await iv.industry("541511");
console.log(current.valid);   // true
console.log(current.edition); // '2022'

// NACE codes use dot notation
const nace = await iv.industry("62.01", { system: "nace" });
console.log(nace.valid); // true

// NACE section (single letter)
const section = await iv.industry("J", { system: "nace" });
console.log(section.description); // 'Information and communication'