Skip to main content
GET
/
awards
List awards
curl --request GET \
  --url 'https://api.openalex.org/awards?api_key='
{
  "meta": {
    "count": 123,
    "db_response_time_ms": 123,
    "page": 123,
    "per_page": 123,
    "next_cursor": "<string>",
    "groups_count": 123,
    "cost_usd": 123
  },
  "results": [
    {
      "id": "https://openalex.org/G5859020988",
      "display_name": "<string>",
      "description": "<string>",
      "funder_award_id": "<string>",
      "funder": {
        "id": "<string>",
        "display_name": "<string>",
        "doi": "<string>"
      },
      "funded_outputs": [
        "<string>"
      ],
      "funded_outputs_count": 123,
      "amount": 123,
      "currency": "<string>",
      "funding_type": "<string>",
      "funder_scheme": "<string>",
      "start_date": "2023-12-25",
      "end_date": "2023-12-25",
      "start_year": 123,
      "end_year": 123,
      "landing_page_url": "<string>",
      "doi": "<string>",
      "provenance": "<string>",
      "lead_investigator": {},
      "co_lead_investigator": {},
      "investigators": "<array>",
      "works_api_url": "<string>",
      "created_date": "2023-12-25",
      "updated_date": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

​
api_key
string
query
required

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

Query Parameters

​
filter
string

Filter awards. Examples: funder.id:F4320306076, start_year:2023, funded_outputs_count:>10 See all Award fields.

​
sort
string

Sort by: funded_outputs_count, amount, start_year. Prefix with - for descending. See all Award fields.

​
group_by
string

Group by: funder.id, start_year, currency See all Award fields.

​
search
string

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

​
per_page
integer
default:25

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

Required range: 1 <= x <= 100
​
page
integer

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

Required range: x >= 1
​
cursor
string

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

​
sample
integer

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

Required range: x <= 10000
​
select
string

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

​
api_key
string
required

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

Response

Successful response

​
meta
object

Metadata about the query results

​
results
object[]