Records

Search genealogical records

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.

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

Query parameters

namestring required

Search query. Can include two names separated by & and a year or period. See https://www.openarchieven.nl/ for advanced query syntax.

archive_codestring

Filter results on a specific archive. Obtain valid archive codes via the Stats/Archives endpoint.

not_archive0 | 1

When set to 1 in combination with archive_code, results from the selected archive are excluded instead of the search being restricted to it. Has no effect without archive_code.

number_showinteger

Number of results to return. Maximum is 100.

sourcetypestring

Filter results on source type. Obtain valid source types via the Stats/Sources endpoint.

eventplacestring

Filter results on event place.

birthplacestring

Filter results on birth place of the person.

relationtypestring

Filter results on relation type (e.g. Bride, Groom, Registered).

country_codestring

Filter results on country. Available codes: nl, be, fr, sr, etc.

sort-6 | -5 | -4 | -3 | -2 | -1 | 1 | 2 | 3 | 4 | 5 | 6

Column to sort results on. Use a negative value to sort descending, positive to sort ascending. 1=Name, 2=Role, 3=Event, 4=Date, 5=Place, 6=Source.

startinteger

Initial result offset for paging. Deep pagination is not supported: the maximum allowed value is 10000. Requests with start greater than 10000 are rejected with HTTP 400 (error_code 50).

lang'nl' | 'en'

Language code. Affects archive name, sourcetype, relationtype and eventtype labels in the response.

callbackstring

JavaScript function name for JSONP callback.

Response

Successful search response

Example response

{
  "response": {
    "number_found": 1060
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.