API reference
v0.107.0The REST API gives your own applications the operations of the MCP server: search, decision texts, the citation graph, datapackages and the citation check. Every endpoint is the twin of an MCP tool, with the same arguments, the same answer and the same price.
Getting started
Create an API token in Settings, API tokens. The token acts for the organization you have open when you create it. Every call is charged to that organization. It expires after 365 days unless you choose a shorter lifetime. The token is shown once. Keep it like a password, and revoke it at once if it leaks.
Open API tokens in settingsSend the token as a Bearer token with every request:
curl "https://klaracase.de/api/v1/decisions/search?query=Untreue%20Gesch%C3%A4ftsf%C3%BChrer" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Token abilities
A token does only what its abilities allow. Each endpoint names the ability it needs. A token without that ability gets a 403 with the code token_ability_missing. klaracase charges nothing.
- search: search decisions, and statutes with decisions.
- read: read decisions, norms, corpus coverage and filter values.
- graph: read the citation graph of a decision.
- datapackage: assemble datapackages.
- citation-check: check citations, upload documents and read the results.
Prices and credits
A call costs the same credits as the matching MCP tool. Each endpoint below names its price. An answer your organization already paid for in the credit period, on the web app, the API or over MCP, costs nothing more. The 30 free starter credits for new verified users apply to the API too. Every answer states its cost and the remaining balance in the field credits. Out of credits before the period ends? On Professional, and on Enterprise where the contract provides it, an organization admin can top up the API budget, which pays for further calls over the API and MCP. On Free and Starter, a larger plan adds more credits. For questions, use the contact page. There are no credit packs yet.
Credits and repeats: what counts as the same answerCredits, API budget and limits
Every priced call is paid in credits. This section explains where the credits come from, what happens when they run out, and what a program does then.
Plan credits
Each plan includes credits for one credit period. They pay for the web app, the API and MCP together. A paid plan renews them when the next credit period starts.
API budget
On the Professional plan, and on Enterprise where the contract provides it, an organization admin can load a prepaid API budget in euros. The API budget pays for calls over the API and over MCP once the plan credits are used up. It does not expire. The web app does not use it: when the plan credits are used up, the web app stops. The API budget is for programs and AI assistants, which should not stop halfway through a task.
Top up the API budgetOrder of payment
The plan credits are spent first. The API budget pays for the rest, at the rate on the pricing page. A call is paid in full or it does not run: if the plan credits and the API budget together cannot pay for it, nothing is executed and nothing is charged. A call never runs in part.
Limits per token and per connection
An organization admin can set a credit limit for each API token and each MCP connection. The limit counts plan credits and API budget credits together in one credit period. When a token reaches its limit, only that token is refused. The other tokens of the organization keep working. The count starts again with the next credit period.
Three refusals and what a program does
Each refusal answers HTTP 402 with a stable code. Nothing ran and nothing was charged. A refusal stays the same until a person acts or the credit period ends, so do not retry it in a loop.
code: insufficient_credits, reason: api_budget_emptyThe organization may load an API budget, and what it holds does not cover this call. The program stops and tells its user that an organization admin must top up the API budget. The answer carries top_up_url for that admin.code: insufficient_credits, reason: api_budget_not_availableThe organization has no API budget that can pay for the call: its plan has none, or its budget is on hold. The program stops and tells its user. The call can run again when the next credit period starts, when an organization admin has changed the plan, or when klaracase has settled the open payment question with the organization.code: token_limit_reachedThe token or connection reached its credit limit. The answer carries cap, spent and resets_at. The program stops and tells its user that an organization admin must change the limit, or it waits until resets_at. Other tokens keep working.The value plan_credits_exhausted for reason is reserved. The API does not serve it today. A client must tolerate a reason value it does not know and treat it like api_budget_not_available.
top_up_url and settings_url are for a human admin. A program or an AI agent never opens them, never follows them and never submits anything there. It shows the link to its user and stops.
Fields in the answer
Every answer carries the credits block with metered, cost and credits_remaining. cost counts the credits that the plan and the API budget paid together. credits_remaining is the plan credits left and never includes the API budget. An organization that holds an API budget, or may load one, also gets api_budget with cents (what is left, in euro cents), rate_cents_per_credit and credits_at_rate (how many more credits that pays for). For any other organization the key is absent.
An answer paid from the API budget{
"credits": {
"metered": true,
"cost": 1,
"credits_remaining": 0,
"api_budget": {
"cents": 4991,
"rate_cents_per_credit": 9,
"credits_at_rate": 554
}
}
}{
"type": "https://klaracase.de/docs/api/errors#insufficient_credits",
"title": "Payment Required",
"status": 402,
"detail": "The plan credits for this billing period are used up and the API budget does not cover this call, so it did not run and nothing was charged. An organization admin can top up the API budget.",
"code": "insufficient_credits",
"cost": 1,
"balance": 0,
"reason": "api_budget_empty",
"top_up_url": "https://klaracase.de/org/billing/api-budget"
}Price
The price per credit from the API budget stands on the pricing page. This page shows no price.
Go to the pricing pageRate limits and daily caps
Each token may make 60 requests per minute. Datapackages, citation checks and uploads have a further limit of 10 per minute. Each organization also has a daily cap, by plan, on the search rows and the full texts it receives. Above a limit you get a 429 with retry_after_seconds. klaracase executes nothing and charges nothing.
| Plan | Search rows and graph neighbours per day | Full texts per day |
|---|---|---|
| free | 1,000 | 40 |
| starter | 5,000 | 200 |
| professional | 20,000 | 600 |
| enterprise | 60,000 | 2,000 |
Errors
Every error is an RFC 9457 problem in the format application/problem+json, with type, title, status, detail and a stable code. A 402 adds cost and balance. A 429 adds retry_after_seconds. A 422 adds errors, with the messages per argument. A 403 for a missing ability adds required_ability. If your organization requires two-factor sign-in for all members and the token's user has not set it up, every call gets a 403 with the code two_factor_required. klaracase charges nothing until they set it up.
Versioning
The major version in the path, /api/v1, is the contract. Within v1 we only add: new fields, new optional parameters and new values. A removal or a change of meaning comes as /api/v2. We announce the end of an endpoint with the Deprecation and Sunset headers at least six months ahead. Every answer carries the X-Klaracase-Api-Release header with the release that served it.
OpenAPI spec (JSON)Data processing
The API processes your requests on our server in Germany. When you search by content, external AI services receive the text of a search query and process it in the EU. On /api/v1/search the laws section can also send the query to a language model in the EU; bridge=false prevents that. Checking citations runs without AI services. The privacy and security page names the providers.
Privacy and securityExamples by area of law
For each area of law, a page of its own shows an example query and how to connect through MCP and the REST API.
Citation check
/api/v1/citation-checksParameters
textstringbodyThe German legal text to verify, e.g. a Schriftsatz paragraph citing "§ 573 BGB" and "VIII ZR 232/15" (min 50 characters, max 20000; longer documents are checked in the Citation Check of the web app). The length is a floor, not the gate: the text must also look like German legal text. Response offsets are Unicode codepoint offsets into THIS exact string.
reference_datestringbodyOPTIONAL document date, ISO `YYYY-MM-DD`, e.g. "2016-12-14". It is applied to every statute citation whose own sentence names no date; a sentence that states its own date always wins. It gates the pre-reform-numbering advisory and changes no verdict. Each finding reports which date it used in `evidence.citation_date_source` (`sentence` | `reference_date` | `none`).
document_idstringbodyThe id of an upload whose `status` is `ready` (POST /citation-checks takes this or `text`, never both). The check consumes the upload.
Request
curl -X POST "https://klaracase.de/api/v1/citation-checks" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Responses
{
"id": "0193b0c5-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
"status": "complete",
"source": "api_v1",
"progress": {
"citations_total": 2,
"citations_checked": 2,
"unique_citations_total": 2
},
"verdict_counts": {
"verified_corpus": 1,
"not_found": 1
},
"partial": false,
"unverified_count": 0,
"reason_counts": [
{
"category": "statute_unknown",
"count": 1
}
],
"unique_citations": [
{
"key_basis": "matched_decision",
"target_artifact_id": "0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"canonical": "BGH 1 StR 185/01",
"spellings": [
"BGH, Urt. v. 15.11.2001 – 1 StR 185/01"
],
"occurrences": 1,
"verdict": "verified_corpus",
"reference_type": "case"
},
{
"key_basis": "canonical",
"target_artifact_id": null,
"canonical": "§ 266a Abs. 9 StGB",
"spellings": [
"§ 266a Abs. 9 StGB"
],
"occurrences": 1,
"verdict": "not_found",
"reference_type": "statute"
}
],
"extraction": {
"detected": 2,
"dropped": 0,
"dropped_unreadable": 0,
"dropped_truncation": 0,
"dropped_trailing_noun": 0,
"dropped_stacked_subdivision": 0,
"dropped_refused_collision": 0,
"dropped_by_token": [],
"dropped_unreadable_texts": [],
"refused_contract_collision": [],
"not_verifiable": 0,
"not_verifiable_by_type": [],
"possible_citations_unparsed": 0,
"possible_citations_unparsed_texts": []
},
"notes": [],
"findings_unavailable_reason": null,
"findings_purged_at": null,
"findings": [
{
"id": "0193b0c5-2b3c-7d4e-9f50-6b7c8d9e0f1a",
"raw_text": "BGH, Urt. v. 15.11.2001 – 1 StR 185/01",
"canonical": "BGH 1 StR 185/01",
"type": "case",
"role": null,
"verdict": "verified_corpus",
"external_status": "skipped",
"start_offset": 118,
"end_offset": 157,
"occurrence_index": 0,
"confidence": null,
"matched_decision": {
"artifact_id": "0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"ecli": "ECLI:DE:BGH:2001:151101U1STR185.01.0",
"court": "BGH",
"date": "2001-11-15"
},
"subdivision_check": "not_checked",
"subdivision_advisory": null,
"check_scope": {
"subdivision": "not_applicable",
"article_text_available": null,
"article_text_read": false,
"court": "checked"
},
"ambiguity_advisory": null,
"coverage": null,
"coverage_boundary": null,
"coverage_advisory": null,
"evidence": {
"reason": "exact_match",
"match_strength": "exact"
},
"disputed_at": null
}
],
"submitted_at": "2026-10-01T10:00:00+00:00",
"completed_at": "2026-10-01T10:00:00+00:00",
"created_at": "2026-10-01T10:00:00+00:00",
"payload_truncated": false,
"api_version": "0.107.0",
"changelog_url": "https://klaracase.de/docs/mcp/changelog",
"credits": {
"metered": true,
"cost": 2,
"credits_remaining": 18
}
}{
"type": "https://klaracase.de/docs/api/errors#unauthenticated",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication is required. Send a Klaracase API token as a Bearer token.",
"code": "unauthenticated"
}{
"type": "https://klaracase.de/docs/api/errors#insufficient_credits",
"title": "Payment Required",
"status": 402,
"detail": "Insufficient credits: this call costs 2 credit(s), but organization \"Kanzlei Beispiel\" has 0 remaining in the current period. The plan credits for this billing period are used up. An organization admin can change the plan at https://klaracase.de/org/billing/plans. For questions about credits, write to us through https://klaracase.de/support. Credits renew automatically at the start of the next credit period, which is the next calendar month (UTC) on a free plan.",
"code": "insufficient_credits",
"cost": 2,
"balance": 0
}{
"type": "https://klaracase.de/docs/api/errors#token_ability_missing",
"title": "Forbidden",
"status": 403,
"detail": "This API token does not carry the `citation-check` ability this endpoint needs. Nothing was executed and nothing was charged. Create a token with that ability in Settings, API tokens.",
"code": "token_ability_missing",
"required_ability": "citation-check"
}{
"type": "https://klaracase.de/docs/api/errors#token_org_missing",
"title": "Conflict",
"status": 409,
"detail": "This API token was created before tokens named an organization, so the API cannot tell which organization it acts for. Create a new token in Settings, API tokens; it acts for the organization you have open.",
"code": "token_org_missing"
}{
"type": "https://klaracase.de/docs/api/errors#validation_failed",
"title": "Unprocessable Content",
"status": 422,
"detail": "The selected text is invalid.",
"code": "validation_failed",
"errors": {
"text": [
"The selected text is invalid."
]
}
}{
"type": "https://klaracase.de/docs/api/errors#rate_limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Too many requests for this token. Wait `retry_after_seconds` and retry. Nothing was executed and nothing was charged.",
"code": "rate_limited",
"retry_after_seconds": 42
}{
"type": "https://klaracase.de/docs/api/errors#backend_unavailable",
"title": "Service Unavailable",
"status": 503,
"detail": "The backend could not complete this call, so nothing was charged. Retry in a few seconds.",
"code": "backend_unavailable"
}/api/v1/citation-checks/{run}Request
curl "https://klaracase.de/api/v1/citation-checks/{run}" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Responses
{
"id": "0193b0c5-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
"status": "complete",
"source": "api_v1",
"progress": {
"citations_total": 2,
"citations_checked": 2,
"unique_citations_total": 2
},
"verdict_counts": {
"verified_corpus": 1,
"not_found": 1
},
"partial": false,
"unverified_count": 0,
"reason_counts": [
{
"category": "statute_unknown",
"count": 1
}
],
"unique_citations": [
{
"key_basis": "matched_decision",
"target_artifact_id": "0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"canonical": "BGH 1 StR 185/01",
"spellings": [
"BGH, Urt. v. 15.11.2001 – 1 StR 185/01"
],
"occurrences": 1,
"verdict": "verified_corpus",
"reference_type": "case"
},
{
"key_basis": "canonical",
"target_artifact_id": null,
"canonical": "§ 266a Abs. 9 StGB",
"spellings": [
"§ 266a Abs. 9 StGB"
],
"occurrences": 1,
"verdict": "not_found",
"reference_type": "statute"
}
],
"extraction": {
"detected": 2,
"dropped": 0,
"dropped_unreadable": 0,
"dropped_truncation": 0,
"dropped_trailing_noun": 0,
"dropped_stacked_subdivision": 0,
"dropped_refused_collision": 0,
"dropped_by_token": [],
"dropped_unreadable_texts": [],
"refused_contract_collision": [],
"not_verifiable": 0,
"not_verifiable_by_type": [],
"possible_citations_unparsed": 0,
"possible_citations_unparsed_texts": []
},
"notes": [],
"findings_unavailable_reason": null,
"findings_purged_at": null,
"findings": [
{
"id": "0193b0c5-2b3c-7d4e-9f50-6b7c8d9e0f1a",
"raw_text": "BGH, Urt. v. 15.11.2001 – 1 StR 185/01",
"canonical": "BGH 1 StR 185/01",
"type": "case",
"role": null,
"verdict": "verified_corpus",
"external_status": "skipped",
"start_offset": 118,
"end_offset": 157,
"occurrence_index": 0,
"confidence": null,
"matched_decision": {
"artifact_id": "0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"ecli": "ECLI:DE:BGH:2001:151101U1STR185.01.0",
"court": "BGH",
"date": "2001-11-15"
},
"subdivision_check": "not_checked",
"subdivision_advisory": null,
"check_scope": {
"subdivision": "not_applicable",
"article_text_available": null,
"article_text_read": false,
"court": "checked"
},
"ambiguity_advisory": null,
"coverage": null,
"coverage_boundary": null,
"coverage_advisory": null,
"evidence": {
"reason": "exact_match",
"match_strength": "exact"
},
"disputed_at": null
}
],
"submitted_at": "2026-10-01T10:00:00+00:00",
"completed_at": "2026-10-01T10:00:00+00:00",
"created_at": "2026-10-01T10:00:00+00:00",
"payload_truncated": false,
"api_version": "0.107.0",
"changelog_url": "https://klaracase.de/docs/mcp/changelog",
"credits": {
"metered": true,
"cost": 0,
"credits_remaining": 18
}
}{
"type": "https://klaracase.de/docs/api/errors#unauthenticated",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication is required. Send a Klaracase API token as a Bearer token.",
"code": "unauthenticated"
}{
"type": "https://klaracase.de/docs/api/errors#token_ability_missing",
"title": "Forbidden",
"status": 403,
"detail": "This API token does not carry the `citation-check` ability this endpoint needs. Nothing was executed and nothing was charged. Create a token with that ability in Settings, API tokens.",
"code": "token_ability_missing",
"required_ability": "citation-check"
}{
"type": "https://klaracase.de/docs/api/errors#not_found",
"title": "Not Found",
"status": 404,
"detail": "The requested resource does not exist, or it belongs to another organization.",
"code": "not_found"
}{
"type": "https://klaracase.de/docs/api/errors#token_org_missing",
"title": "Conflict",
"status": 409,
"detail": "This API token was created before tokens named an organization, so the API cannot tell which organization it acts for. Create a new token in Settings, API tokens; it acts for the organization you have open.",
"code": "token_org_missing"
}{
"type": "https://klaracase.de/docs/api/errors#validation_failed",
"title": "Unprocessable Content",
"status": 422,
"detail": "The selected id is invalid.",
"code": "validation_failed",
"errors": {
"id": [
"The selected id is invalid."
]
}
}{
"type": "https://klaracase.de/docs/api/errors#rate_limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Too many requests for this token. Wait `retry_after_seconds` and retry. Nothing was executed and nothing was charged.",
"code": "rate_limited",
"retry_after_seconds": 42
}/api/v1/citation-check-documentsParameters
fileRequiredstringbodyThe document: PDF, DOCX, Markdown or plain text, up to 25 MB, sent as multipart/form-data.
Request
curl -X POST "https://klaracase.de/api/v1/citation-check-documents" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Responses
{
"id": "0193b0c6-3c4d-7e5f-8a60-7c8d9e0f1a2b",
"filename": "schriftsatz.pdf",
"format": "pdf",
"status": "uploaded",
"char_count": null,
"page_count": null,
"pages_without_text_layer": null,
"check_max_chars": 20000,
"quoted_credits": null,
"error_code": null,
"expires_at": "2026-10-02T10:00:00+00:00",
"created_at": "2026-10-01T10:00:00+00:00",
"api_version": "0.107.0",
"changelog_url": "https://klaracase.de/docs/mcp/changelog",
"credits": {
"metered": true,
"cost": 0,
"credits_remaining": 18
}
}{
"type": "https://klaracase.de/docs/api/errors#unauthenticated",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication is required. Send a Klaracase API token as a Bearer token.",
"code": "unauthenticated"
}{
"type": "https://klaracase.de/docs/api/errors#token_ability_missing",
"title": "Forbidden",
"status": 403,
"detail": "This API token does not carry the `citation-check` ability this endpoint needs. Nothing was executed and nothing was charged. Create a token with that ability in Settings, API tokens.",
"code": "token_ability_missing",
"required_ability": "citation-check"
}{
"type": "https://klaracase.de/docs/api/errors#token_org_missing",
"title": "Conflict",
"status": 409,
"detail": "This API token was created before tokens named an organization, so the API cannot tell which organization it acts for. Create a new token in Settings, API tokens; it acts for the organization you have open.",
"code": "token_org_missing"
}{
"type": "https://klaracase.de/docs/api/errors#validation_failed",
"title": "Unprocessable Content",
"status": 422,
"detail": "The selected file is invalid.",
"code": "validation_failed",
"errors": {
"file": [
"The selected file is invalid."
]
}
}{
"type": "https://klaracase.de/docs/api/errors#rate_limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Too many requests for this token. Wait `retry_after_seconds` and retry. Nothing was executed and nothing was charged.",
"code": "rate_limited",
"retry_after_seconds": 42
}/api/v1/citation-check-documents/{document}Request
curl "https://klaracase.de/api/v1/citation-check-documents/{document}" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Responses
{
"id": "0193b0c6-3c4d-7e5f-8a60-7c8d9e0f1a2b",
"filename": "schriftsatz.pdf",
"format": "pdf",
"status": "ready",
"char_count": 14830,
"page_count": 6,
"pages_without_text_layer": 0,
"check_max_chars": 20000,
"quoted_credits": 2,
"error_code": null,
"expires_at": "2026-10-02T10:00:00+00:00",
"created_at": "2026-10-01T10:00:00+00:00",
"api_version": "0.107.0",
"changelog_url": "https://klaracase.de/docs/mcp/changelog",
"credits": {
"metered": true,
"cost": 0,
"credits_remaining": 18
}
}{
"type": "https://klaracase.de/docs/api/errors#unauthenticated",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication is required. Send a Klaracase API token as a Bearer token.",
"code": "unauthenticated"
}{
"type": "https://klaracase.de/docs/api/errors#token_ability_missing",
"title": "Forbidden",
"status": 403,
"detail": "This API token does not carry the `citation-check` ability this endpoint needs. Nothing was executed and nothing was charged. Create a token with that ability in Settings, API tokens.",
"code": "token_ability_missing",
"required_ability": "citation-check"
}{
"type": "https://klaracase.de/docs/api/errors#not_found",
"title": "Not Found",
"status": 404,
"detail": "The requested resource does not exist, or it belongs to another organization.",
"code": "not_found"
}{
"type": "https://klaracase.de/docs/api/errors#token_org_missing",
"title": "Conflict",
"status": 409,
"detail": "This API token was created before tokens named an organization, so the API cannot tell which organization it acts for. Create a new token in Settings, API tokens; it acts for the organization you have open.",
"code": "token_org_missing"
}{
"type": "https://klaracase.de/docs/api/errors#validation_failed",
"title": "Unprocessable Content",
"status": 422,
"detail": "The selected id is invalid.",
"code": "validation_failed",
"errors": {
"id": [
"The selected id is invalid."
]
}
}{
"type": "https://klaracase.de/docs/api/errors#rate_limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Too many requests for this token. Wait `retry_after_seconds` and retry. Nothing was executed and nothing was charged.",
"code": "rate_limited",
"retry_after_seconds": 42
}Citation graph
/api/v1/decisions/{id}/citationsParameters
directionoutgoingincomingbothquery"outgoing" = decisions this one cites (references), "incoming" = decisions citing this one (referenced_by), "both" (default) = both directions.
depth12query1 or 2. 1 (default) = direct neighbours; 2 = neighbours of neighbours, capped at 50 distinct neighbour decisions besides the source and served as a bounded sample.
courtstringqueryOptional disambiguator for an Aktenzeichen `id`: the canonical court short form, e.g. "BVerfG" or "OLG Hamm". Ignored for UUID lookups.
datestringqueryOptional disambiguator for an Aktenzeichen `id`: the decision date in YYYY-MM-DD, e.g. "2018-04-11".
pageintegerquery1-based page, e.g. 2 (default 1), over the SOURCE decision's neighbour lists, 25 distinct decisions per direction, up to page 20. Defined at depth 1 only.
Request
curl "https://klaracase.de/api/v1/decisions/{id}/citations" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Responses
{
"source": {
"id": "0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"aktenzeichen": "1 StR 185/01",
"court": "BGH",
"date": "2001-11-15"
},
"references": [
{
"reference_canonical": "BGH 1 StR 50/15",
"reference_role": "leitentscheidung",
"resolution_status": "resolved",
"in_corpus": true,
"corpus": {
"artifact_id": "0193b0c4-6a2d-7c4e-8f10-2b3c4d5e6f70",
"court": "BGH",
"date": "2015-03-12",
"az": "1 StR 50/15",
"document_type": "Urteil",
"ecli": null,
"corpus_url": "https://klaracase.de/decisions/0193b0c4-6a2d-7c4e-8f10-2b3c4d5e6f70"
},
"from_artifact_id": "0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"hop": 1
}
],
"referenced_by": [
{
"reference_canonical": "BGH 1 StR 185/01",
"reference_role": null,
"resolution_status": "resolved",
"in_corpus": true,
"corpus": {
"artifact_id": "0193b0c4-7b3e-7d5f-9a21-3c4d5e6f7a81",
"court": "BGH",
"date": "2022-06-08",
"az": "4 StR 200/22",
"document_type": "Beschluss",
"ecli": null,
"corpus_url": "https://klaracase.de/decisions/0193b0c4-7b3e-7d5f-9a21-3c4d5e6f7a81"
},
"from_artifact_id": "0193b0c4-7b3e-7d5f-9a21-3c4d5e6f7a81",
"hop": 1
}
],
"served_direction": "both",
"served_references_total": 1,
"served_referenced_by_total": 1,
"references_total": 1,
"references_resolved_total": 1,
"referenced_by_total": 1,
"references_unresolved_total": 0,
"references_withheld_reasons": [],
"totals_scope": "source_decision_hop_1",
"per_direction_cap": 25,
"unresolved_cap": 25,
"node_cap": 50,
"truncated": false,
"nodes_omitted": 0,
"payload_truncated": false,
"pagination": {
"page": 1,
"page_size": 25,
"max_page": 20,
"reachable_distinct_max": 500,
"references_pages": 1,
"referenced_by_pages": 1,
"has_more_references": false,
"has_more_referenced_by": false,
"applies_at_depth": 1
},
"fortgeltung_checked": false,
"fortgeltung_note": "Rechtskraft/Fortgeltung (whether a decision is still good law) is NOT checked. A decision returned here may have been quashed or superseded on appeal, and the ABSENCE of any such note is not evidence that it still stands.",
"api_version": "0.107.0",
"changelog_url": "https://klaracase.de/docs/mcp/changelog",
"credits": {
"metered": true,
"cost": 2,
"credits_remaining": 25
}
}{
"type": "https://klaracase.de/docs/api/errors#unauthenticated",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication is required. Send a Klaracase API token as a Bearer token.",
"code": "unauthenticated"
}{
"type": "https://klaracase.de/docs/api/errors#insufficient_credits",
"title": "Payment Required",
"status": 402,
"detail": "Insufficient credits: this call costs 2 credit(s), but organization \"Kanzlei Beispiel\" has 0 remaining in the current period. The plan credits for this billing period are used up. An organization admin can change the plan at https://klaracase.de/org/billing/plans. For questions about credits, write to us through https://klaracase.de/support. Credits renew automatically at the start of the next credit period, which is the next calendar month (UTC) on a free plan.",
"code": "insufficient_credits",
"cost": 2,
"balance": 0
}{
"type": "https://klaracase.de/docs/api/errors#token_ability_missing",
"title": "Forbidden",
"status": 403,
"detail": "This API token does not carry the `graph` ability this endpoint needs. Nothing was executed and nothing was charged. Create a token with that ability in Settings, API tokens.",
"code": "token_ability_missing",
"required_ability": "graph"
}{
"type": "https://klaracase.de/docs/api/errors#not_found",
"title": "Not Found",
"status": 404,
"detail": "The requested resource does not exist, or it belongs to another organization.",
"code": "not_found"
}{
"type": "https://klaracase.de/docs/api/errors#token_org_missing",
"title": "Conflict",
"status": 409,
"detail": "This API token was created before tokens named an organization, so the API cannot tell which organization it acts for. Create a new token in Settings, API tokens; it acts for the organization you have open.",
"code": "token_org_missing"
}{
"type": "https://klaracase.de/docs/api/errors#validation_failed",
"title": "Unprocessable Content",
"status": 422,
"detail": "The selected direction is invalid.",
"code": "validation_failed",
"errors": {
"direction": [
"The selected direction is invalid."
]
}
}{
"type": "https://klaracase.de/docs/api/errors#rate_limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Too many requests for this token. Wait `retry_after_seconds` and retry. Nothing was executed and nothing was charged.",
"code": "rate_limited",
"retry_after_seconds": 42
}{
"type": "https://klaracase.de/docs/api/errors#backend_unavailable",
"title": "Service Unavailable",
"status": 503,
"detail": "The backend could not complete this call, so nothing was charged. Retry in a few seconds.",
"code": "backend_unavailable"
}Corpus
/api/v1/corpus/coverageParameters
branchordentlichverwaltungsozialarbeitfinanzverfassungpatentunbekanntqueryScope the report to one Gerichtsbarkeit slug, e.g. "finanz". A branch is a COURT JURISDICTION, not a legal subject area: "patent" is the Bundespatentgericht. Omit to report every branch.
topintegerqueryCap on the per-court rows, busiest first, e.g. 10 (default 20, max 100). The branch rollup is never capped.
Request
curl "https://klaracase.de/api/v1/corpus/coverage" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Responses
{
"total_decisions": {
"value": 100000,
"is_floor": false
},
"branches": [
{
"branch": "ordentlich",
"count": {
"value": 60000,
"is_floor": false
},
"earliest": "1950-10",
"latest": "2026-09",
"court_founding_year": 1950,
"court_founding_basis": "branch_wide_weakest_court_floor",
"has_dates_below_floor": false,
"instance_mix": {
"federal": {
"value": 25000,
"is_floor": false
},
"appellate": {
"value": 20000,
"is_floor": false
},
"first_instance_and_regional": {
"value": 15000,
"is_floor": false
},
"other": {
"value": 0,
"is_floor": false
},
"note": "Instanzmix: 42% Bundesgerichte, 33% Obergerichte, 25% Eingangs- und Landgerichte. …"
},
"top_courts": [
{
"court": "BGH",
"count": {
"value": 25000,
"is_floor": false
},
"earliest": "1950-10",
"latest": "2026-09"
}
]
}
],
"courts": [
{
"court": "BGH",
"branch": "ordentlich",
"count": {
"value": 25000,
"is_floor": false
},
"earliest": "1950-10",
"latest": "2026-09",
"court_founding_year": 1950,
"court_founding_basis": "court_floor",
"has_dates_below_floor": false
}
],
"courts_returned": 20,
"courts_total": 400,
"corpus_floors": "Earliest decision we hold per Gerichtsbarkeit … ordentlich 1950+. …",
"coverage_ranges": {
"note": "The ingestion boundary every `out_of_coverage` verdict is decided against. …",
"scope": "all",
"verified_at": "2026-08-13",
"ranges": [
{
"bucket": "BGH_STRAFRECHT",
"court": "BGH",
"label": "BGH Strafsachen",
"from": "1950-10-02",
"until": null,
"sources": [
"ris"
],
"exhaustive": true,
"ocr": true,
"note": "Strafsenate ab 1950.",
"holdings_earliest": null
}
]
},
"as_of": "2026-10-01T09:58:12+00:00",
"filter_coverage_caveats": "Three known blind spots, all on scanned decisions. …",
"law_coverage": {
"note": "The law texts behind the citation check are German federal statutes, plus the EU and international instruments listed beside this note. …",
"eu": [
"AEUV",
"DSGVO"
],
"international": [
"EMRK"
]
},
"api_version": "0.107.0",
"changelog_url": "https://klaracase.de/docs/mcp/changelog",
"credits": {
"metered": true,
"cost": 0,
"credits_remaining": 30
}
}{
"type": "https://klaracase.de/docs/api/errors#unauthenticated",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication is required. Send a Klaracase API token as a Bearer token.",
"code": "unauthenticated"
}{
"type": "https://klaracase.de/docs/api/errors#token_ability_missing",
"title": "Forbidden",
"status": 403,
"detail": "This API token does not carry the `read` ability this endpoint needs. Nothing was executed and nothing was charged. Create a token with that ability in Settings, API tokens.",
"code": "token_ability_missing",
"required_ability": "read"
}{
"type": "https://klaracase.de/docs/api/errors#token_org_missing",
"title": "Conflict",
"status": 409,
"detail": "This API token was created before tokens named an organization, so the API cannot tell which organization it acts for. Create a new token in Settings, API tokens; it acts for the organization you have open.",
"code": "token_org_missing"
}{
"type": "https://klaracase.de/docs/api/errors#validation_failed",
"title": "Unprocessable Content",
"status": 422,
"detail": "The selected branch is invalid.",
"code": "validation_failed",
"errors": {
"branch": [
"The selected branch is invalid."
]
}
}{
"type": "https://klaracase.de/docs/api/errors#rate_limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Too many requests for this token. Wait `retry_after_seconds` and retry. Nothing was executed and nothing was charged.",
"code": "rate_limited",
"retry_after_seconds": 42
}{
"type": "https://klaracase.de/docs/api/errors#backend_unavailable",
"title": "Service Unavailable",
"status": 503,
"detail": "The backend could not complete this call, so nothing was charged. Retry in a few seconds.",
"code": "backend_unavailable"
}/api/v1/corpus/facets/{field}Parameters
typedecisionlawqueryRestrict the counts to one artifact type, "decision" or "law". Omit to count across both. Ignored for field="cited_norms".
normstringqueryRequired with field="cited_norms", ignored otherwise: the norm whose family to list, e.g. "§ 543 BGB". Canonicalized before use and echoed back.
prefixstringqueryCase-insensitive prefix filter on the facet value. A trailing space counts: prefix="AG " excludes "AGH Niedersachsen", prefix="AG" keeps it.
Request
curl "https://klaracase.de/api/v1/corpus/facets/{field}" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Responses
{
"field": "court_name",
"applies_to": "DECISION",
"values": {
"BGH": {
"value": 90000,
"is_floor": false
},
"BVerfG": {
"value": 20000,
"is_floor": false
},
"BVerwG": {
"value": 15000,
"is_floor": false
}
},
"total_values": 3,
"truncated": false,
"value_limit": 500,
"count_basis": "indexed_passages",
"as_of": "2026-10-01T09:40:00+00:00",
"api_version": "0.107.0",
"changelog_url": "https://klaracase.de/docs/mcp/changelog",
"credits": {
"metered": true,
"cost": 0,
"credits_remaining": 30
}
}{
"type": "https://klaracase.de/docs/api/errors#unauthenticated",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication is required. Send a Klaracase API token as a Bearer token.",
"code": "unauthenticated"
}{
"type": "https://klaracase.de/docs/api/errors#token_ability_missing",
"title": "Forbidden",
"status": 403,
"detail": "This API token does not carry the `read` ability this endpoint needs. Nothing was executed and nothing was charged. Create a token with that ability in Settings, API tokens.",
"code": "token_ability_missing",
"required_ability": "read"
}{
"type": "https://klaracase.de/docs/api/errors#token_org_missing",
"title": "Conflict",
"status": 409,
"detail": "This API token was created before tokens named an organization, so the API cannot tell which organization it acts for. Create a new token in Settings, API tokens; it acts for the organization you have open.",
"code": "token_org_missing"
}{
"type": "https://klaracase.de/docs/api/errors#validation_failed",
"title": "Unprocessable Content",
"status": 422,
"detail": "The selected type is invalid.",
"code": "validation_failed",
"errors": {
"type": [
"The selected type is invalid."
]
}
}{
"type": "https://klaracase.de/docs/api/errors#rate_limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Too many requests for this token. Wait `retry_after_seconds` and retry. Nothing was executed and nothing was charged.",
"code": "rate_limited",
"retry_after_seconds": 42
}{
"type": "https://klaracase.de/docs/api/errors#backend_unavailable",
"title": "Service Unavailable",
"status": 503,
"detail": "The backend could not complete this call, so nothing was charged. Retry in a few seconds.",
"code": "backend_unavailable"
}Datapackages
/api/v1/datapackagesParameters
idsRequiredarraybody1-10 decision ids. Order matters: the response budget drops decisions from the END. Duplicates collapse into one decision; `requested`, `included` and `deduped` report that.
include_citationsbooleanbodyInclude each decision's outgoing citation edges: true (default) or false.
full_textbooleanbodyServe whole judgments instead of ~700-character excerpts: true or false (default). Token-heavy; excerpts plus targeted get_decision calls are the lighter alternative.
max_charsintegerbodyPer-decision text cap when `full_text` is true, e.g. 20000 (default 60000, minimum 500, maximum 200000). A ceiling, not a guarantee: the response budget outranks it.
Request
curl -X POST "https://klaracase.de/api/v1/datapackages" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Responses
{
"decisions": [
{
"id": "0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"aktenzeichen": "1 StR 185/01",
"court": "BGH",
"date": "2001-11-15",
"document_type": "Urteil",
"ecli": "ECLI:DE:BGH:2001:151101U1STR185.01.0",
"jurisdiction": "DE",
"excerpt": "Tenor … Gründe: I. Der Angeklagte war Geschäftsführer …",
"excerpt_span": "document_start",
"text_length": 48213,
"truncated": true,
"fortgeltung_checked": false,
"fortgeltung_note": "Rechtskraft/Fortgeltung (whether a decision is still good law) is NOT checked. A decision returned here may have been quashed or superseded on appeal, and the ABSENCE of any such note is not evidence that it still stands."
}
],
"citation_edges": [
{
"reference_canonical": "BGH 1 StR 50/15",
"reference_role": "leitentscheidung",
"resolution_status": "resolved",
"in_corpus": true,
"corpus": {
"artifact_id": "0193b0c4-6a2d-7c4e-8f10-2b3c4d5e6f70",
"court": "BGH",
"date": "2015-03-12",
"az": "1 StR 50/15",
"document_type": "Urteil",
"ecli": null,
"corpus_url": "https://klaracase.de/decisions/0193b0c4-6a2d-7c4e-8f10-2b3c4d5e6f70"
},
"from_artifact_id": "0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d"
}
],
"edge_accounting": [
{
"from_artifact_id": "0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"unit": "edge_rows",
"edges_total": 1,
"edges_included": 1,
"edges_resolved_included": 1,
"edges_unresolved_included": 0,
"edges_resolved_total": 1,
"edges_unresolved_total": 0,
"targets_resolved_included": 1,
"targets_resolved_total": 1
}
],
"per_source_resolved_target_cap": 25,
"per_source_unresolved_edge_row_cap": 25,
"requested": 1,
"included": 1,
"deduped": 0,
"text_mode": "excerpt",
"max_chars": 700,
"truncated": false,
"payload_truncated": false,
"assembled_at": "2026-10-01T10:00:00+00:00",
"api_version": "0.107.0",
"changelog_url": "https://klaracase.de/docs/mcp/changelog",
"credits": {
"metered": true,
"cost": 5,
"credits_remaining": 20
}
}{
"type": "https://klaracase.de/docs/api/errors#unauthenticated",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication is required. Send a Klaracase API token as a Bearer token.",
"code": "unauthenticated"
}{
"type": "https://klaracase.de/docs/api/errors#insufficient_credits",
"title": "Payment Required",
"status": 402,
"detail": "Insufficient credits: this call costs 5 credit(s), but organization \"Kanzlei Beispiel\" has 0 remaining in the current period. The plan credits for this billing period are used up. An organization admin can change the plan at https://klaracase.de/org/billing/plans. For questions about credits, write to us through https://klaracase.de/support. Credits renew automatically at the start of the next credit period, which is the next calendar month (UTC) on a free plan.",
"code": "insufficient_credits",
"cost": 5,
"balance": 0
}{
"type": "https://klaracase.de/docs/api/errors#token_ability_missing",
"title": "Forbidden",
"status": 403,
"detail": "This API token does not carry the `datapackage` ability this endpoint needs. Nothing was executed and nothing was charged. Create a token with that ability in Settings, API tokens.",
"code": "token_ability_missing",
"required_ability": "datapackage"
}{
"type": "https://klaracase.de/docs/api/errors#token_org_missing",
"title": "Conflict",
"status": 409,
"detail": "This API token was created before tokens named an organization, so the API cannot tell which organization it acts for. Create a new token in Settings, API tokens; it acts for the organization you have open.",
"code": "token_org_missing"
}{
"type": "https://klaracase.de/docs/api/errors#validation_failed",
"title": "Unprocessable Content",
"status": 422,
"detail": "The selected ids is invalid.",
"code": "validation_failed",
"errors": {
"ids": [
"The selected ids is invalid."
]
}
}{
"type": "https://klaracase.de/docs/api/errors#rate_limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Too many requests for this token. Wait `retry_after_seconds` and retry. Nothing was executed and nothing was charged.",
"code": "rate_limited",
"retry_after_seconds": 42
}{
"type": "https://klaracase.de/docs/api/errors#backend_unavailable",
"title": "Service Unavailable",
"status": 503,
"detail": "The backend could not complete this call, so nothing was charged. Retry in a few seconds.",
"code": "backend_unavailable"
}Decisions
/api/v1/decisions/{id}Parameters
max_charsintegerqueryMaximum characters of text to return, e.g. 8000 (default 40000, minimum 500).
rn_fromintegerqueryOptional range start: the first Randnummer to return, e.g. 12. The span served can be wider than asked; it is reported in `returned_range`.
rn_tointegerqueryOptional range end: the highest Randnummer to return (inclusive), e.g. 18. Must be >= rn_from.
sectionstringqueryOptional named section instead of the whole text, e.g. "Leitsatz". One of: Tenor, Leitsatz, Tatbestand, Gründe (case-insensitive). `available_sections` lists the sections a decision has.
courtstringqueryOptional disambiguator for an Aktenzeichen `id`: the court short form, e.g. "BGH". Matched as a whole-word prefix. Ignored for UUID lookups.
datestringqueryOptional disambiguator for an Aktenzeichen `id`: the decision date in YYYY-MM-DD, e.g. "2018-04-11".
Request
curl "https://klaracase.de/api/v1/decisions/{id}" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Responses
{
"id": "0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"aktenzeichen": "1 StR 185/01",
"court": "BGH",
"date": "2001-11-15",
"fundstelle": "BGH, Urt. v. 15.11.2001 – 1 StR 185/01",
"corpus_url": "https://klaracase.de/decisions/0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"source_url": "https://www.rechtsprechung-im-internet.de/jportal/?quelle=jlink&docid=KORE300542001&psml=bsjrsprod.psml&max=true",
"jurisdiction": "DE",
"metadata": {
"document_type": "Urteil",
"ecli": "ECLI:DE:BGH:2001:151101U1STR185.01.0",
"file_numbers": [
"1 StR 185/01"
]
},
"fortgeltung_checked": false,
"fortgeltung_note": "Rechtskraft/Fortgeltung (whether a decision is still good law) is NOT checked. A decision returned here may have been quashed or superseded on appeal, and the ABSENCE of any such note is not evidence that it still stands.",
"full_text": "Tenor … Gründe: I. … 21 Die Revision ist unbegründet …",
"text_length": 48213,
"truncated": true,
"rn_source": "printed",
"rn_source_note": "The Randnummern are the court's own printed numbers.",
"available_sections": [
"Tenor",
"Gründe"
],
"available_range": {
"rn_from": 1,
"rn_to": 64,
"rn_source": "printed"
},
"available_range_scope": "decision",
"has_rn_anchors": true,
"api_version": "0.107.0",
"changelog_url": "https://klaracase.de/docs/mcp/changelog",
"credits": {
"metered": true,
"cost": 1,
"credits_remaining": 27
}
}{
"type": "https://klaracase.de/docs/api/errors#unauthenticated",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication is required. Send a Klaracase API token as a Bearer token.",
"code": "unauthenticated"
}{
"type": "https://klaracase.de/docs/api/errors#insufficient_credits",
"title": "Payment Required",
"status": 402,
"detail": "Insufficient credits: this call costs 1 credit(s), but organization \"Kanzlei Beispiel\" has 0 remaining in the current period. The plan credits for this billing period are used up. An organization admin can change the plan at https://klaracase.de/org/billing/plans. For questions about credits, write to us through https://klaracase.de/support. Credits renew automatically at the start of the next credit period, which is the next calendar month (UTC) on a free plan.",
"code": "insufficient_credits",
"cost": 1,
"balance": 0
}{
"type": "https://klaracase.de/docs/api/errors#token_ability_missing",
"title": "Forbidden",
"status": 403,
"detail": "This API token does not carry the `read` ability this endpoint needs. Nothing was executed and nothing was charged. Create a token with that ability in Settings, API tokens.",
"code": "token_ability_missing",
"required_ability": "read"
}{
"type": "https://klaracase.de/docs/api/errors#not_found",
"title": "Not Found",
"status": 404,
"detail": "The requested resource does not exist, or it belongs to another organization.",
"code": "not_found"
}{
"type": "https://klaracase.de/docs/api/errors#token_org_missing",
"title": "Conflict",
"status": 409,
"detail": "This API token was created before tokens named an organization, so the API cannot tell which organization it acts for. Create a new token in Settings, API tokens; it acts for the organization you have open.",
"code": "token_org_missing"
}{
"type": "https://klaracase.de/docs/api/errors#validation_failed",
"title": "Unprocessable Content",
"status": 422,
"detail": "The selected max_chars is invalid.",
"code": "validation_failed",
"errors": {
"max_chars": [
"The selected max_chars is invalid."
]
}
}{
"type": "https://klaracase.de/docs/api/errors#rate_limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Too many requests for this token. Wait `retry_after_seconds` and retry. Nothing was executed and nothing was charged.",
"code": "rate_limited",
"retry_after_seconds": 42
}{
"type": "https://klaracase.de/docs/api/errors#backend_unavailable",
"title": "Service Unavailable",
"status": 503,
"detail": "The backend could not complete this call, so nothing was charged. Retry in a few seconds.",
"code": "backend_unavailable"
}Guidance
/api/v1/guidance/{reference}Parameters
sectionstringqueryOptional anchor inside a set the reference names whole, e.g. "R 4.5" or "Abschn. 3.1".
max_charsintegerqueryMaximum characters of text to return (default 40000, minimum 500).
Request
curl "https://klaracase.de/api/v1/guidance/{reference}" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Responses
{
"id": "01a1af08-3e92-7003-a911-da35965dec12",
"artifact_type": "ADMIN_GUIDANCE",
"requested_reference": "R 4.5 EStR",
"fundstelle": "R 4.5 EStR",
"title": "Einkommensteuer-Richtlinien 2012",
"abbreviation": "EStR",
"issuer": "BMF",
"guidance_kind": "directive",
"issued_at": "2012-12-16",
"reference_number": null,
"gazette_cite": "BStBl I 2012 Sondernummer 1",
"subject_area": "Einkommensteuer",
"subject_area_label": "Einkommensteuer",
"valid_from": "2012-01-01",
"lifecycle": "current",
"lifecycle_basis": "none_recorded",
"supersedes": null,
"superseded_by": null,
"source_url": "https://esth.bundesfinanzministerium.de/lsth/2024/A-Einkommensteuergesetz/II-Einkommen/2-Steuerfreie-Einnahmen/Paragraf-4/r4.5.html",
"corpus_url": "https://klaracase.de/guidance/01a1af08-3e92-7003-a911-da35965dec12#anchor-r-4-5",
"attribution": "Bundesministerium der Finanzen, Amtliche Handbücher (…bundesfinanzministerium.de)",
"scope": "section",
"section": {
"anchor": "R 4.5",
"title": "Einnahmenüberschussrechnung"
},
"text": "(1) Der Steuerpflichtige kann als Gewinn den Überschuss der Betriebseinnahmen über die Betriebsausgaben ansetzen, wenn er auf Grund gesetzlicher Vorschriften nicht verpflichtet ist, Bücher zu führen und regelmäßig Abschlüsse zu machen.\n\n(2) Bei der Gewinnermittlung nach § 4 Abs. 3 EStG sind die Betriebseinnahmen und die Betriebsausgaben nach den Grundsätzen des § 11 EStG zu erfassen.",
"text_length": 386,
"truncated": false,
"version": {
"id": "01a1af08-3ea6-72d0-93a8-60822d418bc9",
"source_fetched_at": "2026-10-28T03:12:00Z",
"text_held_from": "2026-10-28",
"text_held_until": null
},
"links": {
"self_url": "/api/v1/guidance/01a1af08-3e92-7003-a911-da35965dec12?section=R%204.5"
},
"api_version": "0.107.0",
"changelog_url": "https://klaracase.de/docs/mcp/changelog",
"credits": {
"metered": true,
"cost": 1,
"credits_remaining": 19,
"included": false,
"covered_by": null
}
}{
"type": "https://klaracase.de/docs/api/errors#unauthenticated",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication is required. Send a Klaracase API token as a Bearer token.",
"code": "unauthenticated"
}{
"type": "https://klaracase.de/docs/api/errors#insufficient_credits",
"title": "Payment Required",
"status": 402,
"detail": "Insufficient credits: this call costs 1 credit(s), but organization \"Kanzlei Beispiel\" has 0 remaining in the current period. The plan credits for this billing period are used up. An organization admin can change the plan at https://klaracase.de/org/billing/plans. For questions about credits, write to us through https://klaracase.de/support. Credits renew automatically at the start of the next credit period, which is the next calendar month (UTC) on a free plan.",
"code": "insufficient_credits",
"cost": 1,
"balance": 0
}{
"type": "https://klaracase.de/docs/api/errors#token_ability_missing",
"title": "Forbidden",
"status": 403,
"detail": "This API token does not carry the `read` ability this endpoint needs. Nothing was executed and nothing was charged. Create a token with that ability in Settings, API tokens.",
"code": "token_ability_missing",
"required_ability": "read"
}{
"type": "https://klaracase.de/docs/api/errors#not_found",
"title": "Not Found",
"status": 404,
"detail": "The requested resource does not exist, or it belongs to another organization.",
"code": "not_found"
}{
"type": "https://klaracase.de/docs/api/errors#token_org_missing",
"title": "Conflict",
"status": 409,
"detail": "This API token was created before tokens named an organization, so the API cannot tell which organization it acts for. Create a new token in Settings, API tokens; it acts for the organization you have open.",
"code": "token_org_missing"
}{
"type": "https://klaracase.de/docs/api/errors#validation_failed",
"title": "Unprocessable Content",
"status": 422,
"detail": "The selected section is invalid.",
"code": "validation_failed",
"errors": {
"section": [
"The selected section is invalid."
]
}
}{
"type": "https://klaracase.de/docs/api/errors#rate_limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Too many requests for this token. Wait `retry_after_seconds` and retry. Nothing was executed and nothing was charged.",
"code": "rate_limited",
"retry_after_seconds": 42
}{
"type": "https://klaracase.de/docs/api/errors#backend_unavailable",
"title": "Service Unavailable",
"status": 503,
"detail": "The backend could not complete this call, so nothing was charged. Retry in a few seconds.",
"code": "backend_unavailable"
}Norms
/api/v1/norms/{reference}Parameters
jurisdictionstringqueryDE or EU, e.g. "EU"; only read when the abbreviation is ambiguous.
as_ofstringqueryOptional YYYY-MM-DD, e.g. "2020-01-01": the text we held that day, not the one in force.
Request
curl "https://klaracase.de/api/v1/norms/{reference}" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Responses
{
"reference": "§ 535 BGB",
"requested_reference": "§ 535 Abs. 1 BGB",
"corpus_url": "https://klaracase.de/laws/0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"law": {
"id": "0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"abbreviation": "BGB",
"source_abbreviation": "BGB",
"official_name": "Bürgerliches Gesetzbuch",
"law_level": "BUND",
"jurisdiction": "DE",
"source_url": "https://www.gesetze-im-internet.de/bgb/",
"upstream_status": "confirmed",
"upstream_last_seen_at": "2026-10-05T04:17:00Z",
"upstream_missing_since": null
},
"norm": {
"number": "§ 535",
"title": "Inhalt und Hauptpflichten des Mietvertrags",
"lifecycle": "current",
"text": "(1) Durch den Mietvertrag wird der Vermieter verpflichtet, dem Mieter den Gebrauch der Mietsache während der Mietzeit zu gewähren. …\n(2) Der Mieter ist verpflichtet, dem Vermieter die vereinbarte Miete zu entrichten.",
"absatz_identifiers": [
"1",
"2"
],
"chars": 612
},
"requested_qualifiers": [
{
"type": "Abs.",
"value": "1",
"checked": true,
"present": true
}
],
"version": {
"id": "0193b0c4-aaaa-7a2b-9c3d-4e5f6a7b8c9d",
"last_amendment_date": "2024-12-20",
"last_amendment_date_basis": "source_stand",
"source_fetched_at": "2026-10-05T04:17:00Z",
"source_last_seen_at": "2026-10-05T04:17:00Z",
"as_of": null,
"text_held_from": "2026-10-05",
"text_held_until": null
},
"neighbours": {
"previous": "§ 534 BGB",
"next": "§ 536 BGB"
},
"links": {
"decisions_citing": {
"tool": "search_decisions",
"arguments": {
"cited_norm": "§ 535 BGB"
}
},
"decisions_citing_url": "/api/v1/decisions/search?cited_norm=%C2%A7%20535%20BGB",
"self_url": "/api/v1/norms/%C2%A7%20535%20BGB"
},
"api_version": "0.107.0",
"changelog_url": "https://klaracase.de/docs/mcp/changelog",
"credits": {
"metered": true,
"cost": 1,
"credits_remaining": 27
}
}{
"type": "https://klaracase.de/docs/api/errors#unauthenticated",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication is required. Send a Klaracase API token as a Bearer token.",
"code": "unauthenticated"
}{
"type": "https://klaracase.de/docs/api/errors#insufficient_credits",
"title": "Payment Required",
"status": 402,
"detail": "Insufficient credits: this call costs 1 credit(s), but organization \"Kanzlei Beispiel\" has 0 remaining in the current period. The plan credits for this billing period are used up. An organization admin can change the plan at https://klaracase.de/org/billing/plans. For questions about credits, write to us through https://klaracase.de/support. Credits renew automatically at the start of the next credit period, which is the next calendar month (UTC) on a free plan.",
"code": "insufficient_credits",
"cost": 1,
"balance": 0
}{
"type": "https://klaracase.de/docs/api/errors#token_ability_missing",
"title": "Forbidden",
"status": 403,
"detail": "This API token does not carry the `read` ability this endpoint needs. Nothing was executed and nothing was charged. Create a token with that ability in Settings, API tokens.",
"code": "token_ability_missing",
"required_ability": "read"
}{
"type": "https://klaracase.de/docs/api/errors#not_found",
"title": "Not Found",
"status": 404,
"detail": "The requested resource does not exist, or it belongs to another organization.",
"code": "not_found"
}{
"type": "https://klaracase.de/docs/api/errors#token_org_missing",
"title": "Conflict",
"status": 409,
"detail": "This API token was created before tokens named an organization, so the API cannot tell which organization it acts for. Create a new token in Settings, API tokens; it acts for the organization you have open.",
"code": "token_org_missing"
}{
"type": "https://klaracase.de/docs/api/errors#validation_failed",
"title": "Unprocessable Content",
"status": 422,
"detail": "The selected jurisdiction is invalid.",
"code": "validation_failed",
"errors": {
"jurisdiction": [
"The selected jurisdiction is invalid."
]
}
}{
"type": "https://klaracase.de/docs/api/errors#rate_limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Too many requests for this token. Wait `retry_after_seconds` and retry. Nothing was executed and nothing was charged.",
"code": "rate_limited",
"retry_after_seconds": 42
}{
"type": "https://klaracase.de/docs/api/errors#backend_unavailable",
"title": "Service Unavailable",
"status": 503,
"detail": "The backend could not complete this call, so nothing was charged. Retry in a few seconds.",
"code": "backend_unavailable"
}Search
/api/v1/decisions/searchParameters
queryRequiredstringquerySearch query in German legal-concept phrasing, e.g. "Widerrufsrecht Fernabsatzvertrag Wertersatz Verbraucher". 2-500 characters; longer input is REJECTED.
courtstringqueryCourt filter on the indexed court name: the court, not the chamber, e.g. "BGH" or "OLG Hamm" (values: list_facets(field="court_name")).
branchordentlichverwaltungsozialarbeitfinanzverfassungpatentunbekanntqueryGerichtsbarkeit (court branch) filter, e.g. "arbeit". It names the COURT JURISDICTION that decided the case, not the legal subject area. "patent" is the Bundespatentgericht alone: BGH patent decisions sit under "ordentlich".
document_typeUrteilBeschlussVerfügungSonstigeGerichtsbescheidSchlussanträgequeryOne decision document type, e.g. "Urteil".
cited_normstringqueryDecisions whose extracted Normenkette cites this statute, e.g. "§ 906 BGB". One §-token; subdivisions nest ("§ 823 BGB" matches "§ 823 Abs. 1 BGB").
cited_statutesarrayqueryAny section of these statutes, e.g. ["StGB", "StPO"]. One of: StGB, StPO, InsO, DSGVO, GDPR, BDSG, BauGB, BBauG, BauNVO, StVG, StVO.
date_fromstringqueryEarliest decision date, inclusive, YYYY-MM-DD, e.g. "2015-01-01". ACCURACY CAVEAT: a scanned decision can carry a WRONG stored date; see `date_source`/`date_confidence`.
date_tostringqueryLatest decision date, inclusive, YYYY-MM-DD, e.g. "2020-12-31", not earlier than date_from. ACCURACY CAVEAT: a scanned decision can carry a WRONG stored date; see `date_source`/`date_confidence`.
modekeywordsemantichybridquerySearch mode. "hybrid" (default) matches by meaning and by words. "keyword" requires ALL query terms at once and matches a citation query ("§ 550a BGB", "VIII ZR 311/02") EXACTLY, with no typo tolerance. "semantic" matches by meaning only. Unset does not guarantee hybrid: a precise identifier is auto-classified to keyword.
limitintegerqueryMaximum results, e.g. 10. Default 20, also the hard cap.
pageintegerquery1-based page number, e.g. 2 (default 1, maximum 10), for results past the first page when `candidate_pool` exceeds `limit`.
bridgebooleanqueryWhether the server may ADD related German legal terms to your query: true (default) or false. `query_expansion` lists what was added.
Request
curl "https://klaracase.de/api/v1/decisions/search" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Responses
{
"results": [
{
"id": "0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"aktenzeichen": "1 StR 185/01",
"court": "BGH",
"date": "2001-11-15",
"document_type": "Urteil",
"title": "BGH, Urteil vom 15.11.2001",
"snippet": "… die <mark>Vermögensbetreuungspflicht</mark> des Geschäftsführers …",
"snippets": [
{
"text": "… die <mark>Vermögensbetreuungspflicht</mark> des Geschäftsführers …",
"rn": 21
}
],
"chunk_title": "Gründe",
"rn_range": "21-23",
"fundstelle": "BGH, Urt. v. 15.11.2001 – 1 StR 185/01",
"fortgeltung_checked": false,
"fortgeltung_note": "Rechtskraft/Fortgeltung (whether a decision is still good law) is NOT checked. A decision returned here may have been quashed or superseded on appeal, and the ABSENCE of any such note is not evidence that it still stands.",
"corpus_url": "https://klaracase.de/decisions/0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"source_url": "https://www.rechtsprechung-im-internet.de/jportal/?quelle=jlink&docid=KORE300542001&psml=bsjrsprod.psml&max=true",
"confidence": "high"
}
],
"payload_truncated": false,
"total_available": {
"value": 42,
"is_floor": false
},
"total_available_basis": "matching_indexed_passages_lexical_arm",
"candidate_pool": 42,
"pool_exhaustive": false,
"truncated": true,
"page": 1,
"limit": 20,
"mode": "hybrid",
"frequently_cited_by_results": [],
"query_expansion": {
"status": "abstained",
"applied": false,
"reason": "no_lay_term",
"note": "Nothing was added to your query: it was retrieved exactly as you typed it. …"
},
"api_version": "0.107.0",
"changelog_url": "https://klaracase.de/docs/mcp/changelog",
"credits": {
"metered": true,
"cost": 1,
"credits_remaining": 29
},
"top_confidence": "high"
}{
"type": "https://klaracase.de/docs/api/errors#unauthenticated",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication is required. Send a Klaracase API token as a Bearer token.",
"code": "unauthenticated"
}{
"type": "https://klaracase.de/docs/api/errors#insufficient_credits",
"title": "Payment Required",
"status": 402,
"detail": "Insufficient credits: this call costs 1 credit(s), but organization \"Kanzlei Beispiel\" has 0 remaining in the current period. The plan credits for this billing period are used up. An organization admin can change the plan at https://klaracase.de/org/billing/plans. For questions about credits, write to us through https://klaracase.de/support. Credits renew automatically at the start of the next credit period, which is the next calendar month (UTC) on a free plan.",
"code": "insufficient_credits",
"cost": 1,
"balance": 0
}{
"type": "https://klaracase.de/docs/api/errors#token_ability_missing",
"title": "Forbidden",
"status": 403,
"detail": "This API token does not carry the `search` ability this endpoint needs. Nothing was executed and nothing was charged. Create a token with that ability in Settings, API tokens.",
"code": "token_ability_missing",
"required_ability": "search"
}{
"type": "https://klaracase.de/docs/api/errors#token_org_missing",
"title": "Conflict",
"status": 409,
"detail": "This API token was created before tokens named an organization, so the API cannot tell which organization it acts for. Create a new token in Settings, API tokens; it acts for the organization you have open.",
"code": "token_org_missing"
}{
"type": "https://klaracase.de/docs/api/errors#validation_failed",
"title": "Unprocessable Content",
"status": 422,
"detail": "The selected query is invalid.",
"code": "validation_failed",
"errors": {
"query": [
"The selected query is invalid."
]
}
}{
"type": "https://klaracase.de/docs/api/errors#rate_limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Too many requests for this token. Wait `retry_after_seconds` and retry. Nothing was executed and nothing was charged.",
"code": "rate_limited",
"retry_after_seconds": 42
}{
"type": "https://klaracase.de/docs/api/errors#backend_unavailable",
"title": "Service Unavailable",
"status": 503,
"detail": "The backend could not complete this call, so nothing was charged. Retry in a few seconds.",
"code": "backend_unavailable"
}/api/v1/searchParameters
queryRequiredstringquerySearch query, German legal-concept phrasing, e.g. "Widerrufsrecht Fernabsatzvertrag Wertersatz Verbraucher". 2-500 characters; longer input is REJECTED, not truncated.
jurisdictionstringqueryJurisdiction code. It narrows the LAWS section only, so it never empties another section. Values `DE`, `EU` (EU law and the Treaties), `XI` (international); counts via list_facets.
courtstringqueryCourt, canonical German short form, e.g. "BGH".
branchordentlichverwaltungsozialarbeitfinanzverfassungpatentunbekanntqueryGerichtsbarkeit: the COURT JURISDICTION that decided the case, not the legal subject area. "patent" is the Bundespatentgericht; BGH patent decisions sit under "ordentlich".
date_fromstringqueryEarliest decision date, inclusive, YYYY-MM-DD, e.g. "2015-01-01". Decisions section only.
date_tostringqueryLatest decision date, inclusive, YYYY-MM-DD, e.g. "2020-12-31", NOT earlier than date_from.
modekeywordsemantichybridqueryhybrid (default) matches by meaning and words, keyword requires every query term, semantic matches by meaning only.
document_typeUrteilBeschlussVerfügungSonstigeGerichtsbescheidSchlussanträgequeryOne decision document type, e.g. "Urteil".
cited_normstringqueryDecisions whose EXTRACTED Normenkette cites this statute, e.g. "§ 906 BGB". Canonicalized; subdivisions nest.
cited_statutesarrayqueryAny section of these statutes, one of: StGB, StPO, InsO, DSGVO, GDPR, BDSG, BauGB, BBauG, BauNVO, StVG, StVO.
limitintegerqueryRows PER section (default 5, capped at 10).
bridgebooleanqueryWhether the server may ADD terms to your query, `query_expansion` included: true (default) or false, which searches your literal query and adds nothing.
typesarrayquerySections to search, e.g. ["guidance"]; default all three.
Request
curl "https://klaracase.de/api/v1/search" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Responses
{
"sections": {
"laws": [
{
"id": "0193b0c4-8c4f-7e60-ab32-4d5e6f7a8b92",
"artifact_type": "LAW",
"aktenzeichen": null,
"court": null,
"date": null,
"document_type": null,
"title": "§ 266 StGB Untreue",
"snippet": "… <mark>Vermögensbetreuungspflicht</mark> …",
"snippets": [
{
"text": "… <mark>Vermögensbetreuungspflicht</mark> …"
}
],
"chunk_title": null,
"rn_range": null,
"fundstelle": "§ 266 StGB Untreue",
"breadcrumb": null,
"abbreviation": "StGB",
"law_type": "Gesetz",
"jurisdiction": "DE",
"corpus_url": "https://klaracase.de/laws/0193b0c4-8c4f-7e60-ab32-4d5e6f7a8b92",
"confidence": "high"
}
],
"decisions": [
{
"id": "0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"artifact_type": "DECISION",
"aktenzeichen": "1 StR 185/01",
"court": "BGH",
"date": "2001-11-15",
"document_type": "Urteil",
"title": "BGH, Urteil vom 15.11.2001",
"snippet": "… <mark>Vermögensbetreuungspflicht</mark> …",
"snippets": [
{
"text": "… <mark>Vermögensbetreuungspflicht</mark> …",
"rn": 21
}
],
"chunk_title": "Gründe",
"rn_range": "21-23",
"fundstelle": "BGH, Urt. v. 15.11.2001 – 1 StR 185/01",
"fortgeltung_checked": false,
"fortgeltung_note": "Rechtskraft/Fortgeltung (whether a decision is still good law) is NOT checked. A decision returned here may have been quashed or superseded on appeal, and the ABSENCE of any such note is not evidence that it still stands.",
"corpus_url": "https://klaracase.de/decisions/0193b0c4-5f1e-7a2b-9c3d-4e5f6a7b8c9d",
"source_url": "https://www.rechtsprechung-im-internet.de/jportal/?quelle=jlink&docid=KORE300542001&psml=bsjrsprod.psml&max=true",
"confidence": "medium"
}
]
},
"section_totals": {
"laws": {
"total_available": {
"value": 3,
"is_floor": false
},
"total_available_basis": "matching_indexed_passages_lexical_arm",
"candidate_pool": 3,
"pool_exhaustive": true,
"truncated": false
},
"decisions": {
"total_available": {
"value": 7,
"is_floor": false
},
"total_available_basis": "matching_indexed_passages_lexical_arm",
"candidate_pool": 7,
"pool_exhaustive": true,
"truncated": true
}
},
"limit": 5,
"total_available": {
"value": 10,
"is_floor": false
},
"total_available_basis": "matching_indexed_passages_lexical_arm",
"pool_exhaustive": true,
"truncated": true,
"mode": "hybrid",
"query_expansion": {
"status": "abstained",
"applied": false,
"reason": "no_lay_term",
"note": "Nothing was added to your query: it was retrieved exactly as you typed it. …"
},
"frequently_cited_by_results": [],
"norms_cited_by_decision_results": [],
"api_version": "0.107.0",
"changelog_url": "https://klaracase.de/docs/mcp/changelog",
"credits": {
"metered": true,
"cost": 1,
"credits_remaining": 28
},
"top_confidence": "high"
}{
"type": "https://klaracase.de/docs/api/errors#unauthenticated",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication is required. Send a Klaracase API token as a Bearer token.",
"code": "unauthenticated"
}{
"type": "https://klaracase.de/docs/api/errors#insufficient_credits",
"title": "Payment Required",
"status": 402,
"detail": "Insufficient credits: this call costs 1 credit(s), but organization \"Kanzlei Beispiel\" has 0 remaining in the current period. The plan credits for this billing period are used up. An organization admin can change the plan at https://klaracase.de/org/billing/plans. For questions about credits, write to us through https://klaracase.de/support. Credits renew automatically at the start of the next credit period, which is the next calendar month (UTC) on a free plan.",
"code": "insufficient_credits",
"cost": 1,
"balance": 0
}{
"type": "https://klaracase.de/docs/api/errors#token_ability_missing",
"title": "Forbidden",
"status": 403,
"detail": "This API token does not carry the `search` ability this endpoint needs. Nothing was executed and nothing was charged. Create a token with that ability in Settings, API tokens.",
"code": "token_ability_missing",
"required_ability": "search"
}{
"type": "https://klaracase.de/docs/api/errors#token_org_missing",
"title": "Conflict",
"status": 409,
"detail": "This API token was created before tokens named an organization, so the API cannot tell which organization it acts for. Create a new token in Settings, API tokens; it acts for the organization you have open.",
"code": "token_org_missing"
}{
"type": "https://klaracase.de/docs/api/errors#validation_failed",
"title": "Unprocessable Content",
"status": 422,
"detail": "The selected query is invalid.",
"code": "validation_failed",
"errors": {
"query": [
"The selected query is invalid."
]
}
}{
"type": "https://klaracase.de/docs/api/errors#rate_limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Too many requests for this token. Wait `retry_after_seconds` and retry. Nothing was executed and nothing was charged.",
"code": "rate_limited",
"retry_after_seconds": 42
}{
"type": "https://klaracase.de/docs/api/errors#backend_unavailable",
"title": "Service Unavailable",
"status": 503,
"detail": "The backend could not complete this call, so nothing was charged. Retry in a few seconds.",
"code": "backend_unavailable"
}