---
title: "Match a person to birth and death records"
method: GET
path: "/records/match.json"
tags: ["Records"]
---

# Match a person to birth and death records

`GET /records/match.json`

## Request

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

Searches the genealogical dataset by exact name and birth year and returns the Open Archives URIs of birth records, death records and registrations in which the person is mentioned.

## Query parameters

- `name` string, required
- `birthyear` integer, required
- `lang` 'nl' | 'en'
- `callback` string

## Response `200`

Match results containing URIs to relevant records

- MatchResponse: Response from the Records/Match endpoint.
  - `query` object
    - `name` string
    - `birthyear` integer
    - `lang` string
  - `response` object
    - `number_found` integer
    - `docs` MatchDoc[]
      - `uri` string, uri: Open Archives URI for the matching record.
      - `eventtype` string: Type of the event in the requested language.
      - `eventplace` string: Place where the event occurred.
      - `sourcetype` string: Type of the source document.
      - `archive` string: Name of the archive in the requested language.
      - `archive_code` string: Short archive code.

## Other responses

- `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)