# Income For Everyone – Labor Stats History

> Income For Everyone – Labor Stats History is a paid API for AI agents from incomeforeveryone.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns historical time-series labor statistics (employment, automation impact, UBI policy indicators) over a user-specified date range.

## Facts

- Endpoint: POST https://incomeforeveryone.org/api/labor-stats/history
- 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/income-for-everyone-labor-stats-history-ee046fe3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bUCq3zK7RfixIC-FXzFes

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 income-for-everyone-labor-stats-history-ee046fe3 -d '<json body>'
```

Example prompt: Can you pull the historical labor stats from Income For Everyone covering January 2023 through December 2023, so I can see how employment and automation disruption indicators trended month by month over that year?

## When to prefer this

Choose this endpoint when you need structured, time-series labor market data (employment trends, automation impact, UBI-related indicators) with month-over-month deltas over a historical date range. It is ideal for economic research, policy analysis, or automated reporting workflows that need machine-readable indicator series rather than narrative news summaries.

## Known failure modes

- Invalid date format in 'from' or 'to' fields returns a validation error
- Date range with no available observations returns an empty indicators array
- 'from' date after 'to' date may return an error or empty result
- Payment failure (insufficient USDC) results in a 402 response before data is returned
- Extremely wide date ranges may return partial data or hit rate/size limits

## How this service works

News-led daily briefs on AI, automation, job disruption, labor policy, and Universal Basic Income.

## Output

A structured JSON object containing a schema version, snapshot date, history window metadata (frequency, start/end dates, observation count per indicator), an array of labor indicators (each with an id, label, unit, series ID, and dated observations including raw values and month-over-month changes), source attribution objects, and access metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "string",
   "description": "Optional inclusive end date for historical observations."
  },
  "from": {
   "type": "string",
   "description": "Optional inclusive start date for historical observations."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "schema_version",
  "endpoint",
  "snapshot_as_of",
  "history_window",
  "indicators",
  "sources",
  "access"
 ],
 "properties": {
  "access": {
   "type": "object"
  },
  "deltas": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "sources": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "endpoint": {
   "type": "string",
   "const": "/api/labor-stats/history"
  },
  "indicators": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "label",
     "unit",
     "series_id",
     "observations"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "unit": {
      "type": "string"
     },
     "label": {
      "type": "string"
     },
     "series_id": {
      "type": "string"
     },
     "observations": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "date",
        "period",
        "value",
        "raw_value"
       ],
       "properties": {
        "date": {
         "type": "string",
         "format": "date"
        },
        "value": {
         "type": "string"
        },
        "period": {
         "type": "string"
        },
        "raw_value": {
         "type": "string"
        },
        "month_over_month_change": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "history_window": {
   "type": "object",
   "required": [
    "frequency",
    "observation_count_per_indicator",
    "start_date",
    "end_date"
   ],
   "properties": {
    "end_date": {
     "type": "string",
     "format": "date"
    },
    "frequency": {
     "type": "string"
    },
    "start_date": {
     "type": "string",
     "format": "date"
    },
    "observation_count_per_indicator": {
     "type": "integer"
    }
   }
  },
  "schema_version": {
   "type": "string"
  },
  "snapshot_as_of": {
   "type": "string",
   "format": "date"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/income-for-everyone-labor-stats-history-ee046fe3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from incomeforeveryone.org](https://www.zero.xyz/host/incomeforeveryone.org/llms.txt)
