Computational Use of Archival Materials

All of our online materials and our metadata are available for bulk access via open REST APIs.

Access to Archival Metadata as XML

All of our archival metadata is available though the UAlbanyArchives GitHub Page as EAD XML files.

EAD 2002 Resources:

API Access to Online Materials though Archival Metadata

We think that it might be useful to iterate though archival metadata to access online materials. Archival metadata is hierarchical, which collection records linking to multiple levels of child records (series, subseries, files, or items). The lowest-order child records may link to an online version or to the containers that house them.

Collection records can be called using their collection ID, with this URI and the param ?format=json:[:id]?format=json


Collection IDs can be found in the URL for each collection page. A full list of collections is available here. Just add the param ?format=json to the end of any collection page to see the JSON API.

Find Collection ID

Finding Child Records

To find child records for any item, use the same URI following params:

  • ?f[parent_ssi][]=[:id]&
  • &view=hierarchy
  • &format=json


The response JSON will have a data key which will be a list of all children. You can get the ID for the child with the id key. All records below collections have a 32 digit alphanumeric ID prepended by the collection ID and aspace_.

To get the full record, append the ID to the same URI with the ?format=json param.


Accessing Online Content Records

Some records either represent online content, or have children that represent online content. These records have an has_online_content_ssim key set to true.

If a records where has_online_content_ssim is true, you can check the component_children_bsi key to check if the records has child records. If the record does not have child records, it will have a digital_objects_ssm key which is a list of json containing the URI for the online content record.

Example of an online content URI in a record

To get the online content record, use that uri with an additional ?format=json param.


Accessing Digital Files

Once you have the online content URI, add the ?format=jsonld param for access to the digital file(s).


Find the ID for each file in a list as the @graph key. The ID is in the ore:proxyIn and @id keys. Replace "' in the URI with "" to get the URL for the binary file

Finding the ID for each binary file



Council on Library and Information Resources Logo
ArcLight Logo
Hyrax Logo