{"uid":"cap_q68NlvkGwt5y7P5CKCQny","slug":"soc-2018-occupation-code-lookup-baeda89c","name":"SOC 2018 Occupation Code Lookup","description":"SOC 2018 occupation code to title, level (major group to detailed occupation), parent chain and US employment.","url":"https://industry-occupation-codes.x402tookit.com/soc-lookup?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"SOC 2018 code like 15-1252 (also 151252 or an O*NET code like 15-1252.00)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"code":{"type":["null","string"]},"input":{"type":["null","string"]},"level":{"type":["null","number"]},"title":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"levelName":{"type":["null","string"]},"childCount":{"type":["null","number"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"parentChain":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"level":{"type":["null","number"]},"title":{"type":["null","string"]},"levelName":{"type":["null","string"]}}}},"usEmployment":{"type":["null","object"],"properties":{"basis":{"type":["null","string"]},"source":{"type":["null","string"]},"employment2025Thousands":{"type":["null","number"]}}},"childLevelName":{}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Wuee4QWadJ3S2xUjSErJd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up a SOC 2018 occupation code to retrieve its title, hierarchical level, parent chain, and US employment figures.","exampleAgentPrompt":"What is the full title, hierarchy level, parent chain, and US employment for SOC 2018 code 15-1252?","exampleUseCases":[{"title":"Resume occupation code validation","prompt":"I have a job posting tagged with SOC code 15-1252 — can you tell me the official occupation title, what level it is in the SOC hierarchy, and how many people work in that occupation in the US?"},{"title":"HR taxonomy enrichment","prompt":"We're building an HR data pipeline and need to enrich each role record with its full SOC 2018 parent chain — can you look up SOC code 11-2021 and give me its title, level name, and all ancestor codes up to the major group?"},{"title":"Labor market research","prompt":"I'm researching nursing occupations — look up SOC 2018 code 29-1141 and tell me the official title, whether it's a detailed or broad occupation, and the US employment estimate for 2025."}],"resultDescription":"Returns the occupation's canonical title, numeric hierarchy level (1=major group to 4=detailed occupation), level name, full parent chain (array of ancestor codes/titles/levels), US employment in thousands with source and basis, child count for non-leaf nodes, and source attribution. Null fields indicate data not available at that level.","failureModes":["Invalid or unrecognized SOC code returns null fields with error reasons","Malformed code format (e.g. missing hyphen without fallback parsing) may not match","Employment data may be null for aggregate levels where BLS does not publish figures","O*NET suffix codes (e.g. 15-1252.00) are accepted but stripped to 6-digit SOC before lookup"],"whenToPreferThis":"Use this endpoint when you have a specific SOC 2018 (or O*NET) code and need to resolve it to a canonical title, understand where it sits in the 4-level SOC hierarchy, traverse its parent chain, or retrieve US employment estimates. Prefer this over the search endpoint when the code is already known. Use sibling endpoints for code search by keyword or for listing child codes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:30:50.259Z","isFirstParty":false,"canonicalSlug":"soc-2018-occupation-code-lookup-baeda89c"}