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

# List awards

`GET /awards`

Get a list of research grants and funding awards.

## Query parameters

- `filter` string
- `sort` string
- `group_by` string
- `search` string
- `per_page` integer
- `page` integer
- `cursor` string
- `sample` integer
- `select` string
- `api_key` string, required

## Response `200`

Successful response

- AwardsListResponse
  - `meta` Meta — Metadata about the query results
    - `count` integer — Total number of results matching the query
    - `db_response_time_ms` integer — Database response time in milliseconds
    - `page` integer — Current page number
    - `per_page` integer — Number of results per page
    - `next_cursor` string — Cursor for the next page (when using cursor pagination)
    - `groups_count` integer, nullable — Number of groups when using group_by
    - `cost_usd` number — Cost of this request in USD
  - `results` AwardFull[]
    - `id` string — The OpenAlex ID for this award.
    - `display_name` string, nullable — The name of the award, if available.
    - `description` string, nullable — A description of the award, if available.
    - `funder_award_id` string — The funder's internal ID for this award.
    - `funder` object — The [funder](/api-reference/funders) of this award
      - `id` string
      - `display_name` string
      - `doi` string, nullable
    - `funded_outputs` string[] — OpenAlex IDs of works funded by this award (first 100).
    - `funded_outputs_count` integer — Total number of works funded by this award.
    - `amount` number, nullable — The funding amount, if available.
    - `currency` string, nullable — The currency of the funding amount, if available.
    - `funding_type` string, nullable — The type of funding, if available.
    - `funder_scheme` string, nullable — The funder's scheme or program, if available.
    - `start_date` string, date, nullable — Start date of the award (ISO 8601), if available.
    - `end_date` string, date, nullable — End date of the award (ISO 8601), if available.
    - `start_year` integer, nullable — Start year of the award, if available.
    - `end_year` integer, nullable — End year of the award, if available.
    - `landing_page_url` string, nullable — URL to the award's landing page, if available.
    - `doi` string, nullable — DOI for this award, if available.
    - `provenance` string — The source of this award data.
    - `lead_investigator` object, nullable — The lead investigator for this award, if available.
    - `co_lead_investigator` object, nullable — The co-lead investigator, if available.
    - `investigators` unknown[], nullable — List of investigators on this award, if available.
      - unknown
    - `works_api_url` string — A URL that returns all works funded by this award.
    - `created_date` string, date — When this award was added to OpenAlex (ISO 8601 date).
    - `updated_date` string, date-time — When this award was last updated (ISO 8601 datetime).

## Other responses

- `400` — Bad request - invalid parameters
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/openalex/apis/openalex-api.md) · [All operations](https://skmtc.net/openalex/apis/openalex-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openalex/openalex-api/revisions/60b6c8bd0799/schema)