# Rbnz — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track and monitor Reserve Bank of New Zealand announcements and activities by accessing upcoming and past events with their topics, types, dates, and detailed descriptions. Stay informed about RBNZ monetary policy decisions, speeches, and official releases to plan your financial strategies accordingly.

**Category:** Government & Public Data | **Website:** [www.rbnz.govt.nz/news-and-events/events](https://www.rbnz.govt.nz/news-and-events/events) | **Docs:** [parse.bot/marketplace/37658ce8-c62a-4c3e-a746-e8558bb0833a/rbnz-govt-nz-api](https://parse.bot/marketplace/37658ce8-c62a-4c3e-a746-e8558bb0833a/rbnz-govt-nz-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-rbnz-govt-nz-api-37658ce8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_past_events

Returns past RBNZ events (those whose end date is before today), sorted by start date descending (most recent first). 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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_type` | string | No | Filter by event type (e.g. 'Announcements', 'Media conference', 'Speech', 'External event'). Values are returned in the available_types field of a prior response. |
| `limit` | integer | No | Number of results per page (1-50). |
| `page` | integer | No | Page number (1-indexed). |
| `topic` | string | No | 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. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rbnz-govt-nz-api-37658ce8/get_past_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_type":"<string>","limit":"<integer>","page":"<integer>","topic":"<string>"}'
```

### get_upcoming_events

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_type` | string | No | Filter by event type (e.g. 'Announcements', 'Media conference', 'Speech', 'External event'). Values are returned in the available_types field of a prior response. |
| `limit` | integer | No | Number of results per page (1-50). |
| `page` | integer | No | Page number (1-indexed). |
| `topic` | string | No | 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. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rbnz-govt-nz-api-37658ce8/get_upcoming_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_type":"<string>","limit":"<integer>","page":"<integer>","topic":"<string>"}'
```