{"openapi":"3.1.0","info":{"title":"Industry and Occupation Codes","version":"1.0.0","description":"NAICS 2022 industry codes and SOC 2018 occupation codes: lookup, search, hierarchy and industry-occupation links from Census and BLS. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"Industry and Occupation Codes: NAICS 2022 industry codes and SOC 2018 occupation codes: lookup, search, hierarchy and industry-occupation links from Census and BLS. Use /naics-lookup for a NAICS 2022 code with its level and parent chain, /naics-search to find codes by words, /naics-children for the next level down, /soc-lookup, /soc-search and /soc-children for SOC 2018 occupations, /code-crosswalk-hint for the occupations most employed in an industry or the industries that employ an occupation (BLS matrix), and /code-validate to identify and validate any NAICS or SOC code. Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://industry-occupation-codes.x402tookit.com"}],"paths":{"/code-crosswalk-hint":{"get":{"operationId":"code_crosswalk_hint","summary":"Link a NAICS industry to its top SOC occupations, or a SOC occupation to its top industries, from the BLS employment matrix.","description":"Link a NAICS industry to its top SOC occupations, or a SOC occupation to its top industries, from the BLS employment matrix.","tags":["naics","soc","crosswalk","employment","bls"],"parameters":[{"name":"naics","in":"query","required":false,"description":"NAICS 2022 code (2 to 6 digits) to list its top occupations; use this or soc","schema":{"type":"string"}},{"name":"soc","in":"query","required":false,"description":"SOC 2018 code (detailed, broad, minor or major) to list its top industries; use this or naics","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Rows 1 to 30 (default 10)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"matrixEdition":{"type":["null","string"]},"direction":{"type":["null","string"]},"naics":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"title":{"type":["null","string"]}}},"matchMode":{"type":["null","string"]},"matchedMatrixIndustries":{"type":["array","null"],"items":{"type":"object","properties":{"matrixIndustryCode":{"type":["null","string"]},"title":{"type":["null","string"]},"type":{"type":["null","string"]},"employment2025Thousands":{"type":["null","number"]},"naicsPrefixes":{"type":["array","null"],"items":{"type":"string"}}}}},"industryEmployment2025Thousands":{"type":["null","number"]},"occupationsWithJobs":{"type":["null","number"]},"topOccupations":{"type":["array","null"],"items":{"type":"object","properties":{"socCode":{"type":["null","string"]},"title":{"type":["null","string"]},"employment2025Thousands":{"type":["null","number"]},"shareOfIndustryEmploymentPct":{"type":["null","number"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"LINKED","summary":"NAICS 541511 Custom Computer Programming Services: matrix industry 541500, 2,399.6 thousand jobs; top occupation Software developers (15-1252), 21.1% of jobs.","reasons":["NAICS 541511 is more detailed than the BLS matrix, so its numbers are for the whole matrix industry: 541500 Computer systems design and related services.","Share is the occupation's jobs divided by all jobs in the matched industries."],"attribution":"Sources: US Census Bureau (NAICS 2022), US Bureau of Labor Statistics (SOC 2018; 2025-35 National Employment Matrix, employment in thousands), public domain, snapshot 2026-10-21. Not endorsed by eithe…","matrixEdition":"BLS Employment Projections 2025-35 National Employment Matrix, employment in thousands of jobs (wage and salary plus self-employed)","direction":"industry to occupations","naics":{"code":"541511","title":"Custom Computer Programming Services"},"matchMode":"covered","matchedMatrixIndustries":[{"matrixIndustryCode":"541500","title":"Computer systems design and related services","type":"line item","employment2025Thousands":2399.6,"naicsPrefixes":["5415"]}],"industryEmployment2025Thousands":2399.6,"occupationsWithJobs":196,"topOccupations":[{"socCode":"15-1252","title":"Software developers","employment2025Thousands":505.8,"shareOfIndustryEmploymentPct":21.1},{"socCode":"15-1232","title":"Computer user support specialists","employment2025Thousands":154.7,"shareOfIndustryEmploymentPct":6.4}],"degraded":false,"notChecked":["this is a statistical employment link, not a legal or official NAICS-SOC crosswalk (none is published)","industries finer than the BLS matrix groups (a 6-digit NAICS code is answered with its whole matrix group)","…2 more"],"source":"US Census Bureau NAICS 2022, BLS SOC 2018 and BLS 2025-35 Employment Matrix (public domain)","asOf":"2026-10-21T06:39:51.567Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0300"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/code-crosswalk-hint"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/code-crosswalk-hint"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/code-crosswalk-hint"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/code-crosswalk-hint"}}]}}},"/code-validate":{"get":{"operationId":"code_validate","summary":"Check whether a code is a valid NAICS 2022 or SOC 2018 code, at what level, and which system it belongs to.","description":"Check whether a code is a valid NAICS 2022 or SOC 2018 code, at what level, and which system it belongs to.","tags":["naics","soc","validation","codes"],"parameters":[{"name":"code","in":"query","required":true,"description":"Code to check, e.g. 541511, 15-1252, 151252, 15-1252.00 or 31-33","schema":{"type":"string"}},{"name":"system","in":"query","required":false,"description":"naics or soc to test only that system (default: both)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"input":{"type":["null","string"]},"formatsRecognised":{"type":["array","null"],"items":{"type":"string"}},"matches":{"type":["array","null"],"items":{"type":"object","properties":{"system":{"type":["null","string"]},"normalized":{"type":["null","string"]},"code":{"type":["null","string"]},"title":{"type":["null","string"]},"level":{"type":["null","number"]},"levelName":{"type":["null","string"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"VALID","summary":"15-1252 is a valid SOC 2018 detailed occupation: Software Developers.","reasons":[],"input":"151252","formatsRecognised":["naics","soc"],"matches":[{"system":"SOC 2018","normalized":"15-1252","code":"15-1252","title":"Software Developers","level":4,"levelName":"detailed occupation"}],"attribution":"Sources: US Census Bureau (NAICS 2022), US Bureau of Labor Statistics (SOC 2018; 2025-35 National Employment Matrix, employment in thousands), public domain, snapshot 2026-10-21. Not endorsed by eithe…","degraded":false,"notChecked":["NAICS 2017 or SOC 2010 and earlier codes (shown as not found)","other classification systems (SIC, NACE, ISIC, O*NET-SOC detail beyond the .00 suffix)"],"source":"US Census Bureau NAICS 2022, BLS SOC 2018 and BLS 2025-35 Employment Matrix (public domain)","asOf":"2026-10-21T06:39:51.824Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/code-validate"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/code-validate"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/code-validate"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/code-validate"}}]}}},"/naics-children":{"get":{"operationId":"naics_children","summary":"List the codes one level below a NAICS 2022 code (sector to national industry); omit the code to list the 20 sectors.","description":"List the codes one level below a NAICS 2022 code (sector to national industry); omit the code to list the 20 sectors.","tags":["naics","industry","hierarchy","codes"],"parameters":[{"name":"code","in":"query","required":false,"description":"NAICS 2022 code of 2 to 5 digits, e.g. 5415 (omit for the sectors)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"parent":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"title":{"type":["null","string"]},"level":{"type":["null","number"]},"levelName":{"type":["null","string"]}}},"childLevelName":{"type":["null","string"]},"childCount":{"type":["null","number"]},"children":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"title":{"type":["null","string"]},"level":{"type":["null","number"]},"levelName":{"type":["null","string"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"5415 \"Computer Systems Design and Related Services\" has 1 NAICS industry below it.","reasons":[],"parent":{"code":"5415","title":"Computer Systems Design and Related Services","level":4,"levelName":"industry group"},"childLevelName":"NAICS industry","childCount":1,"children":[{"code":"54151","title":"Computer Systems Design and Related Services","level":5,"levelName":"NAICS industry"}],"attribution":"Sources: US Census Bureau (NAICS 2022), US Bureau of Labor Statistics (SOC 2018; 2025-35 National Employment Matrix, employment in thousands), public domain, snapshot 2026-10-21. Not endorsed by eithe…","degraded":false,"notChecked":["NAICS editions other than 2022","the descriptive text of each code"],"source":"US Census Bureau NAICS 2022, BLS SOC 2018 and BLS 2025-35 Employment Matrix (public domain)","asOf":"2026-10-21T06:39:52.075Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/naics-children"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/naics-children"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/naics-children"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/naics-children"}}]}}},"/naics-lookup":{"get":{"operationId":"naics_lookup","summary":"NAICS 2022 code to title, level (sector to national industry) and full parent chain. Census Bureau data.","description":"NAICS 2022 code to title, level (sector to national industry) and full parent chain. Census Bureau data.","tags":["naics","industry","codes","census"],"parameters":[{"name":"code","in":"query","required":true,"description":"NAICS 2022 code of 2 to 6 digits, e.g. 541511, or a sector range like 31-33","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"input":{"type":["null","string"]},"attribution":{"type":["null","string"]},"code":{"type":["null","string"]},"title":{"type":["null","string"]},"level":{"type":["null","number"]},"levelName":{"type":["null","string"]},"parentChain":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"title":{"type":["null","string"]},"level":{"type":["null","number"]},"levelName":{"type":["null","string"]}}}},"childCount":{"type":["null","number"]},"childLevelName":{},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"541511 is \"Custom Computer Programming Services\", a NAICS 2022 national industry under 54151 Computer Systems Design and Related Services.","reasons":[],"input":"541511","attribution":"Sources: US Census Bureau (NAICS 2022), US Bureau of Labor Statistics (SOC 2018; 2025-35 National Employment Matrix, employment in thousands), public domain, snapshot 2026-10-21. Not endorsed by eithe…","code":"541511","title":"Custom Computer Programming Services","level":6,"levelName":"national industry","parentChain":[{"code":"54","title":"Professional, Scientific, and Technical Services","level":2,"levelName":"sector"},{"code":"541","title":"Professional, Scientific, and Technical Services","level":3,"levelName":"subsector"}],"childCount":0,"childLevelName":null,"degraded":false,"notChecked":["NAICS 2017 and earlier editions (codes may differ)","the Census descriptive text and cross-references for the code","…1 more"],"source":"US Census Bureau NAICS 2022, BLS SOC 2018 and BLS 2025-35 Employment Matrix (public domain)","asOf":"2026-10-21T06:39:52.339Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/naics-lookup"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/naics-lookup"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/naics-lookup"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/naics-lookup"}}]}}},"/naics-search":{"get":{"operationId":"naics_search","summary":"Search NAICS 2022 industry codes by words in the title or a code prefix; optional level filter; capped at 50.","description":"Search NAICS 2022 industry codes by words in the title or a code prefix; optional level filter; capped at 50.","tags":["naics","industry","search","codes"],"parameters":[{"name":"q","in":"query","required":true,"description":"Words like 'software publishers' or 'full service restaurants', or a code prefix like 5415","schema":{"type":"string"}},{"name":"level","in":"query","required":false,"description":"Only this code length: 2 sector, 3 subsector, 4 group, 5 industry, 6 national industry","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 50 (default 10)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"query":{"type":["null","object"],"properties":{"q":{"type":["null","string"]},"level":{}}},"matchedBy":{"type":["null","string"]},"matches":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"title":{"type":["null","string"]},"level":{"type":["null","number"]},"levelName":{"type":["null","string"]},"matchScore":{"type":["null","number"]}}}},"totalMatches":{"type":["null","number"]},"truncated":{"type":["boolean","null"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"1 NAICS code match \"computer programming\" (title words); best: 541511 Custom Computer Programming Services.","reasons":[],"query":{"q":"computer programming","level":null},"matchedBy":"title words","matches":[{"code":"541511","title":"Custom Computer Programming Services","level":6,"levelName":"national industry","matchScore":61}],"totalMatches":1,"truncated":false,"attribution":"Sources: US Census Bureau (NAICS 2022), US Bureau of Labor Statistics (SOC 2018; 2025-35 National Employment Matrix, employment in thousands), public domain, snapshot 2026-10-21. Not endorsed by eithe…","degraded":false,"notChecked":["the Census index entries and descriptive text (only code titles are searched)","synonyms (a trade name that is not in a title will not match)","…1 more"],"source":"US Census Bureau NAICS 2022, BLS SOC 2018 and BLS 2025-35 Employment Matrix (public domain)","asOf":"2026-10-21T06:39:52.592Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/naics-search"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/naics-search"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/naics-search"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/naics-search"}}]}}},"/soc-children":{"get":{"operationId":"soc_children","summary":"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.","description":"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.","tags":["soc","occupation","hierarchy","codes"],"parameters":[{"name":"code","in":"query","required":false,"description":"SOC 2018 group code like 15-0000, 15-1200 or 15-1250 (omit for the major groups)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"parent":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"title":{"type":["null","string"]},"level":{"type":["null","number"]},"levelName":{"type":["null","string"]}}},"childLevelName":{"type":["null","string"]},"childCount":{"type":["null","number"]},"children":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"title":{"type":["null","string"]},"level":{"type":["null","number"]},"levelName":{"type":["null","string"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"15-1200 \"Computer Occupations\" has 6 direct broad occupations.","reasons":[],"parent":{"code":"15-1200","title":"Computer Occupations","level":2,"levelName":"minor group"},"childLevelName":"broad occupation","childCount":6,"children":[{"code":"15-1210","title":"Computer and Information Analysts","level":3,"levelName":"broad occupation"},{"code":"15-1220","title":"Computer and Information Research Scientists","level":3,"levelName":"broad occupation"}],"attribution":"Sources: US Census Bureau (NAICS 2022), US Bureau of Labor Statistics (SOC 2018; 2025-35 National Employment Matrix, employment in thousands), public domain, snapshot 2026-10-21. Not endorsed by eithe…","degraded":false,"notChecked":["SOC editions other than 2018","definitions and example titles"],"source":"US Census Bureau NAICS 2022, BLS SOC 2018 and BLS 2025-35 Employment Matrix (public domain)","asOf":"2026-10-21T06:39:52.857Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/soc-children"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/soc-children"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/soc-children"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/soc-children"}}]}}},"/soc-lookup":{"get":{"operationId":"soc_lookup","summary":"SOC 2018 occupation code to title, level (major group to detailed occupation), parent chain and US employment.","description":"SOC 2018 occupation code to title, level (major group to detailed occupation), parent chain and US employment.","tags":["soc","occupation","codes","bls"],"parameters":[{"name":"code","in":"query","required":true,"description":"SOC 2018 code like 15-1252 (also 151252 or an O*NET code like 15-1252.00)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"input":{"type":["null","string"]},"attribution":{"type":["null","string"]},"code":{"type":["null","string"]},"title":{"type":["null","string"]},"level":{"type":["null","number"]},"levelName":{"type":["null","string"]},"parentChain":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"title":{"type":["null","string"]},"level":{"type":["null","number"]},"levelName":{"type":["null","string"]}}}},"childCount":{"type":["null","number"]},"childLevelName":{},"usEmployment":{"type":["null","object"],"properties":{"employment2025Thousands":{"type":["null","number"]},"basis":{"type":["null","string"]},"source":{"type":["null","string"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"15-1252 is \"Software Developers\", a SOC 2018 detailed occupation in 15-0000 Computer and Mathematical Occupations.","reasons":[],"input":"15-1252","attribution":"Sources: US Census Bureau (NAICS 2022), US Bureau of Labor Statistics (SOC 2018; 2025-35 National Employment Matrix, employment in thousands), public domain, snapshot 2026-10-21. Not endorsed by eithe…","code":"15-1252","title":"Software Developers","level":4,"levelName":"detailed occupation","parentChain":[{"code":"15-0000","title":"Computer and Mathematical Occupations","level":1,"levelName":"major group"},{"code":"15-1200","title":"Computer Occupations","level":2,"levelName":"minor group"}],"childCount":0,"childLevelName":null,"usEmployment":{"employment2025Thousands":1717.8,"basis":"this occupation","source":"BLS 2025-35 National Employment Matrix"},"degraded":false,"notChecked":["SOC definitions, example job titles and O*NET detail","SOC editions other than 2018","…1 more"],"source":"US Census Bureau NAICS 2022, BLS SOC 2018 and BLS 2025-35 Employment Matrix (public domain)","asOf":"2026-10-21T06:39:53.108Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/soc-lookup"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/soc-lookup"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/soc-lookup"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/soc-lookup"}}]}}},"/soc-search":{"get":{"operationId":"soc_search","summary":"Search SOC 2018 occupations by words in the title or a code prefix; optional level filter; capped at 50.","description":"Search SOC 2018 occupations by words in the title or a code prefix; optional level filter; capped at 50.","tags":["soc","occupation","search","codes"],"parameters":[{"name":"q","in":"query","required":true,"description":"Words like 'registered nurse' or 'software', or a code prefix like 15-12","schema":{"type":"string"}},{"name":"level","in":"query","required":false,"description":"1 major group, 2 minor group, 3 broad occupation, 4 detailed occupation","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 50 (default 10)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"query":{"type":["null","object"],"properties":{"q":{"type":["null","string"]},"level":{"type":["null","number"]}}},"matchedBy":{"type":["null","string"]},"matches":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"title":{"type":["null","string"]},"level":{"type":["null","number"]},"levelName":{"type":["null","string"]},"matchScore":{"type":["null","number"]}}}},"totalMatches":{"type":["null","number"]},"truncated":{"type":["boolean","null"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"6 SOC codes match \"nurse\" (title words); best: 29-1151 Nurse Anesthetists.","reasons":[],"query":{"q":"nurse","level":4},"matchedBy":"title words","matches":[{"code":"29-1151","title":"Nurse Anesthetists","level":4,"levelName":"detailed occupation","matchScore":73},{"code":"29-1161","title":"Nurse Midwives","level":4,"levelName":"detailed occupation","matchScore":73}],"totalMatches":6,"truncated":true,"attribution":"Sources: US Census Bureau (NAICS 2022), US Bureau of Labor Statistics (SOC 2018; 2025-35 National Employment Matrix, employment in thousands), public domain, snapshot 2026-10-21. Not endorsed by eithe…","degraded":false,"notChecked":["SOC example job titles and 'also called' lists (a job title that is not in an official title will not match)","SOC editions other than 2018","…1 more"],"source":"US Census Bureau NAICS 2022, BLS SOC 2018 and BLS 2025-35 Employment Matrix (public domain)","asOf":"2026-10-21T06:39:53.373Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/soc-search"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/soc-search"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/soc-search"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://industry-occupation-codes.x402tookit.com/soc-search"}}]}}}}}