GET /awards

api_key (string, query, required)

Your OpenAlex API key (required). Get a free key at https://openalex.org/settings/api

cursor (string, query, optional)

Cursor for deep pagination. Use `cursor=*` to start, then use the `next_cursor` from the response.

filter (string, query, optional)

Filter awards. Examples: `funder.id:F4320306076`, `start_year:2023`, `funded_outputs_count:>10` See [all Award fields](/api-reference/awards#available-filter-sort-and-group_by-fields).

group_by (string, query, optional)

Group by: `funder.id`, `start_year`, `currency` See [all Award fields](/api-reference/awards#available-filter-sort-and-group_by-fields).

page (integer, query, optional)

Page number for pagination. Use cursor for deep pagination beyond 10,000 results.

Constraints: {'minimum': 1}

per_page (integer, query, optional, default: 25)

Number of results per page (1-100, default 25)

Constraints: {'minimum': 1, 'maximum': 100}

sample (integer, query, optional)

Return a random sample of N results (max 10,000). Cannot be used with sort or page.

Constraints: {'maximum': 10000}

search (string, query, optional)

Full-text search across titles, abstracts, and other text fields. Example: `search=machine learning`

select (string, query, optional)

Comma-separated list of fields to return. Reduces response size. Example: `select=id,display_name,cited_by_count`

sort (string, query, optional)

Sort by: `funded_outputs_count`, `amount`, `start_year`. Prefix with `-` for descending. See [all Award fields](/api-reference/awards#available-filter-sort-and-group_by-fields).