# Bzaek — 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 comprehensive German dental and medical fee schedules (GOZ and GOÄ) with detailed billing codes, pricing information, analog codes, and legal rulings to streamline your practice billing and coding decisions. Search specific procedures, browse organized sections, and review professional statements to ensure accurate fee assessment and compliance.

**Category:** Healthcare | **Website:** [bzaek.de/](https://bzaek.de/) | **Docs:** [parse.bot/marketplace/0e346138-c459-4975-a165-a4d932fcc30f/bzaek-de-api](https://parse.bot/marketplace/0e346138-c459-4975-a165-a4d932fcc30f/bzaek-de-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/bzaek/`
**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 all goz codes

Iterates through all sections and retrieves GOZ code details (code, points, fees) for each. Results are limited by the limit parameter to control request volume. Each code includes url, code number, description, point value, and fee breakdown.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of code details to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bzaek/get-all-goz-codes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Get analog codes

Returns the catalog of analog billing services organized by section. Analog codes are used when a procedure has no direct GOZ number. Each section lists service descriptions.

**Estimated cost:** Metered

_No parameters required._

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

### Get goae info

Returns information and PDF download links for GOAE (Gebuehrenordnung fuer Aerzte) codes relevant to dental practice. Includes the page title, content text explaining GOAE usage in dentistry, and available PDF downloads.

**Estimated cost:** Metered

_No parameters required._

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

### Get goz code detail

Fetches the full detail for a specific GOZ code including description, point value, fees at different factors (1.0x, 2.3x, 3.5x), commentary, billing provisions, and related codes. Requires both the code number and section slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `code` | string | Yes | The 4-digit GOZ code number (e.g. '0010', '2000', '9010'). |
| `section_slug` | string | Yes | URL slug of the section containing the code, obtained from get_goz_sections (e.g. 'allgemeine-zahnaerztliche-leistungen'). |

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

### Get goz sections

Returns all GOZ sections (A through L) with their names, slugs, and URLs. Each section organizes the fee schedule by dental specialty area. Use the slug from results to drill into individual sections.

**Estimated cost:** Metered

_No parameters required._

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

### Get goz sections overview

Fetches the overview page listing all GOZ codes across all sections A through L. Returns sections organized by title with arrays of codes (code number, label, url) and a total count across all sections.

**Estimated cost:** Metered

_No parameters required._

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

### Get stellungnahmen zur goz

Returns official position statements on GOZ billing questions published by the BZAEK. Each statement includes title and link to full text.

**Estimated cost:** Metered

_No parameters required._

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

### Get urteiledatenbank

Returns court rulings related to the GOZ fee schedule. Each ruling includes title, legal category, description summary, and link to full ruling text.

**Estimated cost:** Metered

_No parameters required._

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

### List goz codes by section

Returns all GOZ code numbers and labels listed in a specific section. Each code entry includes the 4-digit code number, display label, and URL to its detail page. Use the section_slug from get_goz_sections to identify the section.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `section_slug` | string | Yes | URL slug of the section, obtained from get_goz_sections results (e.g. 'allgemeine-zahnaerztliche-leistungen', 'prophylaktische-leistungen', 'konservierende-leistungen'). |

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

### Search goz

Performs a site-wide search for GOZ-related terms and returns matching results with titles, URLs, and content snippets. Uses the BZAEK site search engine.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query string (e.g. 'Karies', 'Implantat', 'Prophylaxe'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bzaek/search-goz \
  -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.