Sign in

v1

latestOpenAPI 3.0.12026-07-2427125325.2 KB
List

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

get/funders

Query parameters

querystring
Example:Restaurant

The keyword to search for.

locationinteger
Example:6252001

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

geo_id_type'geonameid'

The geo ID type for the location parameter to search on. The 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[]

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

[
  2020
]
subjectstring[]

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.

[
  "SE"
]
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[]

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.

[
  "UA"
]
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 '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.

[
  "532410"
]
funder_idstring[]

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.

[
  "7190908"
]
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:987654321

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

sort_by'funder_name' | 'funder_city' | 'funder_state' | 'funder_country' | 'amount' | 'count'

Value by which to sort the list of results

last_updatedstring date
Example:2021-05-06

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

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:bronze

Comma seperated list of GS seal levels to search for.

Response

Array of the funders' profile, grant amount, and grant counts that match the criteria searched.

Example response

{
  "meta": {
    "code": 200,
    "status": "OK",
    "elapsed_time": "0:00:00.610852",
    "time": "2021-01-01T01:01:01.000Z"
  },
  "data": {
    "total_hits": 150000,
    "num_pages": 5000,
    "rows": [
      {
        "funder_key": "SANF001",
        "funder_profile_url": "https://fconline.foundationcenter.org/fdo-grantmaker-profile?key=SANF001",
        "funder_gs_profile_update_level": "Silver 2020",
        "funder_name": "The San Francisco Foundation",
        "funder_city": "San Francisco",
        "funder_state": "CA",
        "funder_country": "United States",
        "ein": "01-0679337",
        "last_updated": "2021-02-08 14:38:17.660",
        "amount_usd": 82000,
        "grant_count": 4
      }
    ]
  }
}