# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-menzis-nl-api-034d4e92/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-menzis-nl-api-034d4e92/get_vergoeding_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-menzis-nl-api-034d4e92/get_verzekeringsvoorwaarden \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-menzis-nl-api-034d4e92/list_insurance_plans \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-menzis-nl-api-034d4e92/list_vergoedingen \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-menzis-nl-api-034d4e92/search_vergoedingen \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```