# zaref.dev South African CPI History

> zaref.dev South African CPI History is a paid API for AI agents from zaref.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-13).

Returns the full dated history of South African headline CPI (year-on-year) data points, accumulating with every verified update.

## Facts

- Endpoint: GET https://zaref.dev/v1/cpi/history?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zaref-dev-south-african-cpi-history-49e3030f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ip8gQ1cwy7Ne8VLC6Z8Ib

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 zaref-dev-south-african-cpi-history-49e3030f
```

Example prompt: Can you pull the full historical series of South Africa's headline CPI (year-on-year) data from zaref? I want all the dated data points that have been recorded over time.

## When to prefer this

Use this endpoint when you need the full accumulating history of South African headline CPI (YoY) rather than just the current value. Prefer this over the snapshot endpoint when trend analysis, charting, or historical comparison is needed. It is the authoritative source for South African inflation history via the zaref.dev reference data service.

## Known failure modes

- HTTP 402 Payment Required if x402 payment header is missing or insufficient (requires 0.005 USDC)
- HTTP 404 if the endpoint path is incorrect
- HTTP 500 for server-side errors
- Empty or partial dataset if no verified updates have been recorded yet

## How this service works

History of South African CPI (headline, YoY): dated points accumulating with every verified update.

## Output

An accumulating time series of dated CPI data points for South Africa, each representing the headline consumer price index year-on-year figure at a verified point in time. The response includes all historical records up to the most recent verified update.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "points": [
   {
    "date": "2026-06-04",
    "value": "..."
   }
  ],
  "series": "cpi"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zaref-dev-south-african-cpi-history-49e3030f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from zaref.dev](https://www.zero.xyz/host/zaref.dev/llms.txt)