Open Archives API » Records/Show

Beware: this is the old documentation of the 1.0 version of this method. There's a new version which has an improved output for XML and JSON, TTL and NT, see the 1.1 documentation.

This method shows one specific genealogical record in either JSON, XML or GEDCOM format (UTF-8).

URL

https://api.openarchieven.nl/1.0/records/show.json

Method

GET

Input

NameRequiredDescriptionDefault
archiveYesCode of archive (obtain a list of valid archive codes via Stats/Archives)
identifierYesIdentifier of the record
callbackNoFunction name to be called on JSON data (JSONP).
langNoLanguage code (nl for Dutch, en for English) - this has only effect on the name of the archive, the sourcetype, the relationtype and the eventtype values in the JSON format.nl

Output

The returned data in is JSON(P) format and contains the complete Archive 2 All model record. Beware that the order may not be as speficied the XSD due to the fact that hashes loose order. See functional documentation and technical documentation of A2A (Dutch only).

Example: https://api.openarchieven.nl/1.0/records/show.json?archive=hua&identifier=E13B9821-C0B0-4AED-B20B-8DE627ED99BD outputs:

[
  {
    "a2a_Person": [
      {
        "pid": "Person907853733",
        "a2a_PersonName": {
          "a2a_PersonNameFirstName": {
            "a2a_PersonNameFirstName": "Barend Joseph"
          },
          "a2a_PersonNamePrefixLastName": {
            "a2a_PersonNamePrefixLastName": "van"
          },
          "a2a_PersonNameLastName": {
            "a2a_PersonNameLastName": "Berenstein"
          }
        },
        "a2a_Age": {
          "a2a_PersonAgeLiteral": {
            "a2a_PersonAgeLiteral": "37"
          }
        },
        "a2a_BirthPlace": {
          "a2a_Place": {
            "a2a_Place": "Amsterdam"
          }
        }
      },
      {
        "pid": "Person907853735",
        "a2a_PersonName": {
          "a2a_PersonNameFirstName": {
            "a2a_PersonNameFirstName": "Joseph"
          },
          "a2a_PersonNamePrefixLastName": {
            "a2a_PersonNamePrefixLastName": "van"
          },
          "a2a_PersonNameLastName": {
            "a2a_PersonNameLastName": "Berenstein"
          }
        }
      },
      {
        "pid": "Person907853736",
        "a2a_PersonName": {
          "a2a_PersonNameFirstName": {
            "a2a_PersonNameFirstName": "Fannij Jacoba"
          },
          "a2a_PersonNamePrefixLastName": {
            "a2a_PersonNamePrefixLastName": "van"
          },
          "a2a_PersonNameLastName": {
            "a2a_PersonNameLastName": "Beerenstijn"
          }
        }
      },
      {
        "pid": "Person907853734",
        "a2a_PersonName": {
          "a2a_PersonNameFirstName": {
            "a2a_PersonNameFirstName": "Janet"
          },
          "a2a_PersonNameLastName": {
            "a2a_PersonNameLastName": "Jones"
          }
        },
        "a2a_Age": {
          "a2a_PersonAgeLiteral": {
            "a2a_PersonAgeLiteral": "30"
          }
        },
        "a2a_BirthPlace": {
          "a2a_Place": {
            "a2a_Place": "Glasgow (Schotland)"
          }
        }
      },
      {
        "pid": "Person907853737",
        "a2a_PersonName": {
          "a2a_PersonNameFirstName": {
            "a2a_PersonNameFirstName": "Robert"
          },
          "a2a_PersonNameLastName": {
            "a2a_PersonNameLastName": "Jones"
          }
        }
      },
      {
        "pid": "Person907853738",
        "a2a_PersonName": {
          "a2a_PersonNameFirstName": {
            "a2a_PersonNameFirstName": "Margaret"
          },
          "a2a_PersonNameLastName": {
            "a2a_PersonNameLastName": "Gallacher"
          }
        }
      }
    ],
    "a2a_Event": {
      "eid": "Event1",
      "a2a_EventType": {
        "a2a_EventType": "Marriage"
      },
      "a2a_EventDate": {
        "a2a_LiteralDate": {
          "a2a_LiteralDate": "03-01-1866"
        },
        "a2a_Year": {
          "a2a_Year": "1866"
        },
        "a2a_Month": {
          "a2a_Month": "01"
        },
        "a2a_Day": {
          "a2a_Day": "03"
        }
      },
      "a2a_EventPlace": {
        "a2a_Province": {
          "a2a_Province": "Utrecht"
        },
        "a2a_Place": {
          "a2a_Place": "Utrecht"
        }
      }
    },
    "a2a_RelationEP": [
      {
        "a2a_PersonKeyRef": {
          "a2a_PersonKeyRef": "Person907853733"
        },
        "a2a_EventKeyRef": {
          "a2a_EventKeyRef": "Event1"
        },
        "a2a_RelationType": {
          "a2a_RelationType": "Groom"
        }
      },
      {
        "a2a_PersonKeyRef": {
          "a2a_PersonKeyRef": "Person907853735"
        },
        "a2a_EventKeyRef": {
          "a2a_EventKeyRef": "Event1"
        },
        "a2a_RelationType": {
          "a2a_RelationType": "Father of groom"
        }
      },
      {
        "a2a_PersonKeyRef": {
          "a2a_PersonKeyRef": "Person907853736"
        },
        "a2a_EventKeyRef": {
          "a2a_EventKeyRef": "Event1"
        },
        "a2a_RelationType": {
          "a2a_RelationType": "Mother of groom"
        }
      },
      {
        "a2a_PersonKeyRef": {
          "a2a_PersonKeyRef": "Person907853734"
        },
        "a2a_EventKeyRef": {
          "a2a_EventKeyRef": "Event1"
        },
        "a2a_RelationType": {
          "a2a_RelationType": "Bride"
        }
      },
      {
        "a2a_PersonKeyRef": {
          "a2a_PersonKeyRef": "Person907853737"
        },
        "a2a_EventKeyRef": {
          "a2a_EventKeyRef": "Event1"
        },
        "a2a_RelationType": {
          "a2a_RelationType": "Father of bride"
        }
      },
      {
        "a2a_PersonKeyRef": {
          "a2a_PersonKeyRef": "Person907853738"
        },
        "a2a_EventKeyRef": {
          "a2a_EventKeyRef": "Event1"
        },
        "a2a_RelationType": {
          "a2a_RelationType": "Mother of bride"
        }
      }
    ],
    "a2a_Source": {
      "a2a_SourcePlace": {
        "a2a_Country": {
          "a2a_Country": "Nederland"
        },
        "a2a_Province": {
          "a2a_Province": "Utrecht"
        },
        "a2a_Place": {
          "a2a_Place": "Utrecht"
        }
      },
      "a2a_SourceIndexDate": {
        "a2a_From": {
          "a2a_From": "1866-01-03"
        },
        "a2a_To": {
          "a2a_To": "1866-01-03"
        }
      },
      "a2a_SourceDate": {
        "a2a_LiteralDate": {
          "a2a_LiteralDate": "03-01-1866"
        },
        "a2a_Year": {
          "a2a_Year": "1866"
        },
        "a2a_Month": {
          "a2a_Month": "01"
        },
        "a2a_Day": {
          "a2a_Day": "03"
        }
      },
      "a2a_SourceType": {
        "a2a_SourceType": "Civil registration marriages"
      },
      "a2a_SourceReference": {
        "a2a_Place": {
          "a2a_Place": "Utrecht"
        },
        "a2a_InstitutionName": {
          "a2a_InstitutionName": "The Utrecht Archives"
        },
        "a2a_Archive": {
          "a2a_Archive": "481"
        },
        "a2a_Collection": {
          "a2a_Collection": "Utrecht 1866"
        },
        "a2a_RegistryNumber": {
          "a2a_RegistryNumber": "282-01"
        },
        "a2a_DocumentNumber": {
          "a2a_DocumentNumber": "5"
        }
      },
      "a2a_SourceAvailableScans": {
        "a2a_Scan": {
          "a2a_OrderSequenceNumber": {
            "a2a_OrderSequenceNumber": "1"
          },
          "a2a_Uri": {
            "a2a_Uri": "http:\/\/files.archieven.nl\/39\/f\/481\/_Projecten2014\\BatchGMSBS2013_02_T481-1811-1902_05548\\A128896\\NL-UtHUA_A128896_000001.jpg"
          },
          "a2a_UriViewer": {
            "a2a_UriViewer": "http:\/\/www.hetutrechtsarchief.nl\/collectie\/archiefbank\/archieftoegangen\/zoekresultaat?mivast=39&miadt=39&miaet=54&micode=481-282-01&minr=21917534&miview=ldt"
          },
          "a2a_UriPreview": {
            "a2a_UriPreview": "http:\/\/img.hetutrechtsarchief.nl\/?image=_Projecten2014\\BatchGMSBS2013_02_T481-1811-1902_05548\\A128896\\NL-UtHUA_A128896_000001.jpg&format=thumb"
          }
        }
      },
      "a2a_SourceLastChangeDate": {
        "a2a_SourceLastChangeDate": "2019-03-12"
      },
      "a2a_SourceDigitalOriginal": {
        "a2a_SourceDigitalOriginal": "https:\/\/www.hetutrechtsarchief.nl\/onderzoek\/resultaten\/archieven?mivast=39&miadt=39&miaet=54&micode=481-282-01&minr=21917534&miview=ldt"
      },
      "a2a_RecordIdentifier": {
        "a2a_RecordIdentifier": "907853732"
      },
      "a2a_RecordGUID": {
        "a2a_RecordGUID": "{E13B9821-C0B0-4AED-B20B-8DE627ED99BD}"
      },
      "a2a_SourceRemark": [
        {
          "Key": "Opmerking",
          "a2a_Value": {
            "a2a_Value": "Erkenning 2 kinderen, Margaret, * Boston N. Amerika 14-02-1858 en Elisabeth J. * Utr 30-03-1865"
          }
        },
        {
          "Key": "Provenance",
          "a2a_Value": {
            "a2a_Value": "A2Acollection NL-UtHUA_481-282-01_54_A2A.xml van HUA"
          }
        }
      ]
    }
  }
]

Errors

One of the following errors may be thrown:

Error codeError message
1Invalid archive
2Invalid identifier (syntax)
11Missing required archive
12Missing required identifier

An example error looks (pretty-printed) like:

{
	"error_code": 1,
	"error_description": "Invalid archive"
}

HTTP codes

Error codeError message
200OK
301The record has been removed, but a new record (with a different identifier) exists (HTTP client should follow the URL).
404The record doesn't exist
410The record doesn't exist anymore (and a new record isn't available)

URL

https://api.openarchieven.nl/1.0/records/show.xml

Method

GET

Input

NameRequiredDescriptionDefault
archiveYesCode of archive (obtain a list of valid archive codes via Stats/Archives)
identifierYesIdentifier of the record

Output

The returned record is in XML (A2A) Format. In case of an error a XML error message is returned (see table above).

Example: https://api.openarchieven.nl/1.0/records/show.xml?archive=hua&identifier=E13B9821-C0B0-4AED-B20B-8DE627ED99BD outputs:

<a2a_A2A xmlns:a2a="http://Mindbus.nl/A2A" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Version="1.7" xsi:schemaLocation="http://Mindbus.nl/A2A http://Mindbus.nl/A2A/A2AAllInOne_v.1.7.xsd">
	<a2a_Person pid="Person907853733">
		<a2a_PersonName>
			<a2a_PersonNameFirstName>Barend Joseph</a2a_PersonNameFirstName>
			<a2a_PersonNamePrefixLastName>van</a2a_PersonNamePrefixLastName>
			<a2a_PersonNameLastName>Berenstein</a2a_PersonNameLastName>
		</a2a_PersonName>
		<a2a_Age>
			<a2a_PersonAgeLiteral>37</a2a_PersonAgeLiteral>
		</a2a_Age>
		<a2a_BirthPlace>
			<a2a_Place>Amsterdam</a2a_Place>
		</a2a_BirthPlace>
	</a2a_Person>
	<a2a_Person pid="Person907853735">
		<a2a_PersonName>
			<a2a_PersonNameFirstName>Joseph</a2a_PersonNameFirstName>
			<a2a_PersonNamePrefixLastName>van</a2a_PersonNamePrefixLastName>
			<a2a_PersonNameLastName>Berenstein</a2a_PersonNameLastName>
		</a2a_PersonName>
	</a2a_Person>
	<a2a_Person pid="Person907853736">
		<a2a_PersonName>
			<a2a_PersonNameFirstName>Fannij Jacoba</a2a_PersonNameFirstName>
			<a2a_PersonNamePrefixLastName>van</a2a_PersonNamePrefixLastName>
			<a2a_PersonNameLastName>Beerenstijn</a2a_PersonNameLastName>
		</a2a_PersonName>
	</a2a_Person>
	<a2a_Person pid="Person907853734">
		<a2a_PersonName>
			<a2a_PersonNameFirstName>Janet</a2a_PersonNameFirstName>
			<a2a_PersonNameLastName>Jones</a2a_PersonNameLastName>
		</a2a_PersonName>
		<a2a_Age>
			<a2a_PersonAgeLiteral>30</a2a_PersonAgeLiteral>
		</a2a_Age>
		<a2a_BirthPlace>
		<	a2a_Place>Glasgow (Schotland)</a2a_Place>
		</a2a_BirthPlace>
	</a2a_Person>
	<a2a_Person pid="Person907853737">
		<a2a_PersonName>
			<a2a_PersonNameFirstName>Robert</a2a_PersonNameFirstName>
			<a2a_PersonNameLastName>Jones</a2a_PersonNameLastName>
		</a2a_PersonName>
	</a2a_Person>
	<a2a_Person pid="Person907853738">
		<a2a_PersonName>
			<a2a_PersonNameFirstName>Margaret</a2a_PersonNameFirstName>
			<a2a_PersonNameLastName>Gallacher</a2a_PersonNameLastName>
		</a2a_PersonName>
	</a2a_Person>
	<a2a_Event eid="Event1">
		<a2a_EventType>Huwelijk</a2a_EventType>
		<a2a_EventDate>
			<a2a_LiteralDate>03-01-1866</a2a_LiteralDate>
			<a2a_Year>1866</a2a_Year>
			<a2a_Month>01</a2a_Month>
			<a2a_Day>03</a2a_Day>
		</a2a_EventDate>
		<a2a_EventPlace>
			<a2a_Province>Utrecht</a2a_Province>
			<a2a_Place>Utrecht</a2a_Place>
		</a2a_EventPlace>
	</a2a_Event>
	<a2a_RelationEP>
		<a2a_PersonKeyRef>Person907853733</a2a_PersonKeyRef>
		<a2a_EventKeyRef>Event1</a2a_EventKeyRef>
		<a2a_RelationType>Bruidegom</a2a_RelationType>
	</a2a_RelationEP>
	<a2a_RelationEP>
		<a2a_PersonKeyRef>Person907853735</a2a_PersonKeyRef>
		<a2a_EventKeyRef>Event1</a2a_EventKeyRef>
		<a2a_RelationType>Vader van de bruidegom</a2a_RelationType>
	</a2a_RelationEP>
	<a2a_RelationEP>
		<a2a_PersonKeyRef>Person907853736</a2a_PersonKeyRef>
		<a2a_EventKeyRef>Event1</a2a_EventKeyRef>
		<a2a_RelationType>Moeder van de bruidegom</a2a_RelationType>
	</a2a_RelationEP>
	<a2a_RelationEP>
		<a2a_PersonKeyRef>Person907853734</a2a_PersonKeyRef>
		<a2a_EventKeyRef>Event1</a2a_EventKeyRef>
		<a2a_RelationType>Bruid</a2a_RelationType>
	</a2a_RelationEP>
	<a2a_RelationEP>
		<a2a_PersonKeyRef>Person907853737</a2a_PersonKeyRef>
		<a2a_EventKeyRef>Event1</a2a_EventKeyRef>
		<a2a_RelationType>Vader van de bruid</a2a_RelationType>
	</a2a_RelationEP>
	<a2a_RelationEP>
		<a2a_PersonKeyRef>Person907853738</a2a_PersonKeyRef>
		<a2a_EventKeyRef>Event1</a2a_EventKeyRef>
		<a2a_RelationType>Moeder van de bruid</a2a_RelationType>
	</a2a_RelationEP>
	<a2a_Source>
		<a2a_SourcePlace>
			<a2a_Country>Nederland</a2a_Country>
			<a2a_Province>Utrecht</a2a_Province>
			<a2a_Place>Utrecht</a2a_Place>
		</a2a_SourcePlace>
		<a2a_SourceIndexDate>
			<a2a_From>1866-01-03</a2a_From>
			<a2a_To>1866-01-03</a2a_To>
		</a2a_SourceIndexDate>
		<a2a_SourceDate>
			<a2a_LiteralDate>03-01-1866</a2a_LiteralDate>
			<a2a_Year>1866</a2a_Year>
			<a2a_Month>01</a2a_Month>
			<a2a_Day>03</a2a_Day>
		</a2a_SourceDate>
		<a2a_SourceType>BS Huwelijk</a2a_SourceType>
		<a2a_SourceReference>
			<a2a_Place>Utrecht</a2a_Place>
			<a2a_InstitutionName>Het Utrechts Archief</a2a_InstitutionName>
			<a2a_Archive>481</a2a_Archive>
			<a2a_Collection>Utrecht 1866</a2a_Collection>
			<a2a_RegistryNumber>282-01</a2a_RegistryNumber>
			<a2a_DocumentNumber>5</a2a_DocumentNumber>
		</a2a_SourceReference>
		<a2a_SourceAvailableScans>
			<a2a_Scan>
				<a2a_OrderSequenceNumber>1</a2a_OrderSequenceNumber>
				<a2a_Uri>http://files.archieven.nl/39/f/481/_Projecten2014\BatchGMSBS2013_02_T481-1811-1902_05548\A128896\NL-UtHUA_A128896_000001.jpg</a2a_Uri>
				<a2a_UriViewer>http://www.hetutrechtsarchief.nl/collectie/archiefbank/archieftoegangen/zoekresultaat?mivast=39&miadt=39&miaet=54&micode=481-282-01&minr=21917534&miview=ldt</a2a_UriViewer>
				<a2a_UriPreview>http://img.hetutrechtsarchief.nl/?image=_Projecten2014\BatchGMSBS2013_02_T481-1811-1902_05548\A128896\NL-UtHUA_A128896_000001.jpg&format=thumb</a2a_UriPreview>
			</a2a_Scan>
		</a2a_SourceAvailableScans>
		<a2a_SourceLastChangeDate>2019-03-12</a2a_SourceLastChangeDate>
		<a2a_SourceDigitalOriginal>https://www.hetutrechtsarchief.nl/onderzoek/resultaten/archieven?mivast=39&miadt=39&miaet=54&micode=481-282-01&minr=21917534&miview=ldt</a2a_SourceDigitalOriginal>
		<a2a_RecordIdentifier>907853732</a2a_RecordIdentifier>
		<a2a_RecordGUID>{E13B9821-C0B0-4AED-B20B-8DE627ED99BD}</a2a_RecordGUID>
		<a2a_SourceRemark Key="Opmerking">
			<a2a_Value>Erkenning 2 kinderen, Margaret, * Boston N. Amerika 14-02-1858 en Elisabeth J. * Utr 30-03-1865</a2a_Value>
		</a2a_SourceRemark>
		<a2a_SourceRemark Key="Provenance">
			<a2a_Value>A2Acollection NL-UtHUA_481-282-01_54_A2A.xml van HUA</a2a_Value>
		</a2a_SourceRemark>
	</a2a_Source>
</a2a_A2A>

URL

https://api.openarchieven.nl/1.0/records/show.gedcom

Method

GET

Input

NameRequiredDescriptionDefault
archiveYesCode of archive (obtain a list of valid archive codes via Stats/Archives)
identifierYesIdentifier of the record

Output

The returned record is in GEDCOM 5.5.5 Format. In case of an error a JSON error message is returned (see table above).

Example: https://api.openarchieven.nl/1.0/records/show.gedcom?archive=hua&identifier=E13B9821-C0B0-4AED-B20B-8DE627ED99BD outputs:

0 HEAD
1 SOUR OPENARCH
2 VERS 0.2
2 NAME Open Archieven
2 CORP Coret Genealogie
3 WWW https://genealogie.coret.org/
1 DATE 24 SEP 2019
2 TIME 18:08
1 SUBM @Uoa@
1 FILE openarch-20190924-180841.ged
1 CHAR UTF-8
1 GEDC
2 VERS 5.5.5
2 FORM LINEAGE-LINKED
3 VERS 5.5.5
1 LANG Dutch
0 @Uoa@ SUBM
1 NAME Open Archieven
1 WWW https://www.openarchieven.nl/
0 @I6885426227610271@ INDI
1 NAME Barend Joseph /van Berenstein/
2 GIVN Barend Joseph
2 SPFX van
2 SURN Berenstein
1 SEX M
1 BIRT
2 PLAC Amsterdam
1 FAMS @F1457373239444841@
1 FAMC @F1457373239444842@
0 @I6885426227610272@ INDI
1 NAME Joseph /van Berenstein/
2 GIVN Joseph
2 SPFX van
2 SURN Berenstein
1 SEX M
1 FAMS @F1457373239444842@
0 @I6885426227610273@ INDI
1 NAME Fannij Jacoba /van Beerenstijn/
2 GIVN Fannij Jacoba
2 SPFX van
2 SURN Beerenstijn
1 SEX F
1 FAMS @F1457373239444842@
0 @I6885426227610274@ INDI
1 NAME Janet /Jones/
2 GIVN Janet
2 SURN Jones
1 SEX F
1 BIRT
2 PLAC Glasgow (Schotland)
1 FAMS @F1457373239444841@
1 FAMC @F1457373239444843@
0 @I6885426227610275@ INDI
1 NAME Robert /Jones/
2 GIVN Robert
2 SURN Jones
1 SEX M
1 FAMS @F1457373239444843@
0 @I6885426227610276@ INDI
1 NAME Margaret /Gallacher/
2 GIVN Margaret
2 SURN Gallacher
1 SEX F
1 FAMS @F1457373239444843@
0 @F1457373239444841@ FAM
1 HUSB @I6885426227610271@
1 WIFE @I6885426227610274@
1 MARR
2 DATE 3 JAN 1866
2 PLAC Utrecht
2 NOTE Erkenning 2 kinderen, Margaret, * Boston N. Amerika 14-02-1858 en Elisabeth J. * Utr 30-03-18
3 CONC 65
2 SOUR @S1717948260482882@
3 NOTE Scan via https://www.hetutrechtsarchief.nl/collectie/archiefbank/archieftoegangen/zoekresulta
4 CONC at?mivast=39&miadt=39&miaet=54&micode=481-282-01&minr=21917534&miview=ldt
3 PAGE Akte 5
3 DATA
4 DATE 3 JAN 1866
3 NOTE https://www.openarchieven.nl/hua:E13B9821-C0B0-4AED-B20B-8DE627ED99BD
0 @F1457373239444842@ FAM
1 HUSB @I6885426227610272@
1 WIFE @I6885426227610273@
1 CHIL @I6885426227610271@
0 @F1457373239444843@ FAM
1 HUSB @I6885426227610275@
1 WIFE @I6885426227610276@
1 CHIL @I6885426227610274@
0 @S1717948260482882@ SOUR
1 DATA
2 EVEN MARR
3 DATE FROM 3 JAN 1866 TO 3 JAN 1866
3 PLAC Utrecht
1 TITL Utrecht 1866
1 ABBR BS Huwelijk
1 REPO @Rhua@
0 @Rhua@ REPO
1 NAME Het Utrechts Archief
1 ADDR
1 ADR1 Hamburgerstraat 28
2 POST 3512 NS
2 CITY Utrecht
2 CTRY Nederland
1 WWW https://hetutrechtsarchief.nl/
1 EMAIL inlichtingen@@hetutrechtsarchief.nl
1 PHON +31 30 2866611
0 TRLR

Back to API documentation

Zoek uw voorouders en publiceer uw stamboom op Genealogie Online via https://www.genealogieonline.nl/