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:US,communities.id:uarctic |
| | OR within a field | country:GR|IT |
! | Negation | country:!DE |
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:openorgs____::d41cf6bd4ab1b1362a44397e0b95c975 |
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 |
continent | enum | ✓ | ✓ | — | continent:europe |
is_global_south | boolean | — | ✓ | — | is_global_south:true |
continent accepts africa, antarctica, asia, europe, north_america, oceania or south_america; an unknown name is rejected with a 400 listing the valid ones. Both fields expand server-side into the matching ISO country codes — drawn from the UN Statistics Division M49 classification and the UN Finance Center for South-South Cooperation respectively — so they are not facetable.
A single field accepts at most 50 pipe-separated values; beyond that the request is rejected with a 400 naming the field. Server-side expansion such as continent:europe does not count toward that limit.
Relations
| Field | Type | OR | NOT | Facetable | Example |
|---|---|---|---|---|---|
communities.id | string | ✓ | ✓ | ✓ | communities.id:uarctic |
collected_from.id | string | ✓ | — | ✓ | collected_from.id:openaire____::openorgs |
Combined examples
Greek or Italian universities:
/v4/organizations?filter=legal_name.search:university,country:GR|ITOrganizations in the UArctic community, outside Germany:
/v4/organizations?filter=communities.id:uarctic,country:!DE