Before you get started
- Our REST API allows you to programmatically search through the judges in our database.
- There is no authentication required. It's free to use.
- The examples in this documentation are written in curl or Python using the requests package.
- If you need help, or if you'd like to show us what you made with our API, open up an issue!
- Most data that we use comes from the website of the Dutch judiciary. For more information on what certain fields mean, please visit their open data website (Dutch only).
- Go to:
- Quickstart
- General concepts
- Routes
- Examples
Quickstart
The base URL of the API is https://openrechtspraak.nl/api/v1/.
Everywhere in this documentation, the requests package is used to prepare and execute HTTP requests. To install
the requests package, run pip install requests
in your cli. Subsequently, import the requests package
as shown below. This line will not reappear in other code snippets to enhance readability.
import requests
We're now ready to perform our first request. To retrieve a list of people from the API, we can use the
person
endpoint.
r = requests.get("http://openrechtspraak.nl/api/v1/person")
response = r.json()
print(len(response.get("data")))
print(response.get("count"))
General concepts
Offset pagination
You might have noticed that the response from the quickstart only returned a list of 20 people. The API only returns a limited number of people per request, which ensures you'll get a quick response. This is called a page.
Offset pagination allows you to retrieve a subsequent list of records, in other words: it allows you to retrieve
the
next page. Offset pagination works with two query parameters: offset
and limit
.
offset
determines the number of records that should be skipped. limit
determines the number
of records per page. The maximum limit for our API is 100. If our API includes 1.000 people, that means you'll need
to perform at least 10 requests.
Here is an example that retrieves the first 5 pages of people from our API:
limit = 5
people = []
for page in range(0, 5):
r = requests.get("http://localhost:5000/api/v1/person", params={
'offset': limit * page,
'limit': limit
})
response = r.json()
people.extend(response.get("data"))
print(f"Retrieved records for page {page}")
print(f"Done! Retrieved {len(people)} people")
Routes
LIST person
- Path
- /api/v1/person
Query parameters
- q
- String based search. Use % for a wildcard.
- former_judges
- Boolean (true/false, default: false) that determines whether former judges should be included in the result set.
- limit
- Integer (default: 20, max: 100) that determines the size of the result set.
- offset
- Integer (default: 0) that determines the number of records that should be skipped.
Example url
http://openrechtspraak.nl/api/v1/person?limit=2&offset=2&q=van
Origin of data
We scrape the names, professional details, side jobs and other information of judges from a database of the Dutch judiciary (Dutch only).
A judge is labeled as a 'former judge' if their profile is no longer accessible in this database. This is
indicated in the API response through the removed_from_rechtspraak_at
field, which contains the
datetime of when we tried to access that persons profile but got an error response.
Response 200
{
"count": 4075,
"data": [
{
"professional_details": [
{
"function": "Rechter-Plaatsvervanger",
"id": "e303527c-5ebb-43e1-aae0-bbaf87449d5a",
"organisation": "Rechtbank Amsterdam"
}
],
"first_name": null,
"gender": "male",
"id": "19e099ff-c05e-46b9-afa2-4d9e55ae7c28",
"initials": "B.G.L.",
"last_name": "Aa",
"rechtspraak_id": "OdESTwJMbvW70UdZPqTFX1dqz78u__71",
"removed_from_rechtspraak_at": "2023-05-21T20:35:30",
"titles": "dhr. mr.",
"toon_naam": "dhr. mr. B.G.L. van der Aa",
"toon_naam_kort": "B.G.L. van der Aa"
},
...
]
}
LIST verdicts for person
- Path
- /api/v1/person/id/verdicts
Query parameters
- limit
- Integer (default: 20, max: 100) that determines the size of the result set.
- offset
- Integer (default: 0) that determines the number of records that should be skipped.
Example url
http://openrechtspraak.nl/api/v1/person/5c6a1c12-9393-4c80-9ca4-3c3b6295ea6b/verdicts
Origin of data
We scrape verdicts directly from the API of the Dutch judiciary. You can query a verdict through this URL: https://data.rechtspraak.nl/uitspraken/content?id=ECLI:NL:RBAMS:2023:3197. Note that the Dutch judiciary does not support querying verdicts by judge.
Response 200
{
"count": 24,
"data": [
{
"coverage": "NL",
"ecli": "ECLI:NL:RBAMS:2023:3197",
"id": "9f84c60f-2ace-4c9c-9e7f-626db0d3314e",
"institution": "http://standaarden.overheid.nl/owms/terms/Rechtbank_Amsterdam",
"issued": "2023-05-19T12:33:23",
"legal_area": "http://psi.rechtspraak.nl/rechtsgebied#civielRecht",
"procedure": "Kort geding",
"procedure_type": "http://psi.rechtspraak.nl/procedure#kortGeding",
"spatial": "Amsterdam",
"subject": "Civiel recht",
"summary": "De gevraagde voorzieningen worden geweigerd, met uitzondering van het verbod ten aanzien van de vooraankondigingen/het promotiemateriaal.",
"title": "ECLI:NL:RBAMS:2023:3197, Rechtbank Amsterdam, 19-05-2023, C/13/733232 / KG ZA 23-375",
"type": "Uitspraak",
"uri": "https://uitspraken.rechtspraak.nl/InzienDocument?id=ECLI:NL:RBAMS:2023:3197"
},
...
]
}
Examples
Retrieving all people with 'aa' in their name
import requests
limit = 100
page = 0
people = []
while True:
r = requests.get("http://localhost:5000/api/v1/person", params={
'offset': limit * page,
'limit': limit,
'q': 'aa'
})
r.raise_for_status()
response = r.json()
data = response.get("data")
if len(data) == 0:
break
people.extend(data)
print(f"Retrieved records for page {page}")
page += 1
print(f"Done! Retrieved {len(people)} people")
Retrieving a list of people and writing them to a json file
import json
import requests
r = requests.get("http://localhost:5000/api/v1/person")
r.raise_for_status()
response = r.json()
data = response.get("data")
with open('export.json', 'w') as file:
json.dump(data, file)