# Industry and Occupation Codes

NAICS 2022 industry codes and SOC 2018 occupation codes: lookup, search, hierarchy and industry-occupation links from Census and BLS.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://industry-occupation-codes.x402tookit.com/openapi.json
- x402 manifest: https://industry-occupation-codes.x402tookit.com/.well-known/x402
- Catalog (free): https://industry-occupation-codes.x402tookit.com/catalog
- Health (free): https://industry-occupation-codes.x402tookit.com/health
- Uptime (free): https://industry-occupation-codes.x402tookit.com/uptime

## Endpoints (8)

### GET /code-crosswalk-hint — $0.03
Link a NAICS industry to its top SOC occupations, or a SOC occupation to its top industries, from the BLS employment matrix.
Params: naics?: string, soc?: string, limit?: integer
Example: https://industry-occupation-codes.x402tookit.com/code-crosswalk-hint?naics=541511&limit=5

### GET /code-validate — $0.02
Check whether a code is a valid NAICS 2022 or SOC 2018 code, at what level, and which system it belongs to.
Params: code: string, system?: string
Example: https://industry-occupation-codes.x402tookit.com/code-validate?code=151252

### GET /naics-children — $0.02
List the codes one level below a NAICS 2022 code (sector to national industry); omit the code to list the 20 sectors.
Params: code?: string
Example: https://industry-occupation-codes.x402tookit.com/naics-children?code=5415

### GET /naics-lookup — $0.02
NAICS 2022 code to title, level (sector to national industry) and full parent chain. Census Bureau data.
Params: code: string
Example: https://industry-occupation-codes.x402tookit.com/naics-lookup?code=541511

### GET /naics-search — $0.02
Search NAICS 2022 industry codes by words in the title or a code prefix; optional level filter; capped at 50.
Params: q: string, level?: integer, limit?: integer
Example: https://industry-occupation-codes.x402tookit.com/naics-search?q=computer+programming&limit=5

### GET /soc-children — $0.02
List the codes one level below a SOC 2018 code (major to minor to broad to detailed); omit the code for the 23 major groups.
Params: code?: string
Example: https://industry-occupation-codes.x402tookit.com/soc-children?code=15-1200

### GET /soc-lookup — $0.02
SOC 2018 occupation code to title, level (major group to detailed occupation), parent chain and US employment.
Params: code: string
Example: https://industry-occupation-codes.x402tookit.com/soc-lookup?code=15-1252

### GET /soc-search — $0.02
Search SOC 2018 occupations by words in the title or a code prefix; optional level filter; capped at 50.
Params: q: string, level?: integer, limit?: integer
Example: https://industry-occupation-codes.x402tookit.com/soc-search?q=nurse&level=4&limit=5

## Terms

Classification data from the US Census Bureau (NAICS 2022) and the Bureau of Labor Statistics (SOC 2018 and the 2025-35 National Employment Matrix), US public domain, provided as is. Code lists are revised periodically; the industry-occupation links are BLS employment estimates grouped by BLS matrix industries, not a legal crosswalk. Not for regulatory, licensing, tax or eligibility decisions; verify at census.gov/naics and bls.gov/soc.