gahetNA in the National Archives

Open Data

The collection of the Dutch National Archives is divided in several sub-data collections.

A large part of this material is available as open data with an open license or waiver. The way in which this material can be obtained is different from data collection to data collection.

Archive  inventories

Data Collection

Collection

Collection part

Archive Inventories

Amount

Approx. 6400

Percentage Open Data

98 %

Licence

CC0

Technique

OAI-PMH

Format

EAD/XML

The HTML and XML of an individual archive inventory contains a clear indication of the CC0 license on work itself. A small percentage (2%) is not yet covered because these are made in the past by external partners which probably still hold the copyright. Through the OAI-PMH interface archive inventories can be called; in this process EAD / XML is returned.

Through OAI-PMH archival inventories can be requested; EAD/XML is being returned. The OAI-PMH is as follows, the base URL is:

Requesting the identification data of an OAI-PMH repository the ‘verb’: Identify can be used:

Requesting sets which contain an OAI-PMH repository the ‘verb’: ListSets can be used:

The NA OAI-PMH repository contains four sets: naa1 , naa2 , naa3 and naa4 , corresponding to the entrances of the 1.xx series, the 2.xx series, the series 3.xx and 4.xx series. To retrieve the metadata formats in which the data is offered by an OAI-PMH the ‘verb’: ListMetadataFormats can be used:

The NA OAI-PMH repository provides the data in 3 metadata formats: oai_dc (Dublin Core / XML), oai_ead (brief EAD / XML) and oai_ead_full (full EAD / XML).

Requesting the identifiers of the records of a set of an OAI-PMH repository the 'verb': ListIdentifiers can be used. In combination with the set name and the metadata format: 

Dit verzoek vraagt om de archiefinventarisnummers (identifiers) van de 4.xx-serie toegangen (set: naa4)
Het opvragen van alle records van een set van een OAI-PMH repositorye werkt met het ‘verb’: ListRecords, in combinatie met de set-naam en het metadata format:

This request asks for the very brief EAD/XML information (metadata format: oai_ead) of all accesses 1.xx series (set: naa1)

For the retrieval of the content of record of an OAI PMH repository the 'verb': GetRecord can be used. In combination with the identifier and the metadata format:

This request asks for archive inventory 3.18.20 (identifier: 3:18:20) in full EAD/XML representation (metadata format: oai_ead_full)

Scans of Archives

Data Collection

Value                                      

Collection part

Scans of Archives

Amount

Approx. 500.000

Percentage Open Data

50%

Licence

Public Domain and CC0

Technique

Open Search Api

Format

XML en JPEG 1280 pixels (lange zijde), 72 DPI

A fair amount  of scans connected with the various archive inventories are available with the Open Search Api

View the list of archives with scans available as open data (PDF, 78KB).

Not available scans of the Surinam Archives (1.05.11.15, 1.05.11.16 and 2.10.19.01), the scans in the Copied Archive File Afscheid van Indië (Farewell of the Indies) (2:22:21) and the Sailing Letters (2:22:24). All these duplicates are made of archives which are not located in The Hague.

The scans with an open data license available can be called with the URL of the Open Search Api. The description document of the Api describes which fields can be searched through.

When the scans of the Abbey of Rijnsburg (archive inventory 3:18:20) are used as an example, the URL would look like:

http://www.gahetna.nl/beeldbank-api/opensearch/?q=3.18.20&count=100&startIndex=1

The API provides eacht call up to 100 records in return (&count=100) and start showing the results on page 1 (&startIndex=1). When the result contains more than 100 records (<opensearch:totalResults>) >), the page can be extended until the last result is achieved. A record in the case of Scans of Archives is an inventory number. A record can accommodate multiple scans in itself.
Through the <field name="Inventarisnummer"> field records can be easily connected with the XML from the archive inventories.

It is also possible to query all scans of one individual inventory number with the API. Due to the logical file structure of the archive inventory and inventory number, the first inventorynumber 1.4 from archive inventory 3.18.20 can be translated to 3.18.20_1.4. The URL then looks like:

http://www.gahetna.nl/beeldbank-api/opensearch/?q=3.18.20_1.4&count=100&startIndex=1 

Indexes

Data Colellection

Value

Collection part

Indexrecords

Amount

96 indexes (Approx. 1350.000 records)

Percentage Open Data

88%

Licence

CC0 and CC-BY-SA

Technique

Datadump

Format

XML and CSV

A large part of the indexes are available as open data under a CC0 (94x) waiver or a CC-BY-SA (2x) License:

For privacy reasons or because indexes were created in collaboration with external partners (when copyright was not an issue) 13 indexes are not (yet) available under these conditions:

Om privacy redenen of omdat indexen met derden zijn gemaakt en destijds onvoldoende rekening is gehouden met auteursrechten vallen 13 indexen (nog) niet onder deze voorwaarden:

Indexes provide individually information whether they have an open data waiver or license. For example in the Licentie menu on the left. When an open data waiver or license is applicable on the material, the index can be downloaded. The download (ZIP, xxx.xx KB) contains an XML file describing the metadata of the index, including the waiver or license and CSV file with the actual content of the index..

Maps

Data Collection

Value

Collection part

Kaarten

Amount

6200

Percentage Open Data

100%

Licence

Public Domain and CC0

Technique

Open Search Api

Format

XML and JPEG 1280 pixels (long side), 72 DPI

The maps available with an open data license can be called with the URL of the Open Search Api. The description document of the Api describes which fields can be searched through.

When the maps of the 4.ZHPB collection are taken as an example, the URL would look like:

http://www.gahetna.nl/beeldbank-api/opensearch/?q=4.ZHPB4&count=100&startIndex=1

The API provides eacht call up to 100 records in return (&count=100) and start showing the results on page 1 (&startIndex=1). When the result contains more than 100 records (<opensearch:totalResults>) >), the page can be extended until the last result is achieved. A record in the case of Maps is an inventory number. A record can in some cases accommodate multiple scans of maps in itself. The metadata in XML provides a detailed description of the map itself.

Photos

Data Collection

Value

Collection part

Photos

Amount

Approx. 250.000

Percentage Open Data

25%

Licence

CC-BY-SA and Public Domain

Technique

Open Search Api

Format

XML and JPEG 1280 pixels (long side), 72 DPI

Copyright in the context of photographs is generally complex. Because all rights of a significantly number of pictures were completely transmitted (in the past) to the Dutch  National Archives, it offered the possibility to arrange an open data license on these images.

The photos available with an open data license can be called with the URL of the Open Search Api. The description document of the Api describes which fields can be searched through.

When the photos of Willem van de Poll (archive inventory 2.24.14.02) are taken as an example, the URL would look like:

http://www.gahetna.nl/beeldbank-api/opensearch/?q=2.24.14.02&count=100&startIndex=1

The API provides each call up to 100 records in return (&count=100) and start showing the results on page 1 (&startIndex=1). When the result contains more than 100 records (<opensearch:totalResults>) >), the page can be extended until the last result is achieved. A record in the case of Photo is called a bestanddeelnummer. A record can in some rare cases accommodate multiple scans of photos in itself. The metadata in XML provides a detailed description of the photo itself.

Attribution and License

In the context of a CC-BY-SA license, with reuse the attribution (BY) and license (Share Alike) need t be mentioned correct. For thispurpose we have some guidelines. In the case of Public Domain and CC0 waivers attribution and licenses are not mandatory, however is appreciated .

The essence of the attribution consists of the Dutch National Archives (as an institution) the title and location of the archival record.

Collection Part

Attribution and License

Required

Archive Inventories

 

 

Dutch National Archives, The Hague, [archive name], [period], catalog reference number [xx.xx.xx], inventory number [xxx]

abbreviated

NL-HaNA, [archive name abbreviated + period], [catalog reference number xx.xx.xx], inv.nr. [xxx]

Not obliged because of CC0, however is appreciated

 

 

Scans of Archives

Dutch Nationaal Archives, The Hague, [catalog reference number xx.xx.xx], inv.nr. [xxx]

Not obliged because of PD (Public Domain), however is appreciated

Indexes

 

 

 

In the context of a CC-BY-SA license:

Dutch National Archives, The Hague, [title index + period], [name author]. License CC-BY-SA

In the context of CC0:

Dutch National Archives, The Hague, [title index + period]

Required where indexes are made available through CC-BY-SA

Not obliged in the case of of CC0, however is appreciated

 

 

Photos
 

 

 

Dutch National Archives, The Hague, [archive name], [period], catalog reference number [xx.xx.xx], inventory number [xxx], license CC-BY-SA 

abbreviated

NL-HaNA, [archive name abbreviated + period], [catalog reference number xx.xx.xx], inv.nr. [xxx], license CC-BY-SA

Required where photos are made available through CC-BY-SA

Not obliged in the case of PD (Public Domain), however is appreciated

 

Maps

 

 

Dutch National Archives, The Hague, [archive name], [period], catalog reference number [xx.xx.xx], inventory number [xxx]

abbreviated

NL-HaNA, [archive name abbreviated + period], [catalog reference number xx.xx.xx], inv.nr. [xxx]

Not obliged in the case of PD (Public Domain), however is appreciated

 

 

More Information

via @timmietovenaar or via info@nationaalarchief.nl

gahetNA is a website of the Society for the Nationaal Archief in cooperation with the Nationaal Archief and Spaarnestad Photo.
Advanced
Search in collections
Search in: