Persons

Search and retrieve persons — authors and contributors involved in research products.

Base URL

https://api.openaire.eu/graph/v3/persons

Quick start

Search for a person by name:

/v3/persons?givenName=Paolo&lastName=Manghi

Retrieve a single person by their OpenAIRE id:

/v3/persons/orcid_______::412404e11ee7ce59ed3acaec05a162fb

Endpoints

• GET /v3/persons — search persons using the filter parameters below
• GET /v3/persons/{id} — retrieve a single person by their OpenAIRE id

Filter parameters

Parameter	Description
search	Keyword-based search across the person's content.
id	The OpenAIRE id of the person.
originalId	The identifier of the record at the original sources.
givenName	The given name of the person.
lastName	The last name of the person.

All filter parameters support the AND, OR, and NOT logical operators. See filtering research products for details on the operator syntax.

Meta-parameters

Parameter	Type	Default	Description
logicalOperator	string	AND	Top-level operator combining the provided filters (AND or OR)
sortBy	string	relevance DESC	Sort directive fieldname ASC\|DESC. Persons can only be sorted by relevance.
page	int	1	Page number
pageSize	int	10	Results per page, range 1–100
cursor	string	—	Cursor-based pagination, initial value *

For paging through results, see Paging.

Response

The response is an object with a header and a results array. The header reports numFound, maxScore, queryTime, page, pageSize, and (for cursor paging) nextCursor. The results array contains Person objects.

Examples

Common / top-level parameters

Parameter	Example
search	?search=Manghi
sortBy	?search=Manghi&sortBy=relevance DESC
logicalOperator	?givenName=Paolo&lastName=Manghi&logicalOperator=OR
page + pageSize	?lastName=Smith&page=2&pageSize=25
cursor	?lastName=Smith&pageSize=100&cursor=*

Identity

Parameter	Example
id	?id=orcid_______::1162aa0085201f2b835315dae4e5a827
originalId	?originalId=0000-0002-1825-0097

Name

Parameter	Example
givenName	?givenName=Paolo
lastName	?lastName=Manghi
lastName (OR / NOT)	?lastName=("Manghi" OR "Smith") AND NOT "Jones"

Combined examples

Parameter	Example
Full name match	?givenName=Paolo&lastName=Manghi
By ORCID, paged	?originalId=0000-0002-1825-0097&pageSize=10