{
  "openapi": "3.0.1",
  "info": {
    "title": "Rechtspraak - Dutch Case Law Search",
    "description": "Search Dutch court decisions via the official Rechtspraak Open Data API: filters by court and area of law, summary, relations between instances, full text.",
    "version": "0.1",
    "x-build-id": "T5WvaeESYbTxQNp6p"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/legaltech~rechtspraak/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-legaltech-rechtspraak",
        "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/legaltech~rechtspraak/runs": {
      "post": {
        "operationId": "runs-sync-legaltech-rechtspraak",
        "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/legaltech~rechtspraak/run-sync": {
      "post": {
        "operationId": "run-sync-legaltech-rechtspraak",
        "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": {
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Full-text search over all published decisions (the same search engine as uitspraken.rechtspraak.nl), in Dutch. Syntax: words separated by spaces or AND (all must appear), OR, NOT / -word, \"exact phrase\", parentheses and * wildcard (also EN / OF / NIET). Combine with court, area of law and dates.",
            "items": {
              "type": "string"
            }
          },
          "eclis": {
            "title": "ECLI",
            "type": "array",
            "description": "Specific decisions, e.g. \"ECLI:NL:HR:2020:1\".",
            "items": {
              "type": "string"
            }
          },
          "courts": {
            "title": "Courts",
            "type": "array",
            "description": "Supreme Court (Hoge Raad), Council of State, CRvB, CBb, courts of appeal, district courts, Dutch Caribbean courts… Codes are opaque: do NOT guess them; choose by reading the title (enumTitle) of each option.",
            "items": {
              "type": "string",
              "enum": [
                "RVAB",
                "RSJ",
                "GHSHE",
                "GHAMS",
                "GHARL",
                "GHDHA",
                "OCHM",
                "OGHACMB",
                "OGAACMB",
                "OGEAA",
                "OGEABES",
                "OGEAC",
                "OGEAM",
                "ORBAACM",
                "ORBBACM",
                "PHR",
                "RBAMS",
                "RBDHA",
                "RBGEL",
                "RBLIM",
                "RBMNE",
                "RBNHO",
                "RBNNE",
                "RBOBR",
                "RBOVE",
                "RBROT",
                "RBZWB",
                "CBB",
                "CRVB",
                "HR",
                "RVS"
              ],
              "enumTitles": [
                "Raad van Arbitrage in Bouwgeschillen",
                "Raad voor Strafrechtstoepassing en Jeugdbescherming ",
                "Gerechtshof 's-Hertogenbosch",
                "Gerechtshof Amsterdam",
                "Gerechtshof Arnhem-Leeuwarden",
                "Gerechtshof Den Haag",
                "Constitutioneel Hof Sint Maarten",
                "Gemeenschappelijk Hof van Justitie van Aruba, Curaçao, Sint Maarten en van Bonaire, Sint Eustatius en Saba",
                "Gerecht in Ambtenarenzaken van Aruba, Curaçao, Sint Maarten en van Bonaire, Sint Eustatius en Saba",
                "Gerecht in Eerste Aanleg van Aruba",
                "Gerecht in eerste aanleg van Bonaire, Sint Eustatius en Saba",
                "Gerecht in eerste aanleg van Curaçao",
                "Gerecht in eerste aanleg van Sint Maarten",
                "Raad van Beroep in Ambtenarenzaken van Aruba, Curaçao, Sint Maarten en van Bonaire, Sint Eustatius en Saba",
                "Raad van Beroep voor Belastingzaken van Aruba, Curaçao, Sint Maarten en van Bonaire, Sint Eustatius en Saba",
                "Parket bij de Hoge Raad",
                "Rechtbank Amsterdam",
                "Rechtbank Den Haag",
                "Rechtbank Gelderland",
                "Rechtbank Limburg",
                "Rechtbank Midden-Nederland",
                "Rechtbank Noord-Holland",
                "Rechtbank Noord-Nederland",
                "Rechtbank Oost-Brabant",
                "Rechtbank Overijssel",
                "Rechtbank Rotterdam",
                "Rechtbank Zeeland-West-Brabant",
                "College van Beroep voor het bedrijfsleven",
                "Centrale Raad van Beroep",
                "Hoge Raad",
                "Raad van State"
              ]
            }
          },
          "legalAreas": {
            "title": "Areas of law",
            "type": "array",
            "description": "Rechtsgebied (civil, criminal, administrative law and sub-areas). Codes are opaque: do NOT guess them; choose by reading the title (enumTitle) of each option.",
            "items": {
              "type": "string",
              "enum": [
                "bestuursrecht",
                "bestuursrecht_ambtenarenrecht",
                "bestuursrecht_belastingrecht",
                "bestuursrecht_bestuursprocesrecht",
                "bestuursrecht_bestuursstrafrecht",
                "bestuursrecht_europeesBestuursrecht",
                "bestuursrecht_mededingingsrecht",
                "bestuursrecht_omgevingsrecht",
                "bestuursrecht_socialezekerheidsrecht",
                "bestuursrecht_vreemdelingenrecht",
                "civielRecht",
                "civielRecht_aanbestedingsrecht",
                "civielRecht_arbeidsrecht",
                "civielRecht_burgerlijkProcesrecht",
                "civielRecht_europeesCivielRecht",
                "civielRecht_goederenrecht",
                "civielRecht_insolventierecht",
                "civielRecht_intellectueeleigendomsrecht",
                "civielRecht_internationaalPrivaatrecht",
                "civielRecht_mededingingsrecht",
                "civielRecht_ondernemingsrecht",
                "civielRecht_personenEnFamilierecht",
                "civielRecht_verbintenissenrecht",
                "strafrecht",
                "strafrecht_europeesStrafrecht",
                "strafrecht_internationaalStrafrecht",
                "strafrecht_materieelStrafrecht",
                "strafrecht_penitentiairStrafrecht",
                "strafrecht_strafprocesrecht",
                "internationaalPubliekrecht",
                "internationaalPubliekrecht_mensenrechten",
                "internationaalPubliekrecht_volkenrecht"
              ],
              "enumTitles": [
                "Bestuursrecht",
                "Ambtenarenrecht",
                "Belastingrecht",
                "Bestuursprocesrecht",
                "Bestuursstrafrecht",
                "Europees bestuursrecht",
                "Mededingingsrecht",
                "Omgevingsrecht",
                "Socialezekerheidsrecht",
                "Vreemdelingenrecht",
                "Civiel recht",
                "Aanbestedingsrecht",
                "Arbeidsrecht",
                "Burgerlijk procesrecht",
                "Europees civiel recht",
                "Goederenrecht",
                "Insolventierecht",
                "Intellectueel-eigendomsrecht",
                "Internationaal privaatrecht",
                "Mededingingsrecht",
                "Ondernemingsrecht",
                "Personen- en familierecht",
                "Verbintenissenrecht",
                "Strafrecht",
                "Europees strafrecht",
                "Internationaal strafrecht",
                "Materieel strafrecht",
                "Penitentiair strafrecht",
                "Strafprocesrecht",
                "Internationaal publiekrecht",
                "Mensenrechten",
                "Volkenrecht"
              ]
            }
          },
          "documentType": {
            "title": "Type",
            "enum": [
              "",
              "Uitspraak",
              "Conclusie"
            ],
            "type": "string",
            "description": "Judgments or Advocate General opinions. Codes are opaque: do NOT guess them; choose by reading the title (enumTitle) of each option.",
            "default": ""
          },
          "dateFrom": {
            "title": "Date from",
            "type": "string",
            "description": "Decision date, start of range (YYYY-MM-DD)."
          },
          "dateTo": {
            "title": "Date to",
            "type": "string",
            "description": "Decision date, end of range (YYYY-MM-DD)."
          },
          "sortOrder": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "newest",
              "oldest"
            ],
            "type": "string",
            "description": "Order of the results (decision date or relevance, as on the website).",
            "default": "relevance"
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum per search term.",
            "default": 20
          },
          "maxDocumentsToScan": {
            "title": "Maximum decisions to scan",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Only used if the search engine is unavailable: the actor then scans the newest decisions of the Open Data API (no text search) and stops after this many.",
            "default": 500
          },
          "passages": {
            "title": "Relevant passages",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Number of paragraphs containing the search terms returned in `passages` (0 = none). Ideal for LLM analysis.",
            "default": 3
          },
          "includeFullText": {
            "title": "Include full text",
            "type": "boolean",
            "description": "Adds the `text` field with the full decision. Greatly increases output size; enable only if needed.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. The source usually works without a proxy. If it blocks, use Apify RESIDENTIAL (NL) or your own proxyUrls; requests then use sticky sessions, IP rotation and a Chrome TLS fingerprint.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}