Grants Data Dictionary¶

This document describes the fields available in the Grants API endpoints (/api/grants/). For filtering, ordering, and pagination, see the Grants API Reference.

Overview¶

Grants are grant opportunities from Grants.gov. Each record is a funding opportunity with grant_id as the primary identifier. Data is sourced from Grants.gov.

Note: The full set of fields is available via the shape query parameter. See Response Shaping for details.

Update Frequency¶

Grant opportunity data is refreshed from Grants.gov on a regular sync cadence.

Fields¶

Field	Type	Description	Source
`grant_id`	String	Unique identifier for the grant opportunity (Grants.gov).	Grants.gov
`opportunity_number`	String	Opportunity number.	Grants.gov
`agency_code`	String	Funding agency code.	Grants.gov
`status`	Object	Opportunity status. Use expansion for `code`, `description`.	Grants.gov
`title`	String	Grant title.	Grants.gov
`description`	String	Grant description.	Grants.gov
`last_updated`	DateTime	Last updated timestamp.	Grants.gov
`applicant_eligibility_description`	String	Who may apply.	Grants.gov
`funding_activity_category_description`	String	Funding activity category.	Grants.gov
`grantor_contact`	Object	Grantor contact info (expand for subfields).	Grants.gov
`forecast`	Object	Forecast data associated with the grant, if any.	Grants.gov
`synopsis`	Object	Synopsis data for the grant opportunity.	Grants.gov
`opportunity_history`	Array	History of changes to the opportunity.	Grants.gov

Common code values¶

These are the most important “code → meaning” mappings used in grants data (see src/grants/lib/maps.py).

`status`¶

Code	Meaning
`P`	Posted
`F`	Forecasted

`category`¶

Code	Meaning
`A`	Mandatory
`B`	Continuation
`C`	Earmark
`D`	Discretionary
`E`	Discretionary Cooperative Agreement
`O`	Other

`funding_instruments` (examples)¶

Code	Meaning
`G`	Grant
`CA`	Cooperative Agreement
`PC`	Procurement Contract
`L`	Loan Guarantee
`D`	Direct Payment
`O`	Other

applicant_types and funding_categories are also coded lists (Grants.gov standard taxonomies); the canonical enumerations are large and are best treated as reference data rather than memorized.

Expansions (via `shape`)¶

cfda_numbers – List of CFDA numbers: number, title
applicant_types – code, description
category – code, description
funding_categories – code, description
funding_instruments – code, description
important_dates – posted_date, response_date, response_date_description, estimated_synopsis_post_date, estimated_application_response_date, estimated_application_response_date_description, estimated_project_start_date (fields vary by opportunity status)
funding_details – award_ceiling, award_floor, estimated_total_funding, expected_number_of_awards
grantor_contact – name, phone, email
additional_info – link, description
attachments – mime_type, name, posted_date, resource_id, type, url

Data Sources¶

Grants.gov – Grant opportunities, CFDA linkage, contacts, attachments.

Usage Notes¶

Default shaping – Grants now default to the shaping pipeline. All responses render through shaping even without ?shape=. The list shape includes core fields; the detail shape adds all expanded objects.
Use grant_id for lookups. Filter by agency, status, or other params; see Grants API Reference.

Report an issue with this page