# Foresight API – Panel Observations

> Foresight API – Panel Observations is a paid API for AI agents from api.creativeforesight.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Retrieves panel-level economic observations (e.g. employment, unemployment rate) for a given region and set of indicators over time.

## Facts

- Endpoint: GET https://api.creativeforesight.io/v1/panel
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/foresight-api-panel-observations-6f3b5241
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IYDLwRqF7EL1O5N8LUa9J

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 foresight-api-panel-observations-6f3b5241
```

Example prompt: Pull the latest PAYEMS and UNRATE panel observations for region 47187 from Foresight API so I can see the employment and unemployment trend over time.

## When to prefer this

Choose this endpoint when you need structured, time-series economic panel data (labor, employment, unemployment) for a specific geographic region identified by a FIPS or ZIP code. It is ideal for agents building economic dashboards, monitoring regional labor markets, or feeding macroeconomic signals into forecasting models. Prefer this over generic data scrapers when you need clean, pre-structured indicator series aligned by date.

## Known failure modes

- Missing required query parameters (indicators or region) returns a 400 or validation error
- Invalid or unrecognized region code returns empty or error response
- Missing or invalid bearer API key returns 401 Unauthorized
- Insufficient x402 payment or payment failure returns 402 Payment Required
- Unsupported indicator codes return empty series or error
- Rate limiting may return 429 Too Many Requests

## How this service works

Foresight API request

## Output

Returns a JSON object with a meta field containing the region, an array of date strings representing observation periods, and a series map where each key is an indicator code (e.g. PAYEMS, UNRATE) and each value is an array of numeric readings aligned to the dates array.

## 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"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "indicators",
      "region"
     ],
     "properties": {
      "region": {
       "type": "string"
      },
      "indicators": {
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {}
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "region": "47187"
  },
  "dates": [
   "2025-01-01"
  ],
  "series": {
   "PAYEMS": [
    159000
   ],
   "UNRATE": [
    4.1
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/foresight-api-panel-observations-6f3b5241/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.creativeforesight.io](https://www.zero.xyz/host/api.creativeforesight.io/llms.txt)