{"uid":"cap_XSZYMlfhb8mwFd79BPRf8","slug":"soc-2018-child-code-lookup-81406bd6","name":"SOC 2018 Child Code Lookup","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.","url":"https://industry-occupation-codes.x402tookit.com/soc-children?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":[],"properties":{"code":{"type":"string","description":"SOC 2018 group code like 15-0000, 15-1200 or 15-1250 (omit for the major groups)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"parent":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"level":{"type":["null","number"]},"title":{"type":["null","string"]},"levelName":{"type":["null","string"]}}},"source":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"children":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"level":{"type":["null","number"]},"title":{"type":["null","string"]},"levelName":{"type":["null","string"]}}}},"degraded":{"type":["boolean","null"]},"childCount":{"type":["null","number"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"childLevelName":{"type":["null","string"]}}}}}}},"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_BfHumZ-dx7vOC1Cp0HUQp","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":"Returns the list of SOC 2018 codes one level below a given SOC code, traversing the hierarchy from major group to minor group to broad occupation to detailed occupation.","exampleAgentPrompt":"Show me all the child codes one level below SOC code 15-1200 in the SOC 2018 hierarchy — I want to see what broad occupations are under that minor group.","exampleUseCases":[{"title":"Drill into computer occupations hierarchy","prompt":"What are the minor group codes directly under SOC major group 15-0000 (Computer and Mathematical occupations)? I want to see the next level down in the SOC hierarchy."},{"title":"Populate occupation dropdown for HR tool","prompt":"I'm building a job classification tool and need all the broad occupation codes under SOC minor group 15-1200 — can you fetch those child codes and their titles?"},{"title":"Verify detailed occupations under broad code","prompt":"List all the detailed occupation codes that sit one level below SOC broad occupation 15-1250 so I can see every specific role in that group."}],"resultDescription":"Returns a structured object containing the parent SOC code and its metadata (code, title, level, level name), an array of child codes each with code, title, level, and level name, a child count, the child level name, source attribution, and an asOf timestamp. Also includes diagnostic fields like degraded status, disclaimer, and reasons.","failureModes":["Invalid or malformed SOC code returns an error or empty children array","Providing a detailed occupation code (lowest level) returns no children since there is no level below","Omitting the code parameter when expecting major group children — major groups are not supported and the code must be omitted intentionally","Payment failure due to insufficient USDC balance (x402 protocol)","Network timeout or service unavailability"],"whenToPreferThis":"Use this endpoint when you need to programmatically traverse the SOC 2018 occupational classification hierarchy one level at a time — from major group down to minor, broad, or detailed occupation. Prefer this over a flat code search when you need structured parent-child relationships rather than keyword matching, or when building UI trees, dropdown menus, or hierarchical classifiers based on official BLS SOC taxonomy.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:30:23.929Z","isFirstParty":false,"canonicalSlug":"soc-2018-child-code-lookup-81406bd6"}