canonical: https://jentic.com/apis/bodenrichtwert.ai/bodenrichtwert

# bodenrichtwert.ai API

The bodenrichtwert.ai API returns the official German land value (Bodenrichtwert) for a full address in EUR per square meter, with the land use type, reference date, municipality, and source attribution. It also calculates the density-adjusted land value (Bodenwert) for a specific plot and reports your profile and current usage. Coverage spans all German states except Schleswig-Holstein, Sachsen, and Bayern, which are blocked for legal reasons and return HTTP 451.

## For AI agents

Look up official German land values (Bodenrichtwert) by address in EUR per square meter, calculate the density-adjusted Bodenwert for a plot, and read account usage.

## Scope

Does not list properties for sale, calculate mortgages, or render maps. Use for official German land-value (Bodenrichtwert) lookup only.

## Capabilities

- Look up the official German land value (Bodenrichtwert) for a full address in EUR per square meter
- Calculate the density-adjusted land value (Bodenwert) for a plot
- Read the land use type, reference date, municipality, and source behind a value
- Check your profile and current usage statistics

## Use cases

### Agent land-value lookup

An AI agent prices a German property's land. Through Jentic the agent passes a full German address and reads back the official Bodenrichtwert in EUR per square meter, along with the land use type, reference date, and source, so a valuation step cites an authoritative figure rather than an estimate. The source attribution makes the number defensible in a report.

Example prompt: Look up the Bodenrichtwert for a full German address and return the value with its land use type and source

### Plot valuation

A developer needs the density-adjusted value of a specific plot. The Bodenwert operation calculates the plot's land value from the base Bodenrichtwert and the plot's characteristics, so an agent can produce a plot-specific figure rather than the area reference value. This supports a feasibility check before a purchase.

Example prompt: Calculate the Bodenwert for a plot given its address and size, and return the adjusted land value

### Coverage-aware automation

A batch job handles the states the API cannot cover. Because Schleswig-Holstein, Sachsen, and Bayern return HTTP 451, an agent that reads many addresses can detect the 451 response and route those addresses to a manual path while valuing the rest automatically. This keeps a bulk valuation run from stalling on blocked regions.

Example prompt: Look up land values for a list of addresses, flag any that return HTTP 451, and value the rest automatically

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/api/bodenrichtwert` | Get the official land value for a German address |
| POST | `/api/bodenwert` | Calculate the Bodenwert (density-adjusted land value) for a plot |
| GET | `/api/me` | Get your profile and current usage statistics |

## Key resources

- **Bodenrichtwert** — Official land value for a German address with source attribution
- **Bodenwert** — Density-adjusted land value calculated for a specific plot
- **Account** — Profile and current usage statistics

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 67 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 74 / 100
  - Developer Experience & Jentic Compatibility: 70 / 100
  - AI-Readiness & Agent Experience: 54 / 100
  - Agent Usability: 94 / 100
  - Security: 55 / 100
  - AI Discoverability: 75 / 100
- **View full report:** https://jentic.com/apis/bodenrichtwert.ai/bodenrichtwert/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the bodenrichtwert.ai API by hand means picking one of its three auth methods (an OAuth 2.0 flow, a bearer API key, or the same key as a token query parameter), handling the HTTP 451 responses for the three states it cannot cover, and parsing the source attribution yourself. Through Jentic you install once, import it from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** The bodenrichtwert.ai API has no per-resource path to pin, so you choose which of its three operations your agent may call: it can look up land values and read usage without the plot-value calculation unless you add it. The address travels in the request, so rules bound which operations the agent calls, not which region.
- **Credential handling:** Your bodenrichtwert.ai API key is held once, encrypted, by your own Jentic One instance and injected at execution time as a header credential, not the weaker query-parameter token. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'German land value for an address' or 'calculate a plot's land value', and Jentic returns the matching bodenrichtwert.ai operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **ATTOM Data** — Property and land valuation data, focused on the US market
- **RentCast** — Property value and rent estimates by address
- **Mapbox** — Geocodes and maps the addresses this API values

## FAQ

### What authentication does the bodenrichtwert.ai API use?

The bodenrichtwert.ai API authenticates three ways per its OpenAPI spec: an OAuth 2.0 authorization-code flow, a static API key sent as a bearer token in the Authorization header, or the same key passed as a token query parameter for spreadsheet clients. Through Jentic the key is injected at call time by your own Jentic One instance, so it never enters the agent's prompt or logs.

### Can I get the land value for a German address with the bodenrichtwert.ai API?

Yes. The Bodenrichtwert operation returns the official land value in EUR per square meter for a full German address, along with the land use type, reference date, municipality, and source attribution. For a density-adjusted figure on a specific plot, the Bodenwert operation calculates the plot's land value.

### Which German states does the bodenrichtwert.ai API cover?

The API covers all German states except Schleswig-Holstein, Sachsen, and Bayern, which are blocked for legal reasons and return HTTP 451. Requests for addresses in the other states return a land value as normal.

### What are the rate limits for the bodenrichtwert.ai API?

The OpenAPI spec does not specify rate limits, though the account operation reports your current usage. Check the provider's dashboard at https://bodenrichtwert.ai for current limits.

### Is there a bodenrichtwert.ai MCP server?

You don't need an MCP server to give your agent the bodenrichtwert.ai API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls it, so you skip installing and syncing a separate server.

### Can I limit what my agent is allowed to do with the bodenrichtwert.ai API?

Yes. Write a rule that allows only the land-value lookup operation, so your agent can read Bodenrichtwerte but cannot run the plot calculation or read your account usage until you add those operations. Every call it makes is logged.

### How do I look up a land value with the bodenrichtwert.ai API through Jentic?

Search Jentic for 'German land value for an address' and it returns the lookup operation with its input schema; the agent passes a full German address and reads back the value, land use type, and source. To run it on your own infrastructure, install Jentic One from its GitHub repo.