---
title: "Finds death records"
method: GET
path: "/records/getDeaths.json"
tags: ["Records"]
---

# Finds death records

`GET /records/getDeaths.json`

## Request

- Base URL: `https://api.openarchieven.nl/1.1`
- URL: `https://api.openarchieven.nl/1.1/records/getDeaths.json`
- Auth: none declared

## Query parameters

- `name` string, required
- `eventyear` integer
- `eventplace` string
- `number_show` integer
- `start` integer

## Response `200`

successful operation

- Search2Response
  - `query` SearchQuery: Echo of the interpreted search query.
    - `archive` string
    - `name` string
    - `only_results_with_scans` boolean
    - `start` integer
    - `number_show` integer
    - `sort` integer
    - `language` 'nl' | 'en' | 'de' | 'fr'
  - `response` Search2Results
    - `number_found` integer: total number of search results
    - `docs` Search2Result[]
      - `identifier` string
      - `archive_code` string
      - `archive_org` string
      - `archive` string
      - `personname` string
      - `relationtype` string
      - `_relationtype` string
      - `eventtype` string
      - `_eventtype` string
      - `eventdate` EventDate
        - `day` integer
        - `month` integer
        - `year` integer
      - `eventplace` string
      - `sourcetype` string
      - `url` string, uri

## Other responses

- `400`: Invalid parameters
- `429`: Too Many Requests — rate limit of 4 requests per second per IP exceeded.

---

[API](https://skmtc.dev/openarchieven/apis/open-archives-api.md) · [All operations](https://skmtc.dev/openarchieven/apis/open-archives-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openarchieven/apis/open-archives-api/revisions/4ff4685dd9e9?raw)