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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-bzaek-de-api-0e346138/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-bzaek-de-api-0e346138/get_all_goz_codes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bzaek-de-api-0e346138/get_analog_codes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bzaek-de-api-0e346138/get_goae_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bzaek-de-api-0e346138/get_goz_code_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bzaek-de-api-0e346138/get_goz_sections \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bzaek-de-api-0e346138/get_goz_sections_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bzaek-de-api-0e346138/get_stellungnahmen_zur_goz \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bzaek-de-api-0e346138/get_urteiledatenbank \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bzaek-de-api-0e346138/list_goz_codes_by_section \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bzaek-de-api-0e346138/search_goz \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```