NIMH Data Archive Web Services

The NIMH Data Archive (NDA) provides a variety of web services to support computational scientists, and to facilitate efficient integration between research systems. These direct system-to-system interfaces can be used to both deposit and access NDA data and metadata.  

Below you can find a short description of each available service, and a link that will allow you to access these resources.  These services provide RESTful interfaces, and we are actively updating each to follow the Open API Specification using the Swagger API Framework, including a browser-based User Interface.

In addition to the more modern RESTful services, we provide a legacy SOAP-based service for issuing temporary credentials that can be used with Amazon Web Services S3 API to access content from data files (i.e., raw and analyzed Omics and Neurosignal Recordings data).  More detail on this can be found in the Cloud section of our Tools page.

As new services become available they will be documented here.  If you have feedback on an existing service, or ideas for improvements or new services please send them to



Sample code for interacting with the services, including how to obtain AWS authentication tokens and download files, can be found in our GitHub account.

  • NDA AWS Token Generator contains Bash and Python scripts for obtaining AWS authentication tokens.
  • Brainhack 2017 is a Jupyter Notebook that demonstrates how to access data from a specific GUID, and how to download any associated files from S3 Object storage.
  • Data Staging Services is a Jupyter Notebook that demonstrates how to POST data directly into a miNDAR, and how to upload data to scratch space in S3.


Service Name


Response Formats

Data Dictionary

Provides metadata about all of the measures (data structures) available within the NDA Data Dictionary; including details on the data elements that make up each data structure.


This service does not require authentication.



Provides metadata on all fMRI, Eye Tracking, and EEG experiments that have been defined by researchers submitting those data for sharing in NDA.


This service does not require authentication.



NDA search uses this service to provide search across the entire platform.

Provides the ability to query publicly available content across all of NDA, including Studies, Collections, the Data Dictionary, experiments, and web pages.


This service also supports custom Elasticsearch queries against the same search index.


This service does not require authentication.




Provides a list of all data structures (organized by type) for which the provided GUID has data shared, with an additional operation to retrieve all data for the GUID that the user has access to.


Requires HTTP basic authentication.



Provides a RESTful interface for depositing data into a miNDAR.  Data deposited in this manner can be validated and submitted via the validation client.  Future API services will support validation, packaging, and submission of data from a miNDAR.


Additional operations are being added to this service to support listing and retrieval of data from the miNDAR.


Requires HTTP basic authentication.