# zaref.dev South African Learnership Allowances

> zaref.dev South African Learnership Allowances is a paid API for AI agents from zaref.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-21).

Returns current minimum weekly learnership allowances per NQF level, sourced from the official South African NMW gazette with citation, effective date, and freshness flag.

## Facts

- Endpoint: GET https://zaref.dev/v1/learnership-allowances?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zaref-dev-south-african-learnership-allowances-463cad41
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_di5TJ-Jf1LgC5pYZRDauX

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-learnership-allowances-463cad41
```

Example prompt: What are the current minimum weekly learnership allowances for each NQF level in South Africa, with the official source and the date they came into effect?

## When to prefer this

Use this endpoint when you need authoritative, cited, machine-readable learnership allowance figures for South Africa by NQF level — especially for compliance checking, payroll systems, or HR tooling. Prefer this over scraping government websites or using cached data, as it includes a freshness flag and an official gazette citation to verify currency.

## Known failure modes

- Gazette not yet updated after a new NMW notice — freshness flag may indicate stale data
- HTTP 402 if payment header is missing or the x402 payment fails
- HTTP 503 if the upstream data source or zaref.dev service is temporarily unavailable
- Empty or partial response if gazette data has not yet been parsed for the current period

## How this service works

South African Learnership allowances (Minimum weekly learnership allowances per NQF level, per the current NMW gazette.) Clean cited JSON with official source URL, effective date and freshness flag.

## Output

A JSON object containing minimum weekly learnership allowance amounts indexed by NQF level, the official NMW gazette source URL, the effective date of the current rates, and a freshness flag indicating whether the data is up to date.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": "current values with citations",
  "stale": false,
  "series": "learnership-allowances",
  "source_url": "https://www.gov.za/sites/default/files/gcis_document/202602/54075rg11941gon7083.pdf",
  "effective_date": "2026-03-01"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zaref-dev-south-african-learnership-allowances-463cad41/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)