# Nahlizenidokn Cuzk Gov — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/nahlizenidokn-cuzk-gov/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/nahlizenidokn-cuzk-gov/get-cadastral-territory-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/nahlizenidokn-cuzk-gov/get-object-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/nahlizenidokn-cuzk-gov/search-building-by-address \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/nahlizenidokn-cuzk-gov/search-lv \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/nahlizenidokn-cuzk-gov/search-parcel-by-address \
  -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://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.