U.S. Department of Health and Human Services
National Institutes of Health
eRA IntranetNIH offers a variety of web services related to NIH application submission and grant data. Following are some of the most popular services eRA provides to the external community
- Submission Validation Service (SVS) to do pre-submission validation checks of single and multi-project applications
- A service to return a preview of the application image in the format used by NIH (SIL)
- Machine readable Notice of Award (NoA) system to system interface
Technical Documentation
- Web Services Certificate Guide (PDF - 439 IB) (March 2023)
- S2S Client Transaction Guide (PDF – 790 KB) (August 2022)
Accessing NIH Web Services
To request a new certificate account, the Signing Official at the organization of a user requesting this account will need to utilize eRA’s Account Management System (AMS) via the Admin tab in eRA Commons. Please follow instructions in the ‘Create Account’ topic in the Account Management System (AMS) online help. Users will also now have the ability to validate a certificate via the AMS system by following instruction under the ‘Validate Certificate’ section of this user guide.
It is the responsibility of the organization to update certificate accounts via the AMS system if the certificate account expires or changes in any way. NIH recommends users of AMS to take this action at least 5 days in advance of the expiration of certificate accounts to ensure you do not experience a lapse in service.
Please note, eRA does NOT support wild card or self-signed certificates.
| Service | Service URL | WSDL/YAML* (Certificate Required) |
|---|---|---|
| Submission Agency Data Service (SADS) | https://services.external.uat.era.nih.gov/ eraexchange/services/SubmissionAgencyDataService |
https://services.external.uat.era.nih.gov/ eraexchange/services/SubmissionAgencyDataService?wsdl |
| Submission Validation Service (SVS) | https://services.external.uat.era.nih.gov/ svs/services/SubmissionValidationService |
https://services.external.uat.era.nih.gov/ svs/services/SubmissionValidationService?wsdl |
| Submission Image Service (SIL) | https://services.external.uat.era.nih.gov/ sil/services/V2/SubmissionImageService |
https://services.external.uat.era.nih.gov/ sil/services/V2/SubmissionImageService?wsdl |
| NoA Retrieval Service |
https://services.external.uat.era.nih.gov/gmws/dataservices/noa |
https://services.external.uat.era.nih.gov/gmws/swagger/noa.yaml |
Access the Web Service Description Language (WSDL) or YAML at the URLs below. The WSDL/YAML can be used by various tools to generate the web service client stubs.
| Service | Service URL | WSDL/YAML* (Certificate Required) |
|---|---|---|
| Submission Agency Data Service (SADS) | https://services.external.era.nih.gov/eraexchange/services/SubmissionAgencyDataService | https://services.external.era.nih.gov/ eraexchange/services/SubmissionAgencyDataService?wsdl |
| Submission Validation Service (SVS) | https://services.external.era.nih.gov/svs/services/SubmissionValidationService | https://services.external.era.nih.gov/ svs/services/SubmissionValidationService?wsdl |
| Submission Image Service (SIL) | https://services.external.era.nih.gov/sil/services/V2/SubmissionImageService | https://services.external.era.nih.gov/ sil/services/V2/SubmissionImageService?wsdl |
| NoA Retrieval Service | https://services.external.era.nih.gov/gmws/dataservices/noa | https://services.external.era.nih.gov/gmws/swagger/noa.yaml |
* If you copy/paste these links, watch out for an extra space where the line break occurs for the links in these tables. Directly following the links in the tables and right-clicking then using the "Copy link address" feature both work without any link adjustments.