# zaref.dev All South African Reference Data

> zaref.dev All South African Reference Data is a paid API for AI agents from zaref.dev, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-18).

Returns a single snapshot of all South African reference data series (fuel prices, interest rates, tax calendars, tolls, tariffs, wages, and grants) in one response.

## Facts

- Endpoint: GET https://zaref.dev/v1/all?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zaref-dev-all-south-african-reference-data-a094fa21
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_U5gtS76VEgOpyaJFBwn6E

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-all-south-african-reference-data-a094fa21
```

Example prompt: Can you pull all the current South African reference data — fuel prices, interest rates, tax deadlines, minimum wages, and retirement limits — in one go from ZARef?

## When to prefer this

Use this endpoint when you need a comprehensive, one-call snapshot of all South African statutory and regulated reference data without making multiple per-series requests. Prefer it over individual ZARef series endpoints when building dashboards, compliance checks, or payroll tools that require several data points simultaneously. It is especially useful when you need to cross-reference multiple data series (e.g. fuel cost modelling alongside NCA rates and minimum wages).

## Known failure modes

- HTTP 402 if payment header is missing or insufficient (x402 protocol)
- HTTP 500 if upstream data refresh is failing
- Stale data if the snapshot has not been updated following a government gazette
- Empty or partial series if a specific data source is temporarily unavailable

## How this service works

South African reference data for AI agents: verified, cited series covering fuel prices, interest rates, tax tables, tolls, tariffs, wages, grants, FX, bond yields and crypto prices, plus calculators and history, paid per call via x402. This endpoint returns a snapshot of every series in one response.

## Output

A single JSON response containing a snapshot of every ZARef data series, including: current petrol/diesel retail and wholesale fuel prices (inland and coastal), SARS tax calendar filing windows and provisional deadlines, BCEA earnings threshold, NCA maximum lawful interest rates, SARS and prescribed interest rates, retirement contribution deduction caps, TFSA limits, and sectoral minimum wages.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "series": "all 33 series keyed by slug",
  "disclaimer": "independent data service"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zaref-dev-all-south-african-reference-data-a094fa21/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)