# Locus: Workplace & Employment Context Scan

> Locus: Workplace & Employment Context Scan is a paid API for AI agents from api.locus.report, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns local employment and industry-sector context data for a given address or geographic area by querying public records.

## Facts

- Endpoint: POST https://api.locus.report/api/locus-workplace-employment-context
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/locus-workplace-employment-context-scan-5fc8fea7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rUdFmzllVW4cgUoEkpKY-

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 locus-workplace-employment-context-scan-5fc8fea7 -d '<json body>'
```

Example prompt: Run a Locus workplace and employment context scan for 123 Main Street, Chicago, IL — look within 750 meters and focus on CNS07 (retail) and CNS18 (healthcare) industry sectors.

## When to prefer this

Choose this endpoint when you need local employment and industry-sector context derived from public records for a specific address or geographic radius — especially useful for site selection, property due diligence, or neighborhood labor market analysis. Prefer it over general web searches when structured, record-backed employment context tied to a parcel or point is needed. If you need housing stock, tax distress, or capital improvement data instead, use the relevant sibling Locus endpoints.

## Known failure modes

- Address not geocodable — returns empty records or error if address cannot be resolved to coordinates
- Radius out of bounds — error if radiusMeters is below 250 or above 5000
- No public records available for the queried area — returns records array as empty with relevant caveats
- Invalid industry sector code — enum validation error if unrecognized CNS code is submitted
- Malformed coordinates — error if latitude/longitude are outside valid ranges

## How this service works

Census LODES workplace jobs and broad industry sectors within a radius. Perfect for: commercial site selection, tenant diligence, daytime employment, and labor context near a selected site. Returns annual block-level aggregates only; excludes worker demographics. Jobs are not shoppers, visits, foot traffic, sales, demand, or a forecast. Charge-free when the state snapshot is missing, stale, unavailable, or no workplace block falls in the radius.

## Output

A JSON object containing a report ID, generation timestamp, an array of employment-context records sourced from public records for the queried area, and any caveats about data completeness or limitations. The response indicates which public-record questions are answered, which remain open, and what to verify next.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "maxLength": 200,
   "minLength": 5
  },
  "latitude": {
   "type": "number",
   "maximum": 90,
   "minimum": -90
  },
  "longitude": {
   "type": "number",
   "maximum": 180,
   "minimum": -180
  },
  "radiusMeters": {
   "type": "integer",
   "maximum": 5000,
   "minimum": 250
  },
  "industrySectors": {
   "type": "array",
   "items": {
    "enum": [
     "CNS01",
     "CNS02",
     "CNS03",
     "CNS04",
     "CNS05",
     "CNS06",
     "CNS07",
     "CNS08",
     "CNS09",
     "CNS10",
     "CNS11",
     "CNS12",
     "CNS13",
     "CNS14",
     "CNS15",
     "CNS16",
     "CNS17",
     "CNS18",
     "CNS19",
     "CNS20"
    ],
    "type": "string"
   },
   "maxItems": 20
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "locus_example",
  "caveats": [
   "Example artifact; not live data."
  ],
  "records": [],
  "generatedAt": "2026-01-01T00:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/locus-workplace-employment-context-scan-5fc8fea7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.locus.report](https://www.zero.xyz/host/api.locus.report/llms.txt)