Filter syntax

The filter parameter uses a compact field:value grammar that replaces the individual query parameters of previous API versions.

Operators

Operator	Meaning	Example
,	AND across fields	country:GR,communities.id:egi
|	OR within a field	country:GR|IT
!	Negation	country:!DE

note

Filters are combined with AND (comma). Within a single field, use pipe (|) for OR. These cannot be mixed — each field entry is either a single value, a negation, or an OR-list.

Filter fields

Identity

Field	Type	OR	NOT	Facetable	Example
id	string	✓	✓	—	id:anr_________::1bb745121fc1c70e1e5b3fbe20a06bf8
pid	string	✓	✓	—	pid:https://ror.org/052gg0110

Text search sub-filters

These fields allow targeted text searches within specific parts of the organization. They are used inside the filter parameter, unlike the top-level search parameter which searches across all default fields.

Field	Description	Example
legal_name.search	Search within the legal name	legal_name.search:university
legal_short_name.search	Search within the legal short name	legal_short_name.search:NKUA
default.search	Search all default fields (same as top-level search)	default.search:athens

Country

Field	Type	OR	NOT	Facetable	Example
country	string	✓	✓	✓	country:GR|IT

Relations

Field	Type	OR	NOT	Facetable	Example
communities.id	string	✓	✓	✓	communities.id:egi
collected_from.id	string	✓	—	✓	collected_from.id:openaire____::openorgs

Combined examples

• Greek or Italian universities: /v4/organizations?filter=legal_name.search:university,country:GR|IT

• Organizations in the EGI community, outside Germany: /v4/organizations?filter=communities.id:egi,country:!DE