Open Archives API » Records/Yearsago

Beware: this is the documentation of the 1.1 version of this method which uses archive_code (not archive) for archive code and includes the archive name and record URL. The old version 1.0 is still available, see the 1.0 documentation.

This method returns a list of births which took place years ago.

URL

https://api.openarchieven.nl/1.1/records/yearsago.json

Method

GET

Input

Name	Required	Description	Default
years	Yes	Number of years ago (date is calculated from today)
number_show	No	Maximum number of persons returned	10
callback	No	Function name to be called on JSON data (JSONP).

Output

Returns in JSON format a list of birth records from people born specified years ago

Example: https://api.openarchieven.nl/1.1/records/yearsago.json?years=200

[
  {
    "archive_code": "hco",
    "archive": "Historisch Centrum Overijssel",
    "identifier": "AD23D724-9527-4EE9-AA1A-DAFF91AF9E89",
    "name": "Sophia Fredrika van der Vegt",
    "place": "Emmen (Dalfsen)",
    "scan": 1,
    "url": "https://www.openarchieven.nl/hco:AD23D724-9527-4EE9-AA1A-DAFF91AF9E89"
  },
  {
    "archive_code": "hco",
    "archive": "Historisch Centrum Overijssel",
    "identifier": "CC465BDE-3F4C-462B-BE3C-667C57880B1F",
    "name": "NN Volders",
    "place": "Kampen",
    "scan": 1,
    "url": "https://www.openarchieven.nl/hco:CC465BDE-3F4C-462B-BE3C-667C57880B1F"
  },
  {
    "archive_code": "hco",
    "archive": "Historisch Centrum Overijssel",
    "identifier": "F7EC23B6-9954-4999-8A6A-5E14F2C62924",
    "name": "Johanna Geertruida Kaptein",
    "place": "Kampen",
    "scan": 1,
    "url": "https://www.openarchieven.nl/hco:F7EC23B6-9954-4999-8A6A-5E14F2C62924"
  },
  {
    "archive_code": "aal",
    "archive": "Stadsarchief Aalst",
    "identifier": "f9fb495a-3caf-399a-aaa7-4937efdb0640",
    "name": "Rosalia Vander Maeren",
    "place": "Hofstade",
    "scan": 1,
    "url": "https://www.openarchieven.nl/aal:f9fb495a-3caf-399a-aaa7-4937efdb0640"
  },
  {
    "archive_code": "aal",
    "archive": "Stadsarchief Aalst",
    "identifier": "bfdb438a-52d4-35f6-d57f-5521c993c258",
    "name": "Hubertus Dionisius Barrez",
    "place": "Aalst",
    "scan": 1,
    "url": "https://www.openarchieven.nl/aal:bfdb438a-52d4-35f6-d57f-5521c993c258"
  },
  {
    "archive_code": "abh",
    "archive": "Rijksarchief België (Hasselt)",
    "identifier": "23655061-c126-87d4-7667-48b2fdaef7ab",
    "name": "Henri Guilleaume Coune",
    "place": "Sluizen",
    "scan": 1,
    "url": "https://www.openarchieven.nl/abh:23655061-c126-87d4-7667-48b2fdaef7ab"
  },
  {
    "archive_code": "gld",
    "archive": "Gelders Archief",
    "identifier": "D4797C6F-421D-4AFD-808D-571954A6FACE",
    "name": "Maria Jacomina Hendriks",
    "place": "Zutphen",
    "scan": 1,
    "url": "https://www.openarchieven.nl/gld:D4797C6F-421D-4AFD-808D-571954A6FACE"
  },
  {
    "archive_code": "rhe",
    "archive": "Regionaal Historisch Centrum Eindhoven",
    "identifier": "D31F5068-C3D9-412B-B1DD-C6FC092ED6A1",
    "name": "Johannis Manders",
    "place": "Geldrop",
    "scan": 1,
    "url": "https://www.openarchieven.nl/rhe:D31F5068-C3D9-412B-B1DD-C6FC092ED6A1"
  },
  {
    "archive_code": "zar",
    "archive": "Zeeuws Archief",
    "identifier": "DAE34DB7-5EB0-4368-BE41-4067E58CA7C4",
    "name": "Pieter Meijers",
    "place": "Serooskerke",
    "scan": 1,
    "url": "https://www.openarchieven.nl/zar:DAE34DB7-5EB0-4368-BE41-4067E58CA7C4"
  },
  {
    "archive_code": "zar",
    "archive": "Zeeuws Archief",
    "identifier": "CDB399A9-0B4B-4B03-B6FB-9A11C9635885",
    "name": "Paulina Moerman",
    "place": "Heinkenszand",
    "scan": 1,
    "url": "https://www.openarchieven.nl/zar:CDB399A9-0B4B-4B03-B6FB-9A11C9635885"
  }
]

Errors

One of the following errors may be thrown:

Error code	Error message
9	Invalid years
10	Invalid number_show
16	Missing required years

An example error looks (pretty-printed) like:

{
	"error_code": 9,
	"error_description": "Invalid years"
}

Back to API documentation