{ "openapi": "3.0.1", "info": { "title": "German Court Decisions — Rechtsprechung im Internet", "description": "Full text of German federal court decisions (BGH, BVerfG, BVerwG, BFH, BAG, BSG, BPatG) from the official Rechtsprechung im Internet corpus. Filter by court, date, case number and keywords. Monitor mode returns only new decisions — a clean feed for legal-tech, RAG pipelines and AI agents.", "version": "0.1", "x-build-id": "ZTdKUfz79FZGO6ofg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/relevate~de-court-decisions/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-relevate-de-court-decisions", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/relevate~de-court-decisions/runs": { "post": { "operationId": "runs-sync-relevate-de-court-decisions", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/relevate~de-court-decisions/run-sync": { "post": { "operationId": "run-sync-relevate-de-court-decisions", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "courts": { "title": "Courts", "type": "array", "description": "Federal courts to include. Leave empty for all of them.", "items": { "type": "string", "enum": [ "BGH", "BVerfG", "BVerwG", "BFH", "BAG", "BSG", "BPatG" ], "enumTitles": [ "BGH — Federal Court of Justice (civil & criminal)", "BVerfG — Federal Constitutional Court", "BVerwG — Federal Administrative Court", "BFH — Federal Fiscal Court (tax)", "BAG — Federal Labour Court", "BSG — Federal Social Court", "BPatG — Federal Patent Court" ] }, "default": [] }, "dateFrom": { "title": "Decision date from", "type": "string", "description": "Only decisions issued on or after this date (YYYY-MM-DD). The corpus starts in January 2010." }, "dateTo": { "title": "Decision date to", "type": "string", "description": "Only decisions issued on or before this date (YYYY-MM-DD)." }, "keywords": { "title": "Full-text keywords", "type": "string", "description": "Searches the whole decision text (headnote, tenor, facts, reasons, cited norms). Terms are combined with AND, \"quoted phrases\" match as a unit, and uppercase OR separates alternatives — e.g. `Kündigung Betriebsrat OR \"fristlose Kündigung\"`. Case- and umlaut-insensitive. Leave empty to skip content filtering (much faster)." }, "caseNumber": { "title": "Case number (Aktenzeichen)", "type": "string", "description": "Substring match on the file number, e.g. `IX ZB 72/08` or just `ZB 72`." }, "docTypes": { "title": "Decision types", "type": "array", "description": "German decision types. Leave empty for all.", "items": { "type": "string", "enum": [ "Urteil", "Beschluss", "Gerichtsbescheid", "Zwischenurteil", "Versäumnisurteil", "Teilurteil" ], "enumTitles": [ "Urteil (judgment)", "Beschluss (order)", "Gerichtsbescheid", "Zwischenurteil", "Versäumnisurteil", "Teilurteil" ] }, "default": [] }, "includeFullText": { "title": "Include full decision text", "type": "boolean", "description": "Output tenor, facts and reasons as plain text — what a RAG pipeline or legal AI agent needs. Turn off for a lightweight citation index (much faster and cheaper when no keyword filter is used).", "default": true }, "sortOrder": { "title": "Sort order", "enum": [ "newest", "oldest" ], "type": "string", "description": "Newest decisions first (default) or oldest first.", "default": "newest" }, "monitorMode": { "title": "Monitor mode — only new decisions", "type": "boolean", "description": "Remembers which decisions this filter combination already returned and outputs only the ones you have not seen. Combine with a Schedule to get a zero-noise daily feed of new case law.", "default": false }, "maxResults": { "title": "Maximum decisions", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Safety cap on the number of decisions returned.", "default": 50 }, "maxScanned": { "title": "Maximum documents downloaded", "minimum": 10, "maximum": 20000, "type": "integer", "description": "How deep a keyword search may dig. Only decisions that pass the court/date filter are downloaded; raise this if a narrow keyword returns too few hits.", "default": 600 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The source is a German government site that refuses connections from most cloud datacenters, so runs on the platform go through a proxy. Leave the default (Apify Proxy, automatic) unless you have a reason to change it — a specific country selection is usually unnecessary and needs a paid proxy plan.", "default": { "useApifyProxy": true } }, "minExpectedResults": { "title": "Health check — minimum expected results", "minimum": 0, "type": "integer", "description": "Fail the run if fewer than this many decisions are returned. Use it in scheduled pipelines to get alerted when the upstream source changes. 0 disables the check.", "default": 0 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }