Govt APIrbnz.govt.nz ↗
Access upcoming and past Reserve Bank of New Zealand events via API. Filter by topic or event type, get dates, descriptions, and URLs for all RBNZ announcements.
What is the Govt API?
The RBNZ Events API exposes two endpoints — get_upcoming_events and get_past_events — that return structured data for Reserve Bank of New Zealand events including titles, start/end datetimes, topic tags, event type classifications, descriptions, and direct URLs. Each response also surfaces facet counts across all available topics and event types, making it straightforward to enumerate the full filter space before querying.
curl -X GET 'https://api.parse.bot/scraper/8c108587-b9e2-4da8-9f43-a30b9a2008c2/get_upcoming_events?event_type=Announcements' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns upcoming RBNZ events (those whose end date is today or in the future), sorted by start date ascending. Each event includes title, description, start/end datetimes, topics, event types, and URL. Supports filtering by topic or event type. Paginated via page and limit parameters; omitting both returns the first 10 results.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed). |
| limit | integer | Number of results per page (1-50). |
| topic | string | Filter by topic name (e.g. 'Monetary policy', 'Financial stability', 'Official Cash Rate'). Values are returned in the available_topics field of a prior response. |
| event_type | string | Filter by event type (e.g. 'Announcements', 'Media conference', 'Speech', 'External event'). Values are returned in the available_types field of a prior response. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"limit": "integer results per page",
"events": "array of event objects with title, description, event_start, event_end, topics, types, url, permanent_id",
"total_count": "integer total number of matching events",
"available_types": "array of event type filter values with counts",
"available_topics": "array of topic filter values with counts"
},
"sample": {
"data": {
"page": 1,
"limit": 10,
"events": [
{
"url": "https://www.rbnz.govt.nz/news-and-events/events/2026/september/monetary-policy-statement-and-ocr-september-2026",
"title": "Monetary Policy Statement and OCR September 2026",
"types": [
"Announcements",
"Media conference"
],
"topics": [
"Official Cash Rate",
"Monetary policy"
],
"event_end": "2026-09-02T04:00:00+00:00",
"description": "We publish our Monetary Policy Statement (MPS) quarterly. This includes any changes to the official cash rate (OCR).",
"event_start": "2026-09-02T02:00:00+00:00",
"permanent_id": "A6ED960517144421B9929F5300D2A2DD"
}
],
"total_count": 15,
"available_types": [
{
"count": 15,
"value": "Announcements"
}
],
"available_topics": [
{
"count": 3,
"value": "Financial stability"
},
{
"count": 12,
"value": "Monetary policy"
}
]
},
"status": "success"
}
}About the Govt API
What the API Returns
Both endpoints return paginated arrays of RBNZ event objects. Each event carries a title, description, event_start and event_end datetime, a topics array (e.g. Monetary policy, Financial stability, Official Cash Rate), a types array (e.g. Announcements, Speech, Media conference, External event), a url to the event page, and a permanent_id. The get_upcoming_events endpoint sorts by start date ascending; get_past_events sorts descending so the most recent past event appears first.
Filtering and Pagination
Both endpoints accept topic and event_type string parameters to narrow results. Valid values for both filters are returned in every response as available_topics and available_types, each with counts reflecting the current query scope. Pagination is controlled by page (1-indexed) and limit (1–50 results per page); the total_count field tells you how many records match the current filter combination.
Scope and Freshness
The boundary between upcoming and past events is determined by whether the event's end date falls on or after today. get_upcoming_events covers scheduled RBNZ events from today forward — useful for tracking OCR decision dates, scheduled speeches, and announcements. get_past_events provides the historical record of the same event types, queryable by the same topic and type filters.
The Govt API is a managed, monitored endpoint for rbnz.govt.nz — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when rbnz.govt.nz changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official rbnz.govt.nz API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Alert systems that notify subscribers when new OCR (Official Cash Rate) announcement events appear in
get_upcoming_events - Calendar integrations that import upcoming RBNZ speeches and media conferences using
event_startandevent_endfields - Financial research tools that aggregate past RBNZ monetary policy events by date range using
get_past_eventswith theMonetary policytopic filter - News monitoring dashboards that surface upcoming
Announcementstype events ahead of publication - Historical analysis pipelines that count RBNZ event frequency by type using
available_typescounts fromget_past_events - Compliance and audit tools that verify RBNZ public communication activity across
Financial stabilitytopics over a given period
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Reserve Bank of New Zealand offer an official developer API?+
How do I find which topic and event type values are valid before filtering?+
available_topics and available_types arrays. Each entry contains the filter string and the count of matching events under the current query. Calling either endpoint without filters returns the full facet set, so you can inspect valid values before narrowing a query.Does the API return event location or venue information?+
Can I retrieve the full text of speeches or announcements through this API?+
description field and a url linking to the event page, but does not return the full text content of speeches or release documents. You can fork this API on Parse and revise it to add an endpoint that fetches full content from the individual event URLs.What is the maximum number of events returned per request?+
limit parameter accepts values between 1 and 50. For result sets larger than 50 events, use the page parameter alongside total_count to iterate through all pages. Both get_upcoming_events and get_past_events follow the same pagination contract.