---
title: "Search genealogical records"
method: GET
path: "/records/search.json"
tags: ["Records"]
---

# Search genealogical records

`GET /records/search.json`

## Request

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

Searches the genealogical dataset and returns found persons and records. Supports filtering by archive, source type, event place, birth place, relation type and country. Results are pageable and sortable. Note: version 1.1 uses `archive_code` instead of `archive`.

## Query parameters

- `name` string, required
- `archive_code` string
- `not_archive` 0 | 1
- `number_show` integer
- `sourcetype` string
- `eventplace` string
- `birthplace` string
- `relationtype` string
- `country_code` string
- `sort` -6 | -5 | -4 | -3 | -2 | -1 | 1 | 2 | 3 | 4 | 5 | 6
- `start` integer
- `lang` 'nl' | 'en'
- `callback` string

## Response `200`

Successful search response

- SearchResponse: Top-level search response.
  - `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` object
    - `number_found` integer: Total number of results found.
    - `docs` SearchDoc[]
      - `pid` string: Person identifier.
      - `identifier` string: Record UUID.
      - `archive_code` string: Archive code.
      - `archive_org` string: Name of the archive organisation (Dutch).
      - `archive` string: Name of the archive (in the requested language).
      - `personname` string: Name of the person as it appears in the record.
      - `relationtype` string: Relation type in the requested language.
      - `_relationtype` string: Relation type in Dutch.
      - `eventtype` string: Event type in the requested language.
      - `_eventtype` string: Event type in Dutch.
      - `eventdate` object, nullable
        - `day` integer
        - `month` integer
        - `year` integer
      - `eventplace` string, nullable: Place where the event occurred.
      - `sourcetype` string: Type of the source document.
      - `url` string, uri: URL of the record on Open Archives.

## Other responses

- `400`: Invalid request 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)