Grantor Versions & WSDLs

Grantor 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 Agency 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
Assign Agency Tracking Number AssignAgencyTrackingNumber yes yes yes  
Confirm Application Delivery ConfirmApplicationDelivery yes yes yes  
Create Opportunity CreateAdobeOpportunity - - yes  
Delete Opportunity DeleteAdobeOpportunity - yes yes  
Delete Synopsis DeleteAdobeSynopsis yes yes yes  
Get Application GetApplication yes yes yes V2.0 supports large submissions
Get Application List GetApplicationList yes yes yes  
Get Application ZIP GetApplicationZip yes yes yes V2.0 supports large submissions
Manage Single Project Package ManagePackage - yes yes Grants.gov web interface supports Multi-project packages
Save Opportunity For V0 and V1: SaveAdobeOpportunity
For V2.0: CreateAdobeOpportunity or UpdateAdobeOpportunity
yes yes - For V2.0, this functionality was replaced with Create and Update Opportunity.
Update Opportunity UpdateAdobeOpportunity - - yes  
Update Application Info UpdateApplicationInfo - yes yes  

 

Agencies can use any S2S version to retrieve applications regardless of which version the applicants used to submit 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/agency-s2s-server/services/AgencyIntegrationSoapPort

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/agency-s2s-server/services/AgencyIntegrationSoapPort

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 Agency Web Service Library V1 is located at:
https://at07ws.grants.gov:446/grantsws-agency/services/AgencyIntegrationSoapPort

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

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 Agency Web Service Library V2.0 is located at:
https://at07ws.grants.gov:446/grantsws-agency/services/v2/AgencyWebServicesSoapPort

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

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