Filtering projects

Filters narrow down the search results based on specific criteria. Each filter is provided as its own query parameter in the request URL:

param1=value1&param2=value2&...&paramN=valueN

note

By default, different filters are combined using the logical AND operator. If the same filter is provided multiple times, its values are combined using the logical OR operator. See Using logical operators for full details.

Available parameters

Identity and content

Parameter	Description
search	Search in the content of the project.
title	Search in the project's title.
keywords	The project's keywords.
id	The OpenAIRE id of the project.
code	The grant agreement (GA) code of the project.
acronym	The project's acronym.
callIdentifier	The identifier of the research call.
country	The country of the project.

Funding

Parameter	Description
fundingShortName	The short name of the funder.
funder	The funder name.
fundingStreamId	The identifier of the funding stream.
fundinglevel0Id	The funding level 0 identifier.
fundinglevel1Id	The funding level 1 identifier.
fundinglevel2Id	The funding level 2 identifier.
projectOAMandatePublications	Whether the project has an OA mandate for publications.

Dates

Parameter	Description
fromStartDate	Start date greater than or equal to the given date (YYYY or YYYY-MM-DD).
toStartDate	Start date less than or equal to the given date (YYYY or YYYY-MM-DD).
fromEndDate	End date greater than or equal to the given date (YYYY or YYYY-MM-DD).
toEndDate	End date less than or equal to the given date (YYYY or YYYY-MM-DD).
fromStartYear	Start year greater than or equal to the given year (YYYY).
toStartYear	Start year less than or equal to the given year (YYYY).
fromEndYear	End year greater than or equal to the given year (YYYY).
toEndYear	End year less than or equal to the given year (YYYY).
startYear	Projects with the given start year (YYYY).
endYear	Projects with the given end year (YYYY).
activeYear	Projects active in the given year (YYYY).

Relations

Parameter	Description
relOrganizationName	The name or short name of the related organization.
relOrganizationId	The organization identifier of the related organization.
relOrganizationCountryCode	The country code of the related organizations.
relCommunityId	Projects connected to the community (with OpenAIRE id).
relCollectedFromDatasourceId	Projects collected from the data source (with OpenAIRE id).

Using logical operators

The API supports the logical operators AND, OR, and NOT.

AND operator

/v3/projects?search="climate" AND "adaptation"

OR operator

The same effect is achieved by repeating the parameter or by separating values with a comma.

/v3/projects?relOrganizationCountryCode=("US" OR "GR")

NOT operator

/v3/projects?fundingShortName="EC" NOT "WT"

note

When using AND, OR, or NOT, each value must be wrapped in double quotes. Bare (unquoted) values are only allowed when no operator is present.

See also the full list of examples.