SOC 2018 Occupation Code Search

Use this endpoint when you need to find or validate SOC 2018 Standard Occupational Classification codes by keyword search or code prefix. It is specifically suited for fuzzy title-based discovery (e.g. entering 'nurse' to find all nursing occupations) or prefix-based browsing of the SOC hierarchy. Prefer it over the SOC code-to-detail endpoint when you don't already know the exact code, and over the SOC child-listing endpoint when you want keyword matching rather than hierarchical traversal.

• No matches found for the query term — returns empty matches array
• Query parameter 'q' missing — returns 400 or validation error
• Limit set above 50 — capped or rejected
• Invalid level value (outside 1–4) — returns validation error or unfiltered results
• Service degraded — degraded flag set true with partial or no results