# Nahlizenidokn Cuzk Gov — 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.

> Search for buildings, parcels, and land registry sheets across the Czech cadastre by address or code to view property characteristics, unit lists, and map previews. Access comprehensive property information and cadastral territory details, though ownership names and full registry contents require government ID verification.

**Category:** Government & Public Data | **Website:** [nahlizenidokn.cuzk.gov.cz/](https://nahlizenidokn.cuzk.gov.cz/) | **Docs:** [parse.bot/marketplace/352bc0d6-26a4-478d-a26e-ea97f5519d51/nahlizenidokn-cuzk-gov-cz-api](https://parse.bot/marketplace/352bc0d6-26a4-478d-a26e-ea97f5519d51/nahlizenidokn-cuzk-gov-cz-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-nahlizenidokn-cuzk-gov-cz-api-352bc0d6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cadastral_territory_info

Search for cadastral territory information (name and code) by keyword. Returns matching cadastral territories with their numeric codes, useful for constructing inputs to search_lv and other endpoints that require a cadastral territory code.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Keyword to search for cadastral territories (e.g. 'Žižkov', 'Vinohrady', 'Smíchov', 'Nové Město'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nahlizenidokn-cuzk-gov-cz-api-352bc0d6/get_cadastral_territory_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_object_details

Get detailed information for any cadastral object (parcel, building, unit, LV) using its encrypted session token or full URL from other search results. Accepts either a bare NAHL~ token or a full URL containing one.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `token` | string | Yes | The 'encrypted' parameter value (starts with 'NAHL~') or a full URL from other search results. Obtained from URL fields in responses of search_building_by_address, search_parcel_by_address, or search_lv. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nahlizenidokn-cuzk-gov-cz-api-352bc0d6/get_object_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token":"<string>"}'
```

### search_building_by_address

Search for property (parcel/building) details by Czech address string. Uses the ČÚZK address autocomplete to find the best match, then retrieves the property detail page. Returns comprehensive cadastral data including parcel number, area, land type, building information, and map URL. The result combines parcel and building data for the address location.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Czech-format address string with street, number, and city (e.g. 'Václavské náměstí 1, Praha', 'Náměstí Republiky 1, Praha'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nahlizenidokn-cuzk-gov-cz-api-352bc0d6/search_building_by_address \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_lv

Search for a land registry sheet (LV) by cadastral territory code and LV number. Uses a two-step form submission: first validates the cadastral territory, then searches for the specific LV. Returns stale_input if the LV is not found. Full LV contents (ownership, property lists) require government ID (NIA) authentication.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ku` | string | Yes | Cadastral territory code (e.g. '727415' for Žižkov, '727181' for Nové Město). Obtainable from get_cadastral_territory_info. |
| `lv` | string | Yes | LV number (e.g. '2008', '384'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nahlizenidokn-cuzk-gov-cz-api-352bc0d6/search_lv \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ku":"<string>","lv":"<string>"}'
```

### search_parcel_by_address

Search for parcel (pozemek) details by Czech address string. Finds the property at the given address and returns comprehensive parcel information including area, land type, building references, and cadastral territory data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Czech-format address string with street, number, and city (e.g. 'Náměstí Republiky 1, Praha', 'Václavské náměstí 1, Praha'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nahlizenidokn-cuzk-gov-cz-api-352bc0d6/search_parcel_by_address \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```