---
title: "Search published recipients"
method: GET
path: "/api/v1/recipients"
tags: ["History"]
---

# Search published recipients

`GET /api/v1/recipients`

## Request

- Base URL: `https://openmedici.com`
- URL: `https://openmedici.com/api/v1/recipients`
- Auth: none required

Invalid recipient filters are omitted and reported in meta.invalid.

## Query parameters

- `limit` integer
- `offset` integer
- `q` string
- `year` integer
- `program` string
- `kind` 'person' | 'organization' | 'team'

## Response `200`

Successful response

- RecipientListResponse
  - `data` RecipientSummary[], required
    - `id` string, uuid, required
    - `slug` string, required
    - `displayName` string, required
    - `kind` 'person' | 'organization' | 'team', required
    - `countryCode` string, nullable, required
    - `biography` string, nullable, required
    - `awardCount` integer, required
    - `latestAwardYear` integer, nullable, required
  - `meta` RecipientListMeta, required
    - `limit` integer, required
    - `offset` integer, required
    - `count` integer, required
    - `total` integer, required
    - `page` integer, required
    - `pages` integer, required
    - `filters` object, required
      - `q` string
      - `year` integer
      - `program` string
      - `kind` 'person' | 'organization' | 'team'
    - `invalid` string[], required

## Other responses

- `4XX`: The request could not be fulfilled because of a client error.

---

[API](https://skmtc.dev/openmedici/apis/open-medici-public-api.md) · [All operations](https://skmtc.dev/openmedici/apis/open-medici-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openmedici/apis/open-medici-public-api/revisions/3b7a349ded21?raw)