# BLS Wage & Salary Data by Occupation (SOC Code)

> BLS Wage & Salary Data by Occupation (SOC Code) is a paid API for AI agents from 2s.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns U.S. Bureau of Labor Statistics wage data (median, mean, percentiles, employment) for a given SOC occupation code, optionally filtered by state.

## Facts

- Endpoint: GET https://2s.io/api/labor/wages
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bls-wage-salary-data-by-occupation-soc-code-9b7dd304
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e13UPkL3M3beGLHcBH3cR

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 bls-wage-salary-data-by-occupation-soc-code-9b7dd304
```

Example prompt: What are the wages for software quality assurance analysts (SOC code 15-1253) in Texas — give me the median, mean, and the 10th through 90th percentile annual salaries?

## When to prefer this

Use this endpoint when you need authoritative, government-sourced U.S. wage and salary data by occupation code, especially when you need percentile breakdowns (not just averages) or state-level filtering. Prefer this over third-party salary aggregators when ground-truth BLS data is required for compliance, research, or policy purposes. Ideal when you have a specific 6-digit SOC code to query.

## Known failure modes

- Invalid or malformed SOC code returns empty result set or error
- Unrecognized state code may return no results or an error
- Some niche SOC codes may have no BLS data available for certain states
- Network or upstream BLS API outage may cause failure
- Missing required 'soc' query parameter results in a 400-level error

## How this service works

Occupational employment and wages from the BLS OEWS survey, by SOC occupation code, nationally or for a US state. Pass soc (e.g. 15-1252 Software Developers) and optionally a 2-letter state. Returns total employment, hourly mean wage, and annual mean + 10th/25th/median/75th/90th-percentile wages for the latest survey year. Public-domain, live-wrap. Authoritative ground-truth wages an agent must not guess — for comp benchmarking, job-offer evaluation, and labor-cost modeling.

## Output

Returns a JSON object with an array of wage records for the specified occupation, each containing SOC code, geographic area, data year, area type, employment count, annual wages at the 10th/25th/75th/90th percentiles, annual median wage, annual mean wage, and hourly mean wage. Also includes total record count and BLS source metadata (URL, license, provider).

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [
      "soc"
     ],
     "properties": {
      "soc": {
       "type": "string",
       "description": "6-digit SOC code (e.g. 15-1252 or 151252)."
      },
      "state": {
       "type": "string",
       "description": "Optional 2-letter US state code (omit for national)."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bls-wage-salary-data-by-occupation-soc-code-9b7dd304/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)