Open Archives API » Records/Yearsago

Beware: this is the documentation of the 1.0 version of this method, see the 1.1 documentation.

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

URL

https://api.openarchieven.nl/1.0/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 the list of people born specified years ago

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

[
	{
		"archive": "elo",
		"identifier": "15ddb465-2696-e224-9cd6-b57095041e45",
		"name": "Geertruida Wiede",
		"place": "Leiden",
		"scan": true
	}
]

A link to the HTML page where the record is shown can be constructed as follows:
https://www.openarchieven.nl/show.php?archive={archive}&identifier={identifier}

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