APIsDatasetsUser guidesChangelog
APIs
Log inFree trial

/funders

get
https://api.candid.org/grants/v1/funders

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

Query Params
string

The keyword to search for.

integer

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

string
enum

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

Allowed:
string
enum

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.

Allowed:
year
array of integers

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. 2020).

year
subject
array of strings

The subject code to search on. For example, the subject code 'SE' searches for 'Health'. 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.

subject
population
array of strings

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.

population
support
array of strings

The support strategy code to search on. For example support strategy code 'UA' searches for 'General 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.

support
transaction
array of strings

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.

transaction
recip_id
array of strings

The recipient key to search on. For example, the recip ID '532410' searches for 'Hot Bread Kitchen Ltd'. 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.

recip_id
funder_id
array of strings

The funder key to search on. For example, the funder ID '7190908' searches for 'Restaurant Workers Community 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.

funder_id
string
enum

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.

Allowed:
string
enum

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

Allowed:
integer

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

integer

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

string
enum

Value by which to sort the list of results

Allowed:
date

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).

string
enum

The order to sort the search results, one of "asc" or "desc".

Allowed:
integer
1 to 100

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

string
enum

Defines the format of the response.

Allowed:
string

Comma seperated list of GS seal levels to search for.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated over 2 years ago

Language
Credentials
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/json
Updated over 2 years ago