Filtering organizations

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

Parameter	Description
search	Search in the content of the organization.
legalName	The legal name of the organization.
legalShortName	The legal name of the organization in short form.
id	The OpenAIRE id of the organization.
pid	The persistent identifier of the organization (e.g. a ROR id).
countryCode	The country code of the organization.
relCommunityId	Organizations connected to the community (with OpenAIRE id).
relCollectedFromDatasourceId	Organizations collected from the data source (with OpenAIRE id).

Using logical operators

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

AND operator

Use AND to retrieve results that include all specified values.

/v3/organizations?search="university" AND "athens"

OR operator

Use OR to retrieve results that include any of the specified values. The same effect is achieved by repeating the parameter or by separating values with a comma.

/v3/organizations?countryCode=("GR" OR "IT")

NOT operator

Use NOT to exclude specific values.

/v3/organizations?search="institute" NOT "medical"

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.