{"x402Version":2,"name":"zaref","description":"South African reference data as clean, cited JSON: fuel prices, interest rates, tax tables, toll fees, municipal tariffs, wages, grants, plus 29 calculators and history. Task-shaped answers (payroll, income tax, VAT, wage checks, working days) return a complete cited result, a batch endpoint returns up to 10 series for one payment, and change-alert webhooks replace polling. Python client: pip install zaref.","url":"https://zaref.dev","payment":{"scheme":"exact","network":"eip155:8453","asset":"USDC","payTo":"0x6382E6929A20B7Eb02BdACfb5368362984B24C15","facilitator":"coinbase-cdp"},"pricing":{"series":"$0.005","history":"$0.01","calculators":"$0.01","bundle":"$0.025","changes":"$0.005","answers":"$0.02 to $0.10 per answer","alerts":"$0.10 per 90-day webhook subscription","batch":"$0.02 for up to 10 series in one call"},"free":["/catalog","/v1/public-holidays","/calc/vat","/llms.txt","/openapi.json","/mcp","/.well-known/x402.json","/.well-known/agent.json"],"resources":[{"url":"https://zaref.dev/v1/fuel-prices","method":"GET","price":"$0.005","description":"Current SA retail/wholesale fuel prices: petrol 93/95 (inland & coastal), diesel 50ppm, illuminating paraffin. Rand per litre."},{"url":"https://zaref.dev/v1/repo-prime","method":"GET","price":"$0.005","description":"SARB repo rate and prime lending rate, South Africa's benchmark interest rates, with last MPC change date."},{"url":"https://zaref.dev/v1/cpi","method":"GET","price":"$0.005","description":"Latest Stats SA headline consumer inflation, year-on-year %, with reference month."},{"url":"https://zaref.dev/v1/income-tax","method":"GET","price":"$0.005","description":"SARS personal income tax brackets, rebates and thresholds for the current SA tax year, the tables PAYE is calculated from."},{"url":"https://zaref.dev/v1/vat","method":"GET","price":"$0.005","description":"VAT rate currently in force in South Africa."},{"url":"https://zaref.dev/v1/uif-oid","method":"GET","price":"$0.005","description":"UIF contribution remuneration ceiling and OID (COIDA) earnings threshold."},{"url":"https://zaref.dev/v1/minimum-wage","method":"GET","price":"$0.005","description":"National minimum wage per hour, incl. special categories, with effective date."},{"url":"https://zaref.dev/v1/school-terms","method":"GET","price":"$0.005","description":"DBE public school term dates."},{"url":"https://zaref.dev/v1/sassa-grants","method":"GET","price":"$0.005","description":"All SASSA social grant amounts incl. SRD, with effective date."},{"url":"https://zaref.dev/v1/travel-rates","method":"GET","price":"$0.005","description":"SARS prescribed per-km reimbursement rate and subsistence allowances for the current tax year."},{"url":"https://zaref.dev/v1/tax-rates-other","method":"GET","price":"$0.005","description":"Corporate tax, dividends WHT, CGT inclusion, transfer duty brackets, retirement caps, medical tax credits, interest exemptions, estate/donations tax."},{"url":"https://zaref.dev/v1/unemployment","method":"GET","price":"$0.005","description":"Latest Stats SA QLFS official and expanded unemployment rates, with reference quarter."},{"url":"https://zaref.dev/v1/gdp","method":"GET","price":"$0.005","description":"Latest Stats SA GDP growth (QoQ and YoY), with reference quarter."},{"url":"https://zaref.dev/v1/ppi","method":"GET","price":"$0.005","description":"Latest Stats SA producer inflation YoY, with reference month."},{"url":"https://zaref.dev/v1/toll-fees","method":"GET","price":"$0.005","description":"Mainline toll plaza tariffs (vehicle classes 1-4) for the major national routes, current adjustment."},{"url":"https://zaref.dev/v1/electricity-tariffs","method":"GET","price":"$0.005","description":"NERSA-approved Eskom tariff increases and key residential rates for the current year."},{"url":"https://zaref.dev/v1/municipal-tariffs","method":"GET","price":"$0.005","description":"Residential electricity/water/refuse/rates headline tariffs for the 5 big metros, current municipal year."},{"url":"https://zaref.dev/v1/learnership-allowances","method":"GET","price":"$0.005","description":"Minimum weekly learnership allowances per NQF level, per the current NMW gazette."},{"url":"https://zaref.dev/v1/sectoral-wages","method":"GET","price":"$0.005","description":"Minimum wages for sectors with their own determinations (contract cleaning, private security, etc.) beside the NMW."},{"url":"https://zaref.dev/v1/sars-interest-rates","method":"GET","price":"$0.005","description":"Official rate of interest (fringe benefits, s7C loans), SARS interest on outstanding taxes and refunds, and the prescribed rate of interest for legal and judgment debts."},{"url":"https://zaref.dev/v1/retirement-limits","method":"GET","price":"$0.005","description":"Retirement contribution deduction cap, tax-free savings limits, retirement and withdrawal lump-sum tax tables, living-annuity thresholds."},{"url":"https://zaref.dev/v1/nca-max-rates","method":"GET","price":"$0.005","description":"Maximum lawful interest rates per credit type under National Credit Act (NCA) Regulation 42 Table A, computed at the current repo rate, plus the in duplum rule and service fee cap."},{"url":"https://zaref.dev/v1/bcea-thresholds","method":"GET","price":"$0.005","description":"The BCEA earnings threshold, which working-time protections fall away above it, the earnings definition and related LRA/EEA effects."},{"url":"https://zaref.dev/v1/tax-calendar","method":"GET","price":"$0.005","description":"SARS filing-season windows, provisional tax deadlines, employer reconciliation windows and recurring monthly deadlines."},{"url":"https://zaref.dev/v1/exchange-control","method":"GET","price":"$0.005","description":"Single discretionary allowance (R2m from April 2026), foreign investment allowance, minors' travel and cash export limits, with the TCS PIN rules."},{"url":"https://zaref.dev/v1/deeds-fees","method":"GET","price":"$0.005","description":"Deeds Office transfer and bond registration fee tiers, lodgement and ancillary fees, per the current gazetted schedule."},{"url":"https://zaref.dev/v1/fuel-levies","method":"GET","price":"$0.005","description":"General fuel levy, RAF levy and carbon fuel levy per litre for petrol and diesel, plus the carbon tax rate, including temporary relief episodes."},{"url":"https://zaref.dev/v1/zaronia","method":"GET","price":"$0.005","description":"SARB's ZARONIA risk-free overnight benchmark, the designated JIBAR successor (JIBAR ceases 2026-12-31), with the transition timeline and daily-rate history for compounded interest calculations."},{"url":"https://zaref.dev/v1/wear-and-tear-periods","method":"GET","price":"$0.005","description":"SARS BGR7 schedule of straight-line depreciation write-off periods (in years) for over 140 asset classes, plus the R7,000 small-item write-off threshold."},{"url":"https://zaref.dev/v1/fx-rates","method":"GET","price":"$0.005","description":"SARB indicative daily ZAR exchange rates against USD, GBP, EUR and JPY, plus the nominal effective exchange rate (trade-weighted) index."},{"url":"https://zaref.dev/v1/bond-yields","method":"GET","price":"$0.005","description":"SARB closing yields on the R2030 and R209 South African government benchmark bonds, key reference points for the domestic yield curve."},{"url":"https://zaref.dev/v1/sovereign-credit-rating","method":"GET","price":"$0.005","description":"South Africa's current credit rating and outlook from Moody's, S&P Global and Fitch, with each agency's most recent rating action date."},{"url":"https://zaref.dev/v1/tenders","method":"GET","price":"$0.005","description":"Live South African government tender feed from National Treasury's eTenders OCDS API: filter by province, procurement category, buyer, keyword and closing window. Returns compact tender records with closing dates, briefing sessions, documents and contacts."},{"url":"https://zaref.dev/v1/crypto-prices","method":"GET","price":"$0.005","description":"Live ZAR crypto prices from VALR's public market data: last traded, bid/ask, 24-hour high/low/volume and daily change for BTC, ETH and every other ZAR pair on the exchange."},{"url":"https://zaref.dev/v1/fuel-prices/history","method":"GET","price":"$0.01","description":"Dated history points for Fuel prices."},{"url":"https://zaref.dev/v1/repo-prime/history","method":"GET","price":"$0.01","description":"Dated history points for Repo & prime rate."},{"url":"https://zaref.dev/v1/cpi/history","method":"GET","price":"$0.01","description":"Dated history points for CPI (headline, YoY)."},{"url":"https://zaref.dev/v1/income-tax/history","method":"GET","price":"$0.01","description":"Dated history points for Income tax tables."},{"url":"https://zaref.dev/v1/vat/history","method":"GET","price":"$0.01","description":"Dated history points for VAT rate."},{"url":"https://zaref.dev/v1/uif-oid/history","method":"GET","price":"$0.01","description":"Dated history points for UIF & OID limits."},{"url":"https://zaref.dev/v1/minimum-wage/history","method":"GET","price":"$0.01","description":"Dated history points for National minimum wage."},{"url":"https://zaref.dev/v1/public-holidays/history","method":"GET","price":"$0.01","description":"Dated history points for Public holidays."},{"url":"https://zaref.dev/v1/school-terms/history","method":"GET","price":"$0.01","description":"Dated history points for School terms."},{"url":"https://zaref.dev/v1/sassa-grants/history","method":"GET","price":"$0.01","description":"Dated history points for SASSA grant amounts."},{"url":"https://zaref.dev/v1/travel-rates/history","method":"GET","price":"$0.01","description":"Dated history points for SARS travel rates."},{"url":"https://zaref.dev/v1/tax-rates-other/history","method":"GET","price":"$0.01","description":"Dated history points for Other national tax rates."},{"url":"https://zaref.dev/v1/unemployment/history","method":"GET","price":"$0.01","description":"Dated history points for Unemployment rate."},{"url":"https://zaref.dev/v1/gdp/history","method":"GET","price":"$0.01","description":"Dated history points for GDP growth."},{"url":"https://zaref.dev/v1/ppi/history","method":"GET","price":"$0.01","description":"Dated history points for PPI (final manufactured goods)."},{"url":"https://zaref.dev/v1/toll-fees/history","method":"GET","price":"$0.01","description":"Dated history points for Toll fees."},{"url":"https://zaref.dev/v1/electricity-tariffs/history","method":"GET","price":"$0.01","description":"Dated history points for Electricity tariffs."},{"url":"https://zaref.dev/v1/municipal-tariffs/history","method":"GET","price":"$0.01","description":"Dated history points for Metro municipal tariffs."},{"url":"https://zaref.dev/v1/learnership-allowances/history","method":"GET","price":"$0.01","description":"Dated history points for Learnership allowances."},{"url":"https://zaref.dev/v1/sectoral-wages/history","method":"GET","price":"$0.01","description":"Dated history points for Sectoral minimum wages."},{"url":"https://zaref.dev/v1/sars-interest-rates/history","method":"GET","price":"$0.01","description":"Dated history points for SARS & prescribed interest rates."},{"url":"https://zaref.dev/v1/retirement-limits/history","method":"GET","price":"$0.01","description":"Dated history points for Retirement & TFSA limits."},{"url":"https://zaref.dev/v1/nca-max-rates/history","method":"GET","price":"$0.01","description":"Dated history points for NCA maximum interest rates."},{"url":"https://zaref.dev/v1/bcea-thresholds/history","method":"GET","price":"$0.01","description":"Dated history points for BCEA earnings threshold."},{"url":"https://zaref.dev/v1/tax-calendar/history","method":"GET","price":"$0.01","description":"Dated history points for Tax calendar."},{"url":"https://zaref.dev/v1/exchange-control/history","method":"GET","price":"$0.01","description":"Dated history points for Exchange control allowances."},{"url":"https://zaref.dev/v1/deeds-fees/history","method":"GET","price":"$0.01","description":"Dated history points for Deeds Office fees."},{"url":"https://zaref.dev/v1/fuel-levies/history","method":"GET","price":"$0.01","description":"Dated history points for Fuel levies."},{"url":"https://zaref.dev/v1/zaronia/history","method":"GET","price":"$0.01","description":"Dated history points for ZARONIA benchmark rate."},{"url":"https://zaref.dev/v1/wear-and-tear-periods/history","method":"GET","price":"$0.01","description":"Dated history points for SARS wear-and-tear write-off periods."},{"url":"https://zaref.dev/v1/fx-rates/history","method":"GET","price":"$0.01","description":"Dated history points for ZAR exchange rates."},{"url":"https://zaref.dev/v1/bond-yields/history","method":"GET","price":"$0.01","description":"Dated history points for SA benchmark bond yields."},{"url":"https://zaref.dev/v1/sovereign-credit-rating/history","method":"GET","price":"$0.01","description":"Dated history points for SA sovereign credit rating."},{"url":"https://zaref.dev/v1/changes","method":"GET","price":"$0.005","description":"Which series changed or were reconfirmed since a given date. Optional since=YYYY-MM-DD, defaults to the last 30 days."},{"url":"https://zaref.dev/v1/all","method":"GET","price":"$0.025","description":"Snapshot of every series in one response."},{"url":"https://zaref.dev/v1/alerts","method":"POST","price":"$0.10","description":"Register an HTTPS webhook that fires when a subscribed series' verified values change. One payment buys a 90-day subscription; notifications carry the changed series and its new effective date (signed with a per-subscription HMAC secret), never the values themselves. Undeliverable endpoints are disabled after 10 consecutive failures.","example_body":{"url":"https://example.com/hooks/zaref","series":["fuel-prices","repo-prime"]}},{"url":"https://zaref.dev/v1/batch","method":"POST","price":"$0.02","description":"Fetch up to 10 series in one settled call. Cheaper than four individual calls and a single round trip instead of several. Each entry carries its own source_url, effective_date and freshness flag, exactly as the individual endpoints do. Supports as_at for a point-in-time batch.","example_body":{"series":["repo-prime","fuel-prices","vat","cpi"]}}],"calculators":[{"url":"https://zaref.dev/calc/income-tax?annual=750000&age=40","method":"GET","price":"$0.01","description":"SA personal income tax (PAYE) for the current tax year: annual and monthly tax, effective and marginal rate, SARS age rebates applied."},{"url":"https://zaref.dev/calc/net-salary?monthly=50000&age=35","method":"GET","price":"$0.01","description":"Net take-home from a gross monthly salary: PAYE plus employee UIF at the current tables."},{"url":"https://zaref.dev/calc/transfer-duty?price=2500000","method":"GET","price":"$0.01","description":"Property transfer duty from the current SARS brackets."},{"url":"https://zaref.dev/calc/fuel-cost?km=568&l_per_100km=7.5&fuel=petrol_95&region=inland","method":"GET","price":"$0.01","description":"Fuel cost for a trip at current official SA fuel prices."},{"url":"https://zaref.dev/calc/toll-route?route=N3&vehicle_class=1","method":"GET","price":"$0.01","description":"Total mainline toll cost for a full run of a national route at current gazetted tariffs."},{"url":"https://zaref.dev/calc/vat?amount=1000&direction=add","method":"GET","price":"free","description":"Add or strip VAT at the current SA rate (direction=add | remove | strip; unrecognised values are rejected). Free."},{"url":"https://zaref.dev/calc/cgt?gain=500000&type=individual&taxable_income=800000","method":"GET","price":"$0.01","description":"Capital gains tax for individuals (marginal method), companies and trusts."},{"url":"https://zaref.dev/calc/estate-duty?estate=10000000","method":"GET","price":"$0.01","description":"Estate duty after the section 4A abatement, tiered at R30m."},{"url":"https://zaref.dev/calc/learnership?nqf=4&credits=200","method":"GET","price":"$0.01","description":"Minimum weekly learnership allowance by NQF level and credits."},{"url":"https://zaref.dev/calc/lump-sum-tax?amount=1200000&type=retirement","method":"GET","price":"$0.01","description":"Tax on a retirement fund lump sum or withdrawal using the cumulative SARS method (prior lump sums aggregate)."},{"url":"https://zaref.dev/calc/nca-max-rate?type=unsecured","method":"GET","price":"$0.01","description":"Maximum lawful interest rate for a credit agreement under NCA Regulation 42 Table A, at the current or a given repo rate."},{"url":"https://zaref.dev/calc/property-costs?price=2500000&bond=2000000","method":"GET","price":"$0.01","description":"Total statutory costs of buying a property: transfer duty plus Deeds Office transfer, bond and lodgement fees."},{"url":"https://zaref.dev/calc/two-pot-withdrawal?amount=50000&annual_income=600000","method":"GET","price":"$0.01","description":"Tax on a two-pot retirement savings-component withdrawal at the member's marginal rate."},{"url":"https://zaref.dev/calc/travel-allowance?monthly_allowance=8000&annual_income=720000","method":"GET","price":"$0.01","description":"PAYE inclusion and monthly tax impact of a fixed travel allowance under the 80/20 rule."},{"url":"https://zaref.dev/calc/company-car?vehicle_value=450000&maintenance_plan=true&annual_income=720000","method":"GET","price":"$0.01","description":"Company car fringe benefit: monthly taxable value (3.5%/3.25%) and PAYE impact."},{"url":"https://zaref.dev/calc/bond-repayment?amount=1500000&years=20","method":"GET","price":"$0.01","description":"Monthly bond repayment and total interest, at the live prime rate by default."},{"url":"https://zaref.dev/calc/zaronia-interest?principal=1000000&start=2026-07-10&end=2026-07-14","method":"GET","price":"$0.01","description":"Compound-in-arrears interest on a principal over a date range, using zaref's accumulating daily ZARONIA history (ACT/365). Coverage limited to dates zaref has tracked."},{"url":"https://zaref.dev/calc/uif?monthly_salary=25000","method":"GET","price":"$0.01","description":"Monthly UIF contribution (employee 1% + employer 1%) at the current earnings ceiling."},{"url":"https://zaref.dev/calc/donations-tax?amount=500000","method":"GET","price":"$0.01","description":"Donations tax owed on a donation, after the annual natural-person exemption."},{"url":"https://zaref.dev/calc/local-interest?amount=40000&age=40","method":"GET","price":"$0.01","description":"Taxable local interest after the age-based annual exemption."},{"url":"https://zaref.dev/calc/medical-tax-credit?members=1&dependants=2&out_of_pocket_annual=15000&taxable_income=500000","method":"GET","price":"$0.01","description":"Medical scheme (medical aid) fees tax credit plus the additional medical expenses tax credit from qualifying out-of-pocket costs."},{"url":"https://zaref.dev/calc/provisional-tax?annual_taxable_income=900000&employees_tax_paid=180000","method":"GET","price":"$0.01","description":"Estimated first and second provisional tax payments (50/50 split) net of employees' tax already withheld, with the current filing deadlines."},{"url":"https://zaref.dev/calc/net-to-gross?net_monthly=40000&age=35","method":"GET","price":"$0.01","description":"Gross monthly salary required to net a target take-home amount, at the current tax tables."},{"url":"https://zaref.dev/calc/home-office-expense?office_area_m2=12&home_area_m2=180&annual_home_costs=240000","method":"GET","price":"$0.01","description":"Deductible home office expense by area apportionment (s23(b)/(m))."},{"url":"https://zaref.dev/calc/sbc-tax?annual_taxable_income=600000","method":"GET","price":"$0.01","description":"Small Business Corporation income tax at the progressive SBC rates (eligibility conditions apply)."},{"url":"https://zaref.dev/calc/wear-and-tear?asset=Passenger%20cars&cost=350000","method":"GET","price":"$0.01","description":"Annual and monthly straight-line wear-and-tear allowance for an asset, using the SARS BGR7 write-off period schedule."},{"url":"https://zaref.dev/calc/crypto-tax?capital_gain=150000&revenue_gain=50000&other_taxable_income=600000&age=35","method":"GET","price":"$0.01","description":"Estimated SA tax on crypto asset gains: revenue-nature profits taxed at the marginal rate, capital-nature gains via CGT with the annual exclusion and 40% inclusion. Handles staking/mining/airdrop receipts and FIFO batch matching of a raw buy/sell transaction list."},{"url":"https://zaref.dev/calc/crypto-classify?holding_period_months=30&trades_per_month=1&intention=hold_long_term","method":"GET","price":"$0.01","description":"Indicative capital-vs-revenue classification of crypto gains by weighing the classic SA case-law factors: intention, holding period and trading frequency."},{"url":"https://zaref.dev/calc/bond-price?face_value=1000000&coupon_percent=8&years_to_maturity=4","method":"GET","price":"$0.01","description":"Clean price of a fixed-rate bond from face value, coupon and years to maturity, at a given yield (defaults to the live R2030 benchmark yield)."}],"answers":[{"url":"https://zaref.dev/v1/answers/income-tax","method":"POST","price":"$0.05","description":"Full income-tax answer for one taxpayer: tax due after age rebates and medical scheme credits, effective rate, monthly PAYE equivalent, with the component calculations included.","example_body":{"annual":480000,"age":34,"medical_members":2}},{"url":"https://zaref.dev/v1/answers/payroll","method":"POST","price":"$0.10","description":"One employee's monthly payroll: PAYE with age rebates, pension deductibility (27.5% / R430k cap), medical scheme credit, employee and employer UIF, take-home pay, employer cost, BCEA earnings-threshold flag and an optional minimum-wage check.","example_body":{"monthly_gross":40000,"age":34,"pension_percent":7.5,"medical_members":2,"hours_per_week":45}},{"url":"https://zaref.dev/v1/answers/vat","method":"POST","price":"$0.02","description":"VAT answer at the rate currently in force: add or remove VAT on an amount, with the rate's status, effective date and official citation.","example_body":{"amount":1000,"direction":"add"}},{"url":"https://zaref.dev/v1/answers/wage-check","method":"POST","price":"$0.05","description":"National minimum wage compliance verdict for a wage: compliant or not, the applicable floor (standard, farm, domestic or EPWP) and the shortfall per hour, with the gazette citation.","example_body":{"monthly_wage":6000,"hours_per_week":45,"worker_type":"domestic"}},{"url":"https://zaref.dev/v1/answers/working-days","method":"POST","price":"$0.02","description":"Working days between two dates (inclusive), excluding weekends and SA public holidays from the verified holiday series, listing the holidays in range.","example_body":{"from":"2026-08-01","to":"2026-08-31"}}],"discovery":{"catalog":"https://zaref.dev/catalog","openapi":"https://zaref.dev/openapi.json","llms":"https://zaref.dev/llms.txt","mcp":"https://zaref.dev/mcp"}}