List Grants.gov Reference Codes
grantsgov_list_referenceRead-onlyIdempotent
List the codes Grants.gov search filters accept, with labels and live opportunity counts: agencies (top level, or one agency's sub-agencies via parent_code, or matched by name via name_contains), applicant eligibility types, funding categories, funding instruments, statuses, sort options, and keyword syntax. Use the codes as grantsgov_search_opportunities inputs.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic | Yes | Which list to return: agencies (agency codes), eligibilities (two-digit applicant-type codes), funding_categories, funding_instruments, statuses, sort_options, or keyword_syntax. | |
| parent_code | No | Agencies only: list every code under this agency at any depth (e.g. HHS, DOD-DARPA). Case-insensitive. Omit for the top-level list. | |
| name_contains | No | Keep only entries whose label or code contains every word given, ignoring case, accents, and punctuation (e.g. "national science", "nih"). For agencies this searches every code, top-level and sub-agency. Works with every topic. A value with no letters or digits matches nothing. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| topic | No | The topic listed. | |
| notice | No | Guidance when name_contains matched nothing, or when parent_code has no sub-agencies. | |
| entries | No | Reference entries. | |
| totalCount | No | Entries returned. | |
| snapshot_date | No | When the live vocabulary was fetched (ISO timestamp); absent for fully static topics. |