Filter awards

You can filter awards with the filter parameter:

• Get awards from the National Science Foundation: https://api.openalex.org/awards?filter=funder.id:F4320306076

It's best to read about filters before trying these out. It will show you how to combine filters and build an AND, OR, or negation query.

/awards attribute filters

You can filter using these attributes of the Award object:

• amount

• currency

• doi

• end_year

• funder.doi

• funder.id

• funder.ror

• funder_award_id

• funder_name

• funder_scheme

• funded_outputs

• funded_outputs_count

• funding_type

• id

• lead_investigator.affiliation.country

• lead_investigator.affiliation.name

• lead_investigator.family_name

• lead_investigator.given_name

• lead_investigator.orcid

• provenance

• start_year

/awards convenience filters

These filters aren't attributes of the Award object, but they're included to address some common use cases:

default.search

Value: a search string

This works the same as using the search parameter for awards.

display_name.search

Value: a search string

Returns awards with a display_name containing the given string.

• Get awards with "climate" in the name: https://api.openalex.org/awards?filter=display_name.search:climate

description.search

Value: a search string

Returns awards with a description containing the given string.