{ "openapi": "3.0.1", "info": { "title": "Court Decisions MCP + API", "description": "Connect your AI agent to court decisions from Germany, Austria, the Netherlands, and the EU via MCP Server or REST API. Search by keyword, ECLI, court, or date. Structured JSON from official open data (NeuRIS, RIS OGD, Rechtspraak, EUR-Lex). No API key needed.", "version": "2.0", "x-build-id": "vZ8ySXggiJ2nVX98n" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fuchsblau~court-decisions/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fuchsblau-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/fuchsblau~court-decisions/runs": { "post": { "operationId": "runs-sync-fuchsblau-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/fuchsblau~court-decisions/run-sync": { "post": { "operationId": "run-sync-fuchsblau-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", "required": [ "action" ], "properties": { "action": { "title": "Action", "enum": [ "search", "getByEcli", "listCourts" ], "type": "string", "description": "Choose what to do: search for decisions, retrieve a specific decision by ECLI, or list available courts.", "default": "search" }, "query": { "title": "Search query", "type": "string", "description": "Full-text search term (e.g. \"Datenschutz\", \"Kündigungsschutz\"). German legal terms are indexed with umlauts (ä/ö/ü/ß) — use them, not ASCII transcriptions (\"ue\"/\"ae\"/\"oe\"/\"ss\"), or the German sources return no matches." }, "court": { "title": "Court filter", "type": "string", "description": "Filter by court abbreviation. German federal courts: BGH, BVerfG, BVerwG, BFH, BAG, BSG, BPatG. EU courts: EuGH (Court of Justice), EuG (General Court). Austrian courts: OGH. Optional." }, "dateFrom": { "title": "Date from", "type": "string", "description": "Only return decisions from this date onwards (YYYY-MM-DD). Optional." }, "dateTo": { "title": "Date to", "type": "string", "description": "Only return decisions up to this date (YYYY-MM-DD). Optional." }, "limit": { "title": "Max results", "minimum": 1, "maximum": 300, "type": "integer", "description": "Maximum number of results to return (1-300).", "default": 50 }, "sort": { "title": "Sort order", "enum": [ "relevance", "date" ], "type": "string", "description": "Result ordering. \"Relevance\" (default) ranks results by cross-source relevance using BM25 full-text matching combined with each source's native ranking via Reciprocal Rank Fusion — on-topic decisions surface in the top 5–10 without pagination. \"Date\" sorts all results newest first.", "default": "relevance" }, "ecli": { "title": "ECLI identifier", "type": "string", "description": "European Case Law Identifier (e.g. ECLI:DE:BGH:2024:120324UVIZR234.23.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 } } } } } } } } } }