# Menzis — 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.

> Access Menzis insurance coverage details, search for specific reimbursements (vergoedingen), and retrieve plan terms and policy documents. Browse available insurance plans, view reimbursement amounts, and get comprehensive information about what each policy covers.

**Category:** Healthcare | **Website:** [menzis.nl/](https://menzis.nl/) | **Docs:** [parse.bot/marketplace/034d4e92-ea08-4345-96de-83f1798bf734/menzis-nl-api](https://parse.bot/marketplace/034d4e92-ea08-4345-96de-83f1798bf734/menzis-nl-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/menzis/`
**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 vergoeding detail

Get detailed coverage information for a specific reimbursement on Menzis.nl. Provide either a full URL or both letter and slug to identify the page. Returns plan-specific coverage details (keyed by plan name), FAQ entries, related documents, and a description. Coverage keys vary per reimbursement and correspond to insurance plan or package names.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Letter part of the URL path (e.g. 'a'). Required if url is not provided. |
| `slug` | string | No | Slug part of the URL path (e.g. 'acnebehandeling'). Required if url is not provided. |
| `url` | string | No | Full URL of the reimbursement detail page. If provided, letter and slug are ignored. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/menzis/get-vergoeding-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>","slug":"<string>","url":"<string>"}'
```

### Get verzekeringsvoorwaarden

List all policy documents and conditions pages available on Menzis.nl, organized by year. Returns links to yearly verzekeringsvoorwaarden (insurance conditions) pages. Each entry is a year-specific conditions index page, not individual PDF documents.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/menzis/get-verzekeringsvoorwaarden \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List insurance plans

List Menzis insurance plans (Basis and Aanvullend) scraped from the zorgverzekering pages. Returns plan names, types, and URLs. Plans are returned in a flat list covering both basic (Basis) and supplemental (Aanvullend) insurance products.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/menzis/list-insurance-plans \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List vergoedingen

List all reimbursements for a specific letter (a-z) from the A-Z index on Menzis.nl. Returns reimbursement names, URLs, and slugs for the given letter. Pages are organized alphabetically; each letter returns all matching items in a single response without further pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Single lowercase alphabetical letter to filter reimbursements (a-z). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/menzis/list-vergoedingen \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>"}'
```

### Search vergoedingen

Search for reimbursements by keyword on Menzis.nl. Returns matching reimbursement pages filtered to zorg-en-vergoedingen content, with title, description snippet, and URL. Results are relevance-ordered by the site's search engine; a single page of results is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'fysiotherapie', 'tandarts'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/menzis/search-vergoedingen \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<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.