Examples
A collection of ready-to-use API calls for persons. All URLs point to the beta environment:
https://api-beta.openaire.eu/graph/v4/persons
Top-level parameters
Search
Offset pagination
/v4/persons?filter=last_name:Smith&page=2&page_size=25
Cursor pagination
/v4/persons?filter=last_name:Smith&page_size=100&cursor=*
Select (sparse fieldsets)
/v4/persons?filter=last_name:Smith&select=id,givenName,familyName
Filter — Identity
By OpenAIRE id
/v4/persons?filter=id:orcid_______::412404e11ee7ce59ed3acaec05a162fb
By original id (ORCID)
/v4/persons?filter=ids.original:0000-0002-1825-0097
Filter — Names
By given name
/v4/persons?filter=given_name:Paolo
By last name
/v4/persons?filter=last_name:Manghi
By last name (OR)
/v4/persons?filter=last_name:Manghi|Smith
Combined examples
Full name match
/v4/persons?filter=given_name:Paolo,last_name:Manghi
Names only, paged
/v4/persons?filter=last_name:Smith&select=id,givenName,familyName&page=2&page_size=25