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).
https://api.openarchieven.nl/1.0/records/show.json
GET
Name | Required | Description | Default |
---|---|---|---|
archive | Yes | Code of archive (obtain a list of valid archive codes via Stats/Archives) | |
identifier | Yes | Identifier of the record | |
callback | No | Function name to be called on JSON data (JSONP). | |
lang | No | Language 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 |
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" } } ] } } ]
One of the following errors may be thrown:
Error code | Error message |
---|---|
1 | Invalid archive |
2 | Invalid identifier (syntax) |
11 | Missing required archive |
12 | Missing required identifier |
An example error looks (pretty-printed) like:
{ "error_code": 1, "error_description": "Invalid archive" }
Error code | Error message |
---|---|
200 | OK |
301 | The record has been removed, but a new record (with a different identifier) exists (HTTP client should follow the URL). |
404 | The record doesn't exist |
410 | The record doesn't exist anymore (and a new record isn't available) |
https://api.openarchieven.nl/1.0/records/show.xml
GET
Name | Required | Description | Default |
---|---|---|---|
archive | Yes | Code of archive (obtain a list of valid archive codes via Stats/Archives) | |
identifier | Yes | Identifier of the record |
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>
https://api.openarchieven.nl/1.0/records/show.gedcom
GET
Name | Required | Description | Default |
---|---|---|---|
archive | Yes | Code of archive (obtain a list of valid archive codes via Stats/Archives) | |
identifier | Yes | Identifier of the record |
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
Zoek uw voorouders en publiceer uw stamboom op Genealogie Online via https://www.genealogieonline.nl/