v1

latestOpenAPI 3.0.12026-07-2427125325.2 KB
List

Search for grant activity based on the criteria specified. Returns a maximum of 25 results.

get/transactions

Query parameters

querystring

The keyword to search for.

locationinteger

The Geoname ID for the location to search. For example, the Geonameid '6252001' searches for 'United States'.

geo_id_type'geonameid'

The geo ID type for the location parameter to search on. Only supported geo ID type is geonameid.

location_type'funder' | 'recipient' | 'area_served'

Select how the location parameter is applied for search results. "funder" represents the location of the funder, "recipient" represents the location of the recipient, and "area_served" represents the location where the funding was used.

yearinteger[]

Select the year a grant was awarded to search on. Multiple years can be selected through a comma separated list. Values are in YYYY format (e.g. 2006).

[
  2006
]
subjectstring[]

The subject code to search on. For example, the subject code 'SD' searches for 'Philanthropy'. Multiple subject codes can be selected by passing a comma separated list without spaces. Remove any trailing zeros from the end of the PCS code.

[
  "SD"
]
populationstring[]

The population code to search on. For example, the population code 'PA' searches for 'Age groups'. Multiple population codes can be selected by passing a comma separated list without spaces. Remove any trailing zeros from the end of the PCS code.

[
  "PA"
]
supportstring[]

tThe support stragey code to search on. For example, the support strategy code 'UA' searches for 'Program support'. Multiple support strategy codes can be selected by passing a comma separated list without spaces. Remove any trailing zeros from the end of the PCS code.

[
  "UN"
]
transactionstring[]

The transaction code to search on. For example, the transaction code 'TA' searches for 'Cash grants'. Multiple transaction codes can be selected by passing a comma separated list without spaces. Remove any trailing zeros from the end of the PCS code.

[
  "TA"
]
recip_idstring[]

The recipient key to search on. For example, the recip ID '839229' searches for 'William and Flora Hewlett Foundation'. Multiple recipient keys can be selected by passing a comma separated list. This parameter also accepts EIN, but only in conjunction with the id_type parameter.

funder_idstring[]

The funder key to search on. For example, the funder ID 'GATE023' searches for 'Bill & Melinda Gates Foundation'. Multiple funder keys can be selected by passing a comma separated list. This parameter also accepts EIN, but only in conjunction with the id_type parameter.

[
  "GATE023"
]
id_type'ein'

Select the id_type when looking up the recipient or funder by their EIN; accepts 'EIN' in 123456789 format. Do not specify this parameter when using the recipient or funder key.

include_gov'yes' | 'no'

Select if U.S. Government grantmakers should be listed in the search results.

min_amtinteger

Minimum dollar amount (in USD) of grants to consider for search results

max_amtinteger
Example:44000000

Maximum dollar amount (in USD) of grants to consider for search results

sort_by'funder_name' | 'recip_name' | 'year_issued' | 'amount' | 'count'

Value by which to sort the list results

last_updatedstring date
Example:2016-04-08

Select the records for search results by the added or updated date. The list will include everything on or after the date specified (format yyyy-mm-dd, e.g. 2020-01-01).

sort_order'asc' | 'desc'

The order to sort the search results one of “asc” or “desc”.

pageinteger
Example:1

Select the page number for search results. If page is not specified, it defaults to 1. The maximum page value is 100.

format'json' | 'xml'

Defines the format of the response.

profile_levelsstring
Example:silver

Comma seperated list of GS seal levels to search for.

Response

Array of the grants' funder, recipient, grant amount and grant description that match the criteria searched.

Example response

{
  "meta": {
    "code": 200,
    "status": "OK",
    "elapsed_time": "0:00:00.330293",
    "time": "2021-10-19 19:58:48.322882"
  },
  "data": {
    "total_hits": 150000,
    "num_pages": 5000,
    "rows": [
      {
        "funder_key": "GATE023",
        "funder_profile_url": "https://fconline.foundationcenter.org/fdo-grantmaker-profile?key=GATE023",
        "funder_name": "Bill & Melinda Gates Foundation",
        "funder_city": "Seattle",
        "funder_state": "WA",
        "funder_country": "United States",
        "funder_type": "Family foundation",
        "funder_zipcode": "98109",
        "funder_country_code": "6252001",
        "funder_ein": "56-2618866",
        "funder_gs_profile_update_level": "Silver 2021",
        "recip_key": "846301",
        "recip_name": "Center for Global Development",
        "recip_city": "Washington",
        "recip_state": "DC",
        "recip_country": "United States",
        "recip_zipcode": "20036",
        "recip_country_code": "6252001",
        "recip_ein": "52-2351337",
        "recip_organization_code": "EA040000",
        "recip_organization_tran": "Public charities",
        "recip_gs_profile_link": "https://www.guidestar.org/Profile/52-2351337",
        "recip_gs_profile_update_level": "Platinum 2020",
        "grant_key": "10335044",
        "amount_usd": 10000000,
        "grant_subject_code": "SB030000; SE130000; SN020000; ST040000",
        "grant_subject_tran": "Elementary and secondary education; Public health; Economic development; International development",
        "grant_population_code": "PA010000; PG030200; PJ050100",
        "grant_population_tran": "Children and youth; Low-income people; Students",
        "grant_strategy_code": "UK0000; UM0100; UN0000",
        "grant_strategy_tran": "Policy, advocacy and systems reform; Research; Program support",
        "grant_transaction_code": "TA00",
        "grant_transaction_tran": "Cash grants",
        "grant_geo_area_code": "7100067",
        "year_issued": "2006",
        "grant_duration": "5.00",
        "grant_description": "To amplify impact of CGD's policy research and outreach on key public policy debates affecting health, education, governance and economic outcomes in developing world",
        "last_updated": "2016-04-08 16:58:52.377"
      }
    ]
  }
}