---
title: "GET /recipients"
method: GET
path: "/recipients"
tags: ["List"]
---

# GET /recipients

`GET /recipients`

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

## Query parameters

- `query` string
- `location` integer
- `geo_id_type` 'geonameid'
- `location_type` 'funder' | 'recipient' | 'area_served'
- `year` integer[]
- `subject` string[]
- `population` string[]
- `support` string[]
- `transaction` string[]
- `recip_id` string[]
- `funder_id` string[]
- `id_type` 'ein'
- `include_gov` 'yes' | 'no'
- `min_amt` integer
- `max_amt` integer
- `sort_by` 'recip_name' | 'recip_city' | 'recip_state' | 'recip_country' | 'amount' | 'count'
- `last_updated` string, date
- `sort_order` 'asc' | 'desc'
- `page` integer
- `format` 'json' | 'xml'
- `profile_levels` string

## Response `200`

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

- object
  - `meta` object
    - `code` integer — HTTP response status code.
    - `status` string — Description of the HTTP response status code.
    - `elapsed_time` string — Elapsed time of API call in milliseconds.
    - `time` string — Time of API call.
  - `data` object
    - `total_hits` integer — Total number of results returned
    - `num_pages` integer — Total number of pages returned
    - `rows` object[]
      - `recipient_key` string — Unique identifier assigned to each organization awarded a transaction
      - `recip_name` string — Recipient name
      - `recip_city` string — Recipient city
      - `recip_state` string — Recipient state
      - `recip_country` string — Recipient country
      - `recip_gs_profile_link` string — Recipient GuideStar profile link
      - `recip_gs_profile_update_level` string — Recipient seal level of transparency profile level
      - `ein` string — Recipient IRS Employer Identification Number
      - `last_updated` string — Date when the grant record was published or updated by candid
      - `amount_usd` number — Total sum of dollar value of grants awarded to the recipient that meet the search criteria
      - `grant_count` integer — Total number of grants awarded to the recipient that meet the search criteria

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — No Results Found
- `406` — Not Acceptable
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/candid/apis/rfpapi.md) · [All operations](https://skmtc.dev/candid/apis/rfpapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/candid/rfpapi/revisions/bb9133e46de6/schema)