Open Archives API » Records/Match

This method searches the genealogical dataset by name (exact) and birthyear and returns the Open Archives URI's of birth- & deathrecords and registrations in which this person is mentioned.

URL

https://api.openarch.nl/1.0/records/match.json

Method

GET

Input

Name	Required	Description	Default
name	Yes	Name of a person (no special operators available)
birthyear	Yes	Year of birth (numerical value)
lang	No	Language code (nl for Dutch, en for English) - this has only effect on the eventtype, sourcetype and archive labels in the search results.	nl
callback	No	Function name to be called on JSON data

Output

The returned JSON(P) contains basically two items: the query as interpretered by the API and the response which contains an array of match results.

Example: https://api.openarch.nl/1.0/records/match.json?name=Elizabeth%20Schoolmeester&birthyear=1818 outputs (in pretty-print):

 
{
	query: {
		name: "Elizabeth Schoolmeester",
		birthyear: 1818,
		lang: "en"
	},
	response: {
		docs: [
			{
				uri: "https://www.openarchieven.nl/zar:242FCD17-6CB7-4D5E-AFED-FD78017E7D6E",
				eventtype: "Birth",
				eventplace: "Nisse",
				sourcetype: "Civil registration births",
				archive: "Zeeland Archives",
				archive_code: "zar"
			},{
				uri: "https://www.openarchieven.nl/bor:b58fc802-17c9-a9ab-58d5-061d19489ef4",
				eventtype: "Birth",
				eventplace: "Nisse",
				sourcetype: "Civil registration births",
				archive: "Municipal Archive Borsele",
				archive_code: "bor"
			}
		],
		number_found: 2
	}
}

Back to API documentation