{"uid":"cap_YZCoNZDhBYyvxifkQpHeS","slug":"zaref-south-african-reference-data-alerts-webhook-registration-435431dc","name":"zaref South African Reference Data Alerts – Webhook Registration","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/alerts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"type":"object"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KpZ-dsJKvVxtCnqXzIN6I","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers a webhook URL to receive POST notifications whenever watched South African reference data series (fuel prices, interest rates, FX, etc.) are updated","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Fuel price spike alert for fleet manager","prompt":"Register my webhook at https://fleet.mycompany.co.za/alerts to get notified on zaref every time the South African fuel price series changes — I need to update our cost models immediately when it moves."},{"title":"FX rate monitor for treasury team","prompt":"Subscribe https://treasury.acme.com/webhooks/zaref to zaref alerts for the South African rand FX and bond yield series so our treasury system gets a push notification whenever those rates are updated."},{"title":"Broad economic data watcher for research dashboard","prompt":"Hook up https://research.myplatform.io/ingest/zaref to receive alerts for all South African reference data series on zaref — I want my dashboard to refresh automatically whenever any data is published."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:31:03.187Z","isFirstParty":false,"canonicalSlug":"zaref-south-african-reference-data-alerts-webhook-registration-435431dc"}