Help Page Content
XML Extract
Once a day, the Grants.gov database of grants is exported to an XML file. This is a very large text file, so the XML file is compressed into a zip file to improve download speeds. The schema for the XML is also located within the zip file.
The files are named: "GrantsDBExtractYYYYMMDD.zip"
YYYY is the four-digit year
MM is the two-digit month
DD is the two-digit day of the month
Files with "v2" at the end of the filename are the enhanced XML format that includes grant forecast information.
Informative status
Note: This XML extract service is primarily used by power users and database owners.
Field |
Maximum Field Size |
Field Values and Notes |
|
Opportunity Title |
255 characters |
|
|
Opportunity ID |
20 characters |
|
|
Opportunity Number |
40 characters |
|
|
Opportunity Category |
1 character |
D = Discretionary M = Mandatory C = Continuation E = Earmark O = Other |
|
Opportunity Category Explanation |
255 characters |
|
|
Funding Instrument Type |
2 characters |
Always has a coded value. The following list identifies the meaning of the coded values for the Funding Instrument Type data element. G = Grant CA = Cooperative Agreement O = Other PC = Procurement Contract |
|
Category of Funding Activity |
3 characters |
Always has a coded value. The following list identifies the meaning of the coded values for the Category of Funding Activity data element. ACA = Affordable Care Act AG = Agriculture AR = Arts (see "Cultural Affairs" in CFDA) BC = Business and Commerce CD = Community Development CP = Consumer Protection DPR = Disaster Prevention and Relief ED = Education ELT = Employment, Labor and Training EN = Energy ENV = Environment FN = Food and Nutrition HL = Health HO = Housing HU = Humanities (see "Cultural Affairs" in CFDA) ISS = Income Security and Social Services IS = Information and Statistics LJL = Law, Justice and Legal Services NR = Natural Resources RA = Recovery Act RD = Regional Development ST = Science and Technology and other Research and Development T = Transportation O = Other (see text field entitled "Explanation of Other Category of Funding Activity" for clarification) |
|
Category Explanation |
4000 characters |
|
|
CFDA Number(s) |
6 characters |
Either ##.### where # is a number or has a value of “00.0000” |
|
Eligible Applicants |
2 characters |
Always has a coded value. The following list identifies the meaning of the coded values for the Eligible Applicants data element. 99 = Unrestricted (i.e., open to any type of entity below), subject to any clarification in text field entitled “Additional Information on Eligibility” Government codes: 00 = State governments 01 = County governments 02 = City or township governments 04 = Special district governments 05 = Independent school districts 06 = Public and State controlled institutions of higher education 07 = Native American tribal governments (Federally recognized) 08 = Public housing authorities/Indian housing authorities Non-Government organizations: 11 = Native American tribal organizations (other than Federally recognized tribal governments) 12 = Nonprofits having a 501 (c) (3) status with the IRS, other than institutions of higher education 13 = Nonprofits that do not have a 501 (c) (3) status with the IRS, other than institutions of higher education 20 = Private institutions of higher education 21 = Individuals 22 = For-profit organizations other than small businesses 23 = Small businesses 25 = Others (see text field entitled “Additional Information on Eligibility” for clarification.) |
|
Additional Information on Eligibility |
4000 characters |
|
|
Agency Code |
255 characters |
|
|
Agency Name |
255 characters |
|
|
Post Date |
8 characters |
Format: MMDDYYYY |
|
Close Date |
8 characters |
Only appears in a Forecast Format: MMDDYYYY |
|
Close Date Explanation |
4000 characters |
Only appears in a Forecast |
|
Expected Number of Awards |
15 characters |
|
|
Estimated Total Program Funding |
15 characters |
|
|
Award Ceiling |
15 characters |
|
|
Award Floor |
15 characters |
|
|
Last Updated Date or Created Date |
8 characters |
If the opportunity has never been updated, Created Date will appear. Format: MMDDYYYY |
|
Estimated Synopsis Post Date |
8 characters |
Only appears in a Forecast Format: MMDDYYYY |
|
Fiscal Year |
4 characters |
Only appears in a Forecast |
|
Estimated Synopsis Close Date |
8 characters |
Only appears in a Forecast Format: MMDDYYYY |
|
Estimated Synopsis Close Date Explanation |
255 characters |
Only appears in a Forecast Format: MMDDYYYY |
|
Estimated Award Date |
8 characters |
Only appears in a Forecast Format: MMDDYYYY |
|
Estimated Project Start Date |
8 characters |
Only appears in a Forecast |
|
Archive Date |
8 characters |
Format: MMDDYYYY |
|
Description |
18,000 characters |
|
|
Cost Sharing or Matching Requirement |
3 characters |
Yes/No |
|
Additional Information Text |
250 characters |
|
|
Additional Information URL |
250 characters |
|
|
Grantor Contact Text |
2500 characters |
|
|
Grantor Contact Email Description |
102 characters |
|
|
Grantor Contact Email |
130 characters |
|
|
Grantor Contact Name |
2500 characters |
Only appears in a Forecast |
|
Grantor Contact Phone Number |
100 characters |
Only appears in a Forecast |
|
Version |
20 characters |
"Forecast X" or "Synopsis X", where "X" is the version number |