{
  "name": "zaref",
  "description": "South African reference data as clean, cited JSON. Built for agents and applications.",
  "base_url": "https://zaref.dev",
  "pricing": "Free during preview. Per-call x402 pricing (~$0.002 USDC) planned for GA; /catalog and /v1/public-holidays stay free.",
  "disclaimer": "Independent data service. Not affiliated with, or endorsed by, any South African government entity. Every value carries the official source URL and its effective date; verify against the source for legal or financial use.",
  "endpoints": {
    "catalog": "/catalog",
    "series": "/v1/{series}",
    "all": "/v1/all",
    "openapi": "/openapi.json",
    "llms": "/llms.txt"
  },
  "series": [
    {
      "slug": "fuel-prices",
      "title": "Fuel prices",
      "description": "Current SA retail/wholesale fuel prices: petrol 93/95 (inland & coastal), diesel 50ppm, illuminating paraffin. Rand per litre.",
      "update_cadence": "monthly (first Wednesday)",
      "free": false,
      "url": "https://zaref.dev/v1/fuel-prices",
      "effective_date": "2026-07-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2026-08-05",
      "stale": false
    },
    {
      "slug": "repo-prime",
      "title": "Repo & prime rate",
      "description": "SARB repo rate and prime lending rate, with last MPC change date.",
      "update_cadence": "per SARB MPC meeting (~every 2 months)",
      "free": false,
      "url": "https://zaref.dev/v1/repo-prime",
      "effective_date": "2026-05-29",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2026-07-23",
      "stale": false
    },
    {
      "slug": "cpi",
      "title": "CPI (headline, YoY)",
      "description": "Latest Stats SA headline consumer inflation, year-on-year %, with reference month.",
      "update_cadence": "monthly",
      "free": false,
      "url": "https://zaref.dev/v1/cpi",
      "effective_date": "2026-05-31",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2026-07-22",
      "stale": false
    },
    {
      "slug": "income-tax",
      "title": "Income tax tables",
      "description": "Personal income tax brackets, rebates and thresholds for the current SA tax year.",
      "update_cadence": "annual (National Budget)",
      "free": false,
      "url": "https://zaref.dev/v1/income-tax",
      "effective_date": "2026-03-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2027-03-01",
      "stale": false
    },
    {
      "slug": "vat",
      "title": "VAT rate",
      "description": "VAT rate currently in force in South Africa.",
      "update_cadence": "rare (Budget announcements)",
      "free": false,
      "url": "https://zaref.dev/v1/vat",
      "effective_date": "2018-04-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": null,
      "stale": false
    },
    {
      "slug": "uif-oid",
      "title": "UIF & OID limits",
      "description": "UIF contribution remuneration ceiling and OID (COIDA) earnings threshold.",
      "update_cadence": "annual",
      "free": false,
      "url": "https://zaref.dev/v1/uif-oid",
      "effective_date": "2026-03-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2027-04-30",
      "stale": false
    },
    {
      "slug": "minimum-wage",
      "title": "National minimum wage",
      "description": "National minimum wage per hour, incl. special categories, with effective date.",
      "update_cadence": "annual (March)",
      "free": false,
      "url": "https://zaref.dev/v1/minimum-wage",
      "effective_date": "2026-03-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2027-03-01",
      "stale": false
    },
    {
      "slug": "public-holidays",
      "title": "Public holidays",
      "description": "Official SA public holidays for the current calendar year, incl. proclaimed one-offs and Sunday observances.",
      "update_cadence": "annual + ad hoc proclamations",
      "free": true,
      "url": "https://zaref.dev/v1/public-holidays",
      "effective_date": "2026-01-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": null,
      "stale": false
    },
    {
      "slug": "school-terms",
      "title": "School terms",
      "description": "DBE public school term dates.",
      "update_cadence": "annual",
      "free": false,
      "url": "https://zaref.dev/v1/school-terms",
      "effective_date": "2026-01-14",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2027-03-31",
      "stale": false
    },
    {
      "slug": "sassa-grants",
      "title": "SASSA grant amounts",
      "description": "All SASSA social grant amounts incl. SRD, with effective date.",
      "update_cadence": "annual (April) + October adjustments",
      "free": false,
      "url": "https://zaref.dev/v1/sassa-grants",
      "effective_date": "2026-04-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2027-04-01",
      "stale": false
    },
    {
      "slug": "travel-rates",
      "title": "SARS travel rates",
      "description": "SARS prescribed per-km reimbursement rate and subsistence allowances for the current tax year.",
      "update_cadence": "annual (Budget)",
      "free": false,
      "url": "https://zaref.dev/v1/travel-rates",
      "effective_date": "2026-03-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2027-02-24",
      "stale": false
    },
    {
      "slug": "tax-rates-other",
      "title": "Other national tax rates",
      "description": "Corporate tax, dividends WHT, CGT inclusion, transfer duty brackets, retirement caps, medical tax credits, interest exemptions, estate/donations tax.",
      "update_cadence": "annual (Budget)",
      "free": false,
      "url": "https://zaref.dev/v1/tax-rates-other",
      "effective_date": "2026-03-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2027-02-24",
      "stale": false
    },
    {
      "slug": "unemployment",
      "title": "Unemployment rate",
      "description": "Latest Stats SA QLFS official and expanded unemployment rates, with reference quarter.",
      "update_cadence": "quarterly",
      "free": false,
      "url": "https://zaref.dev/v1/unemployment",
      "effective_date": "2026-05-12",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2026-08-11",
      "stale": false
    },
    {
      "slug": "gdp",
      "title": "GDP growth",
      "description": "Latest Stats SA GDP growth (QoQ and YoY), with reference quarter.",
      "update_cadence": "quarterly",
      "free": false,
      "url": "https://zaref.dev/v1/gdp",
      "effective_date": "2026-06-09",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2026-09-08",
      "stale": false
    },
    {
      "slug": "ppi",
      "title": "PPI (final manufactured goods)",
      "description": "Latest Stats SA producer inflation YoY, with reference month.",
      "update_cadence": "monthly",
      "free": false,
      "url": "https://zaref.dev/v1/ppi",
      "effective_date": "2026-06-25",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2026-07-30",
      "stale": false
    },
    {
      "slug": "toll-fees",
      "title": "Toll fees",
      "description": "Mainline toll plaza tariffs (vehicle classes 1-4) for the major national routes, current adjustment.",
      "update_cadence": "annual (March)",
      "free": false,
      "url": "https://zaref.dev/v1/toll-fees",
      "effective_date": "2026-03-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2027-03-01",
      "stale": false
    },
    {
      "slug": "electricity-tariffs",
      "title": "Electricity tariffs",
      "description": "NERSA-approved Eskom tariff increases and key residential rates for the current year.",
      "update_cadence": "annual (April/July)",
      "free": false,
      "url": "https://zaref.dev/v1/electricity-tariffs",
      "effective_date": "2026-04-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2027-04-01",
      "stale": false
    },
    {
      "slug": "municipal-tariffs",
      "title": "Metro municipal tariffs",
      "description": "Residential electricity/water/refuse/rates headline tariffs for the 5 big metros, current municipal year.",
      "update_cadence": "annual (1 July)",
      "free": false,
      "url": "https://zaref.dev/v1/municipal-tariffs",
      "effective_date": "2026-07-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2027-07-01",
      "stale": false
    },
    {
      "slug": "learnership-allowances",
      "title": "Learnership allowances",
      "description": "Minimum weekly learnership allowances per NQF level, per the current NMW gazette.",
      "update_cadence": "annual (March)",
      "free": false,
      "url": "https://zaref.dev/v1/learnership-allowances",
      "effective_date": "2026-03-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2027-03-01",
      "stale": false
    },
    {
      "slug": "sectoral-wages",
      "title": "Sectoral minimum wages",
      "description": "Minimum wages for sectors with their own determinations (contract cleaning, private security, etc.) beside the NMW.",
      "update_cadence": "annual (March)",
      "free": false,
      "url": "https://zaref.dev/v1/sectoral-wages",
      "effective_date": "2026-03-01",
      "last_confirmed": "2026-07-07",
      "next_expected_update": "2027-03-01",
      "stale": false
    }
  ]
}