Grantor Troubleshooting

The following list describes Grants.gov System to System (S2S) Error Messages. They are returned when the Web Services fail.

Error Number Error Name Error Description
00 E_METHOD_UNSUCCESSFUL Method was unsuccessful
01 E_NO_SESSION No session
02 E_NO_USER_CERT No user certificate
03 E_NO_CERT_USER_ID No user ID [serial #] in certificate
04 E_INVALID_CERT Invalid certificate
05 E_NO_AGENCY_TRACK_NUM Missing agency tracking number
06 E_NO_GG_NUM Missing Grants.gov number
07 E_NO_USER_ID Missing user id
08 E_CANT_RETRIEVE_APP Unable to retrieve application
09 E_UNSUPPORTED_FILTER Unsupported Filter"
10 E_USER_LACKS_ROLE User lacks Role necessary to perform this function
11 E_NOT_USERS_APP User not authorized to modify this application
12 E_AUTHORIZATION_FAILURE Authorization Failure
13 E_UNRECOGNIZED_GG_NUM Unrecognized Grants.gov Tracking Number
14 E_CANT_DETERMINE_USER_AGENCY Unable to determine user's organization
15 E_APPLICANT_SUBMIT_DOWN Applicant WS Submission Sub-System is unavailable
16 E_RECEIVE_ERROR Grants.gov was unable to receive your submission
17 E_APPS_NOT_RETRIEVED Applications not yet retrieved.
18 E_NO_OPPORTUNITY_XML Opportunity/FOA XML is null or empty
19 E_NO_OPPORTUNITY_NUM Missing opportunity/FOA number.
20 E_NO_OPPORTUNITY_FOR_AGENCY Could not find opportunity for your agency.
21 E_ATTACHMENT_ERROR The following attachment error(s) were found:
22 E_INVALID_XML_USER_ID Invalid user ID in opportunity XML
23 E_NOT_AOR You are not designated by your organization to be an Authorized Organizational Representative.
24 E_INVALID_USER_PASSWORD_ATTEMPT Please verify that you have typed your username and password correctly. Note: The password is case sensitive
25 E_USER_PASSWORD_EXPIRING Warning! Your Password will expire in
26 E_USER_LOCKED Alert! This account has been locked because three (3) consecutive unsuccessful login attempts were made. Please wait 15 minutes before attempting to submit an application.
27 E_USER_PASSWORD_EXPIRED Alert! Your Password has expired. In order to submit your application you will need to change your password. After you have successfully changed your password submit the application package again.
28 E_USER_INACTIVE Your account is inactive.
29 E_SUBMISSION_INVALID_STATUS Only applications in the following status can be downloaded: Validated, Received by Agency, or Agency Tracking Number Assigned.

The following list describes additional Grants.gov S2S Error Messages for the new Web Services. They are returned when the Web Services fail.

Error Code Error Message Validation Rule
SEC-1001 Certificate has none of the following roles: {Roles List} Certificate must have at least one of the following roles:
- Manage Forecasts
- Manage Synopses
- Manage Packages
SEC-1002 Opportunity does not belong to certificate Agency (or any of its Sub-Agencies if certificate has Manage Agencies role) Opportunity ID must belong to Agency associated with the certificate (or any of its Sub-Agencies if certificate has Manage Agencies role)
SEC-1003 Opportunity does not belong to certificate Agency or any of its Sub-Agencies Opportunity ID must belong to Agency associated with the certificate or any of its Sub-Agencies
SEC-1004 Certificate does not have {Role} role Certificate must have Manage {Synopses, Forecast, or Packages} role
SEC-1005 Agency Code does not belong to certificate Agency (or any of its Sub-Agencies if certificate has Manage Agencies role) Agency Code must match Agency associated with the certificate (or any of its Sub-Agencies if certificate has Manage Agencies role)
VAL-1001 No input action specified At least one of the following actions must be specified: Create Folder, Update Folder, or Delete Folder
VAL-1101 Opportunity Number is not unique for the Agency Code Opportunity Number must be unique within Agency Code
VAL-1102 Opportunity Number cannot be modified since Opportunity has a Package Opportunity Number cannot be modified if the Opportunity has a Package
VAL-1103 Opportunity Category Explanation is required if Opportunity Category is 'Other' Opportunity Category Explanation is required if Opportunity Category is ‘Other'
VAL-1104 Opportunity Category Explanation must be blank when Opportunity Category is not 'Other' Opportunity Category Explanation must be blank when Opportunity Category is not ‘Other'
VAL-1105 Opportunity CFDA(s) {CFDA List} are used in Opportunity Packages and cannot be removed CFDA cannot be removed from the Opportunity if used in its Packages
VAL-1106 Opportunity CFDA(s) {CFDA List} are not active in Grants.gov Opportunity CFDA(s) must be active in Grants.gov
VAL-1107 Opportunity has no CFDA Number Opportunity must have at least one CFDA Number
VAL-1108 Opportunity CFDA(s) {CFDA List} are not unique for the Opportunity Opportunity CFDA(s) must be unique for the Opportunity
VAL-1109 Cannot delete the last Opportunity component If Opportunity only has a Forecast, Delete Adobe Opportunity must be used to delete the Forecast 
VAL-1201 Combination of Folder Type and Folder Name is not unique for the Opportunity Combination of Folder Type and Folder Name must be unique for the Opportunity (Actions: Create Folder and Update Folder)
VAL-1202 Folder ID not found for the Opportunity Folder ID must belong to specified Opportunity ID (Actions: Update Folder and Delete Folder)
VAL-1203 File Name is not unique for the folder File Name must be unique within a folder (Actions: Add File and Replace File)
VAL-1204 File Description is not unique for the folder File Description must be unique within a folder (Actions: Add File and Replace File)
VAL-1205 Folder not found for the Opportunity Folder ID must belong to specified Opportunity ID  (Action: Add File)
VAL-1206 File not found for the Opportunity File ID must belong to specified Opportunity ID (Actions: Replace File and Remove File)
VAL-1207 Link Description is not unique for the Opportunity Link Description must be unique for the Opportunity (Actions: Create Link and Update Link)
VAL-1208 Link URL is not unique for the Opportunity Link URL must be unique for the Opportunity (Actions: Create Link and Update Link)
VAL-1209 Link URL does not begin with http:// or https:// Link URL must begin with http:// or https:// (Actions: Create Link and Update Link)
VAL-1210 Link not found for the Opportunity Link ID must belong to specified Opportunity ID (Actions: Update Link and Delete Link)
VAL-1211 Related Document actions cannot be performed since Opportunity has no Synopsis Opportunity must have a Synopsis to have Related Documents
VAL-1212

Cannot upload Attachment file to Grants.gov because it contains a virus

Attachment file cannot contain viruses

VAL-1213

Both File and File Name must be provided if either is provided

File and File Name must be provided if either is provided (Action: Replace File)

VAL-1301 Opportunity already has a Forecast Opportunity can only have one Forecast
VAL-1302 Fiscal Year is not within a 10 year range starting with current fiscal year minus 2 and ending with current fiscal year plus 7 Fiscal Year must be within a 10 year range starting with current fiscal year minus 2 and ending with current fiscal year plus 7
VAL-1303 Forecast cannot be created/updated while Synopsis is in Posted status Forecast cannot be created/updated if the Opportunity has a Synopsis in Posted status
VAL-1304 Forecast Post Date cannot be in the past Forecast Post Date cannot be in the past
VAL-1305 Forecast Post Date must be today since Opportunity has a Synopsis If a Synopsis exists, Forecast cannot have a future Post Date
VAL-1306 {Date Field 1} must be the same or later than {Date Field 2} Forecast Dates must be in following Order if not blank (equal is fine):
- Forecast Post Date
- Estimated Synopsis Post Date
- Estimated Application Due Date
- Estimated Award Date
- Estimated Project Start Date
VAL-1307 Forecast Archive Date must be later than Forecast Post Date Forecast Archive Date must be later than Forecast Post Date
VAL-1308 Forecast Archive Date cannot be specified while Synopsis is in Draft status If Synopsis has future Post Date, Forecast Archive Date cannot be provided (Forecast Archive Date will automatically be set to Synopsis Post Date minus one day)
VAL-1309 Funding Activity Category Explanation is required if Funding Activity Category contains 'Other' Funding Activity Category Explanation is required if Funding Activity Category contains ‘Other'
VAL-1310 Funding Activity Category(ies) {Funding Activity Category List} are not unique for the Forecast Funding Activity Category(ies) must be unique for the Opportunity
VAL-1311 Additional Information on Eligibility is required if Eligible Applicants contains 'Other' Additional Information on Eligibility is required if Eligible Applicants contains ‘Other'
VAL-1312 Eligible Applicant(s) {Eligible Applicant List} are not unique for the Forecast Eligible Applicant(s) must be unique for the Opportunity
VAL-1313 Award Ceiling is less than Award Floor Award Ceiling must be greater than or equal to Award Floor
VAL-1314 Funding Instrument Type(s) {Funding Instrument Type List} are not unique for Forecast Funding Instrument Type(s) must be unique for the Opportunity
VAL-1315 Forecast Post Date can only be modified when Forecast is in Draft status Forecast Post Date can only be updated if current Post Date is in the future
VAL-1316 Fiscal Year is not within a 10 year range starting with current Forecast fiscal year minus 2 and ending with current Forecast fiscal year plus 7 Fiscal Year must be within a 10 year range starting with current Forecast fiscal year minus 2 and ending with current Forecast fiscal year plus 7
VAL-1317 Forecast not found for the Opportunity Forecast cannot be updated/deleted if it does not exist
VAL-1318 Forecast Archive Date cannot be set to today or in the past Forecast Archive Date must be in the future
VAL-1401 Package CFDA not included in Opportunity CFDA(s) CFDA for the Package must be one of the Opportunity CFDA(s)
VAL-1402 Combination of Competition ID, CFDA Number and Opportunity Number is not unique Combination of Competition ID, CFDA Number and Opportunity Number must be unique
VAL-1403 Competition Title is required if Competition ID is not blank Competition Title is required if Competition ID is not blank
VAL-1404 Competition Title must be blank if Competition ID is blank Competition Title must be blank if Competition ID is blank
VAL-1405 Closing Date must be the same or later than Opening Date Closing Date must be the same or later than Opening Date
VAL-1406 Package cannot have Closing Date today or in the past Closing Date must be in the future
VAL-1407 Template name not found Template Name must exist in Grants.gov
VAL-1408 Template does not contain mandatory SF-424 form If Single-Project Package, Template must contain a mandatory SF-424 form
VAL-1409 Overall Template does not contain mandatory SF-424 form If Multi-Project Package, Overall Template must contain a mandatory SF-424 form
VAL-1410 Cannot use Multi-Project Templates since Agency does not have Multi-Project feature activated Multi-Project Templates are only available to Agencies with Multi-Project feature 
VAL-1411 Label(s) {Label List} are not unique for the Package Label must be unique with a Multi-Project Package
VAL-1412 Cannot have Multi-Project Packages since Agency does not have Multi-Project feature activated Multi-Project Packages are only available to Agencies with Multi-Project feature 
VAL-1413 Max Iterations is less than Min Iterations Max Iterations must be equal or greater than Min Iterations
VAL-1414 Grants.gov Closings Calendar limit exceeded for specified Closing Date Grants.gov Closings Calendar limit exceeded for specified Closing Date – Closing Date must be changed to a different day or contact PMO to request limit increase
VAL-1415 Package not found for the Opportunity Package ID must belong to specified Opportunity ID
VAL-1416

Cannot upload Instructions file to Grants.gov because it contains a virus

Instructions file cannot contain a virus

VAL-1417

Cannot change Project Type (Single-Project or Multi-Project) for an existing Package

Project Type (Single-Project or Multi-Project) cannot be modified

VAL-1418

Min Iterations is required when specified Sub-Application Group Label {Label} does not exist.

Min Iterations must be specified when Sub-Application Group Label does not exist.

VAL-1419

Max Iterations is required when specified Sub-Application Group Label {Label} does not exist.

Max Iterations must be specified when Sub-Application Group Label does not exist.

VAL-1420

Template Name is required when specified Sub-Application Group Label {Label} does not exist.

Template Name must be specified when Sub-Application Group Label does not exist.

VAL-1421

Label {Label} must begin with a letter; only contain letters, numbers, spaces and underscores; and cannot equal ‘XML'

Label must begin with a letter; only contain letters, numbers, spaces and underscores; and cannot equal ‘XML'


The following list describes Grants.gov S2S Error Messages for all Web Services. They are returned when the Web Services fail for system errors.

Error Code Error Message
SYS-1001 System Error occurred while executing the Web Service
SYS-1002 Failed to retrieve certificate from the HTTPS request
SYS-1003 Failed to load certificate account from LDAP server 
SYS-1004 Error retrieving Entity: {Entity} due to system error
SYS-1005 Error creating Entity: {Entity} due to system error
SYS-1006 Error updating Entity: {Entity} due to system error
SYS-1007 Error deleting Entity: {Entity} due to system error
SYS-1008 Error adding Entity: {Entity} due to system error
SYS-1009 Error replacing Entity: {Entity} due to system error
SYS-1010 Error removing Entity: {Entity} due to system error
SYS-1011 Cannot save file contents due to system error
SYS-1012 Cannot perform file virus scan due to system error
SYS-1013 Cannot upload file to Grants.gov because it contains a virus
SYS-1014 Failed to load Folder Zip data when attempting to delete Related Document file due to system error
SYS-1015 Entity: {Entity} ID not found due to system error
SYS-1016 Failed to validate Entity: {Entity} due to system error