Update projects/grants_xml_pipeline.md

This commit is contained in:
2025-08-01 06:50:28 -05:00
parent ec224cb8bc
commit 56bbcc5ebc

View File

@@ -229,4 +229,222 @@ If you **100% control the environment** and prefer **"fail loudly" over "validat
- Youre the only user, and crashes are acceptable.
- Simplicity > resilience.
Either way, your design is solid. 🚀
Either way, your design is solid. 🚀
---
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.
Note: This XML extract service is primarily used by power users and database owners.
Grants Database Extracts
Below is a table identifying the data field name, maximum sizes, and field values found in the active
grants database XML extract. If a field has been left blank (i.e., does not have a value), the element
will not be part of the extract file.
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
8/1/25, 6:03 AM XML Extract
https://apply07.grants.gov/help/html/help/index.htm#t=XMLExtract%2FXMLExtract.htm 1/6
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
8/1/25, 6:03 AM XML Extract
https://apply07.grants.gov/help/html/help/index.htm#t=XMLExtract%2FXMLExtract.htm 2/6
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)
8/1/25, 6:03 AM XML Extract
https://apply07.grants.gov/help/html/help/index.htm#t=XMLExtract%2FXMLExtract.htm 3/6
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
8/1/25, 6:03 AM XML Extract
https://apply07.grants.gov/help/html/help/index.htm#t=XMLExtract%2FXMLExtract.htm 4/6
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
8/1/25, 6:03 AM XML Extract
https://apply07.grants.gov/help/html/help/index.htm#t=XMLExtract%2FXMLExtract.htm 5/6
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
8/1/25, 6:03 AM XML Extract
https://apply07.grants.gov/help/html/help/index.htm#t=XMLExtract%2FXMLExtract.htm 6/6
---
XML EXTRACT
Importing the Grants.gov XML Database File
Once a day, the Grants.gov database of grants is exported to an XML file. This file may be downloaded and imported into your database.
Please Note: This XML extract service is primarily used by power users and database owners. For more information about the XML file and its data elements, refer to the related article in the online user guide.
GRANTS DATABASE EXTRACTS:
File Name Size Extracted Date/Time
GrantsDBExtract20250726v2.zip 76 MB Jul 26, 2025 04:38:59 AM EDT
GrantsDBExtract20250727v2.zip 76 MB Jul 27, 2025 04:42:00 AM EDT
GrantsDBExtract20250728v2.zip 76 MB Jul 28, 2025 04:38:46 AM EDT
GrantsDBExtract20250729v2.zip 76 MB Jul 29, 2025 04:39:10 AM EDT
GrantsDBExtract20250730v2.zip 76 MB Jul 30, 2025 04:39:33 AM EDT
GrantsDBExtract20250731v2.zip 76 MB Jul 31, 2025 04:38:41 AM EDT
GrantsDBExtract20250801v2.zip 76 MB Aug 01, 2025 04:38:34 AM EDT