APIsDatasetsUser guidesChangelog
APIs
Log inFree trial

/summary

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

Search for total grant summaries that match the criteria specified.

Query Params
string

Keyword to search for.

integer

Geoname ID for the location to search. (e.g. Geonameid '6252001' searches for 'United States').

string
enum

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

year
subject
array of strings

The subject code to search on. For example, the subject code 'SN0201' searches for 'Urban development'. 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 'PG0302' searches for 'Low-income people'. 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

Select the support strategy code to search on. For example, the 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 recipient ID '321486' searches for 'Bedford Stuyvesant Restoration Corportaion'. 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 'KRES002' searches for 'Kresge Foundation'. Multiple funder keys can be selected through 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. 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

Defines the format of the response.

Allowed:
string

Comma separated 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
LoadingLoading…
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