# SOC 2018 Occupation Code Lookup

> SOC 2018 Occupation Code Lookup is a paid API for AI agents from industry-occupation-codes.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Look up a SOC 2018 occupation code to retrieve its title, hierarchical level, parent chain, and US employment figures.

## Facts

- Endpoint: GET https://industry-occupation-codes.x402tookit.com/soc-lookup?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/soc-2018-occupation-code-lookup-baeda89c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_q68NlvkGwt5y7P5CKCQny

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability soc-2018-occupation-code-lookup-baeda89c
```

Example prompt: What is the full title, hierarchy level, parent chain, and US employment for SOC 2018 code 15-1252?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

SOC 2018 occupation code to title, level (major group to detailed occupation), parent chain and US employment.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
          ]
         },
         "leve
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/soc-2018-occupation-code-lookup-baeda89c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from industry-occupation-codes.x402tookit.com](https://www.zero.xyz/host/industry-occupation-codes.x402tookit.com/llms.txt)