# California Contractor Workers' Comp Expiring Signal

> California Contractor Workers' Comp Expiring Signal is a paid API for AI agents from ca-contractor-intelligence-production.up.railway.app, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-15).

Returns a paginated list of California-licensed contractors whose workers' compensation insurance is expiring within a specified future window, optionally filtered by city, county, ZIP code, or contractor classification.

## Facts

- Endpoint: GET https://ca-contractor-intelligence-production.up.railway.app/signals/x402/wc-expiring
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/california-contractor-workers-comp-expiring-signal-c255c2b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RN0ehvr0VC9J5J_pjv6NF

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 california-contractor-workers-comp-expiring-signal-c255c2b8
```

Example prompt: Pull the ForgeSignal workers' comp expiring list for California electrical contractors in Los Angeles county over the next 30 days, first page of results.

## When to prefer this

Choose this endpoint when you need structured, machine-readable intelligence about California-licensed contractors whose workers' compensation insurance is imminently expiring — particularly for insurance sales prospecting, compliance monitoring, or contractor vetting workflows. It is preferable over manual CSLB lookups when you need paginated bulk results filterable by geography and trade classification, and when you need this data in an automated pipeline willing to pay per-call via x402.

## Known failure modes

- Missing required 'days' parameter returns a validation error
- 'days' value outside 1–90 range returns a schema validation error
- Invalid or unrecognized California city/county/ZIP returns empty results rather than an error
- Page number beyond available results returns an empty results array
- Insufficient payment (x402) causes a payment-required rejection before data is returned
- Stale or unavailable upstream licensing data may cause lower-than-expected match counts

## How this service works

ForgeSignal provides paid, machine-readable California contractor intelligence signals for AI agents and automated systems.

## Output

A JSON object containing a paginated list of up to 25 California contractor records flagged with the 'workers_comp_expiring' signal, along with the total number of matches, the as-of date, the search window in days, and any applied filters (city, county, ZIP code, classification). Returns status 'ok' on success.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "days"
     ],
     "properties": {
      "city": {
       "type": [
        "string",
        "null"
       ],
       "description": "Optional California city."
      },
      "days": {
       "type": "integer",
       "maximum": 90,
       "minimum": 1,
       "description": "Number of days into the future to search for workers' compensation expirations."
      },
      "page": {
       "type": "integer",
       "minimum": 1,
       "description": "Result page to return. Each paid page contains up to 25 contractor records."
      },
      "county": {
       "type": [
        "string",
        "null"
       ],
       "description": "Optional California county."
      },
      "zip_code": {
       "type": [
        "string",
        "null"
       ],
       "description": "Optional ZIP code."
      },
      "classification": {
       "type": [
        "string",
        "null"
       ],
       "description": "Optional California contractor classification code."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "city": null,
  "page": 1,
  "county": null,
  "signal": "workers_comp_expiring",
  "status": "ok",
  "results": [],
  "returned": 25,
  "zip_code": null,
  "as_of_date": "2026-08-23",
  "window_days": 7,
  "total_matches": 100,
  "classification": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/california-contractor-workers-comp-expiring-signal-c255c2b8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ca-contractor-intelligence-production.up.railway.app](https://www.zero.xyz/host/ca-contractor-intelligence-production.up.railway.app/llms.txt)