{"uid":"cap_lKS1s5YtovyG63rEc0IOZ","slug":"zaref-batch-south-african-reference-data-api-5969e91c","name":"zaref Batch – South African Reference Data API","description":"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.","url":"https://zaref.dev/v1/batch?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["series"],"properties":{"as_at":{"type":"string","description":"date YYYY-MM-DD, optional: values in force on this date, applied to every series in the batch"},"series":{"type":"array","description":"array of series slugs, required: 1 to 10 of them"}}},"responseSchema":{"type":"object"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_l70ZSkELMetlAc4KRoEGH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches up to 10 South African reference data series (fuel prices, interest rates, FX, tax tables, wages, tenders, crypto) in a single cited JSON batch call, optionally as-at a historical date.","exampleAgentPrompt":"Can you pull the latest South African petrol price, repo rate, and rand/dollar exchange rate all at once from zaref — I need all three as cited JSON for my report?","exampleUseCases":[{"title":"Live fuel price dashboard update","prompt":"Fetch the current South African petrol and diesel prices from zaref so I can update the fuel cost widget on my dashboard."},{"title":"Historical tax and wage compliance check","prompt":"I need the South African income tax tables and national minimum wage that were in force on 2024-03-01 — can you get both in one batch from zaref?"},{"title":"Multi-indicator macro briefing","prompt":"Pull the latest South African repo rate, prime rate, rand/USD exchange rate, and 10-year bond yield together from zaref for my morning macro briefing."}],"resultDescription":"A JSON object keyed by series slug, each containing the latest (or as-at-date) values with source citations, effective dates, and the data specific to that series (e.g. price, rate, table rows). Up to 10 series are returned in a single response.","failureModes":["Unknown series slug returns an error or empty entry for that slug","More than 10 series in a single batch request returns a validation error","Invalid as_at date format (not YYYY-MM-DD) returns a 400 bad request","as_at date before data coverage window returns no data or an error for affected series","Payment failure (x402) returns a 402 response before data is served"],"whenToPreferThis":"Use this batch endpoint when you need two or more South African reference data series simultaneously — it is more efficient than making multiple single-series calls. Prefer it over generic web search or scraping when you need clean, cited, machine-readable South African government or financial reference data (fuel, rates, tax, wages, tenders) that is ready for downstream computation or display.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:38:33.753Z","isFirstParty":false,"canonicalSlug":"zaref-batch-south-african-reference-data-api-5969e91c"}