# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/rbnz/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/rbnz/get-past-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/rbnz/get-upcoming-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"event_type":"<string>","limit":"<integer>","page":"<integer>","topic":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.