Applicant Versions & WSDLs

Applicant S2S Version Matrix

The supported System to System (S2S) versions are:

  • V0 - Deployed in 2006
  • V1 - Deployed in 2010
  • V2.0 - Deployed with Release 12.0 in August 2012 (Recommended version)

The table below lists the web services that are supported in each version of the Applicant System to System (S2S) web services library.

Feature Web Service Name End-Point Compatibility V0 End-Point Compatibility V1 End-Point Compatibility V2.0 Comments
Authenticate AOR AuthenticateAOR - Yes Yes  
Get Application Info GetApplicationInfo - Yes Yes  
Get Application List GetApplicationList Yes Yes Yes  
Get Application Status GetApplicationStatusDetail Yes Yes Yes  
Get Opportunities GetOpportunities - Yes Yes  
Get Opportunities With Info GetOpportunitiesWithInfo Yes Yes - Replaced by GetOpportunities Web Service
Get Opportunity List GetOpportunityList Yes Yes - Replaced by GetOpportunities Web Service
Submit Application SubmitApplication Yes Yes Yes V0 supports single project submissions;
V1 and V2.0 support single- and multi-project submissions;
V2.0 also supports large submissions
Submit Application As Third Party SubmitApplicationAsThirdParty - Yes Yes Note: V2.0 supports large submissions
Get Application List As Third Party GetApplicationListAsThirdParty - - Yes For NIH ASSIST Multi-project only
Get Application Info As Third Party GetApplicationInfoAsThirdParty - - Yes For NIH ASSIST Multi-project only

Applicants can use any S2S version to submit applications regardless of which version the agencies use to retrieve the applications. The only constraint is large application submissions (e.g. exceeding 200 megabytes). If V2.0 is used by the Applicant to submit large applications, the Agencies will need to use V2.0 to retrieve the applications through S2S. Alternatively, the agencies can retrieve the large applications using the online user interface.

Web services versions have no impact on the form versions used. Any version of the forms can be submitted and retrieved by any S2S version.

WSDLs 

Version 0 (V0)

The following is the URL which is needed in the XML for the V0 web service endpoint for the Training Environment:
https://at07ws.grants.gov:446/app-s2s-server/services/ApplicantIntegrationSoapPort

The following is the URL which is needed in the XML for the V0 web service endpoint for the Production Environment:
https://ws07.grants.gov:446/app-s2s-server/services/ApplicantIntegrationSoapPort

Version 1 (V1)

V1 changed from the Axis 1.* web service framework to the JAX-WS framework. This laid the foundation for the transition to Message Transmission Optimization Mechanism (MTOM) in V2.0.

The Training Environment end point and WSDL for the Applicant Web Service Library V1 is located at:
https://at07ws.grants.gov:446/grantsws-applicant/services/ApplicantIntegrationSoapPort

The Production Environment end point and WSDL for the Applicant Web Service Library V1 is located at:
https://ws07.grants.gov:446/grantsws-applicant/services/ApplicantIntegrationSoapPort

Version 2.0 (V2.0)

V2.0 is the latest library of web services. It uses Message Transmission Optimization Mechanism (MTOM) to support streaming of large submissions.

The Training Environment end point and WSDL information for the Applicant Web Service Library V2.0 is located at:
https://at07ws.grants.gov:446/grantsws-applicant/services/v2/ApplicantWebServicesSoapPort

The Production Environment end point and WSDL information for the Applicant Web Service Library V2.0 is located at:
https://ws07.grants.gov:446/grantsws-applicant/services/v2/ApplicantWebServicesSoapPort

Other S2S Resources

The following is the URL for the Grant Application Meta Data in Grants.gov.

Training Environment:
https://at07apply.grants.gov/apply/system/MetaGrantApplication
https://at07apply.grants.gov/apply/system/MetaMultiGrantApplication

Production Environment:
https://apply07.grants.gov/apply/system/MetaGrantApplication
https://apply07.grants.gov/apply/system/MetaMultiGrantApplication