OPopenalex
Awards

Get a single award

Retrieve a single award by its OpenAlex ID.

get/awards/{id}

Request

  • Base URL
    https://api.openalex.org
  • URL
    https://api.openalex.org/awards/{id}
  • Auth
    API key in query parameter api_key

Path parameters

idstring required

OpenAlex ID (e.g., G5859020988)

Query parameters

selectstring

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

api_keystring required

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

Response

Successful response

idstring

The OpenAlex ID for this award.

display_namestring nullable

The name of the award, if available.

descriptionstring nullable

A description of the award, if available.

funder_award_idstring

The funder's internal ID for this award.

funded_outputsstring[]

OpenAlex IDs of works funded by this award (first 100).

funded_outputs_countinteger

Total number of works funded by this award.

amountnumber nullable

The funding amount, if available.

currencystring nullable

The currency of the funding amount, if available.

funding_typestring nullable

The type of funding, if available.

funder_schemestring nullable

The funder's scheme or program, if available.

start_datestring date nullable

Start date of the award (ISO 8601), if available.

end_datestring date nullable

End date of the award (ISO 8601), if available.

start_yearinteger nullable

Start year of the award, if available.

end_yearinteger nullable

End year of the award, if available.

landing_page_urlstring nullable

URL to the award's landing page, if available.

doistring nullable

DOI for this award, if available.

provenancestring

The source of this award data.

lead_investigatorobject nullable

The lead investigator for this award, if available.

co_lead_investigatorobject nullable

The co-lead investigator, if available.

works_api_urlstring

A URL that returns all works funded by this award.

created_datestring date

When this award was added to OpenAlex (ISO 8601 date).

updated_datestring date-time

When this award was last updated (ISO 8601 datetime).

Example response

{
  "id": "https://openalex.org/G5859020988"
}

Changes

No recorded changes to this operation across all 6 revisions of this API.