# zaref South African Reference Data Alerts – Webhook Registration

> zaref South African Reference Data Alerts – Webhook Registration is a paid API for AI agents from zaref.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-22).

Registers a webhook URL to receive POST notifications whenever watched South African reference data series (fuel prices, interest rates, FX, etc.) are updated

## Facts

- Endpoint: POST https://zaref.dev/v1/alerts?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zaref-south-african-reference-data-alerts-webhook-registration-435431dc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YZCoNZDhBYyvxifkQpHeS

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-south-african-reference-data-alerts-webhook-registration-435431dc -d '<json body>'
```

Example prompt: Set up a webhook to https://myapp.example.com/hooks/zaref so I get notified whenever the South African fuel price or prime interest rate series updates on zaref.

## When to prefer this

Use this endpoint when you need proactive, push-based notifications for South African reference data changes rather than polling individual data series endpoints. It is the right choice when you want to trigger downstream workflows, cache invalidations, or dashboards updates automatically without repeatedly querying zaref for fresh data.

## Known failure modes

- Invalid or non-HTTPS webhook URL returns an error — raw IPs, localhost, and private IP ranges are explicitly refused
- Unknown series slug causes rejection of the subscription
- Webhook endpoint is unreachable or returns non-2xx responses during notification delivery
- Missing required 'url' field returns a validation error
- Malformed JSON body causes a 400-level error

## How this service works

South African reference data as clean, cited JSON: fuel prices, interest rates, FX and bond yields, tax tables, tariffs, wages and grants, live government tenders and crypto prices, plus calculators. Built for AI agents and applications.

## Output

A confirmation object indicating that the webhook has been registered; subsequent POST calls will be sent to the provided URL whenever the watched series data is updated on zaref.dev.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "string, required: HTTPS endpoint to POST notifications to (public hostname; raw IPs, localhost and private ranges are refused)"
  },
  "series": {
   "type": "string",
   "description": "array of series slugs to watch, or the string \"all\" (default): which series trigger a notification"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zaref-south-african-reference-data-alerts-webhook-registration-435431dc/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)