How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Ghent University Library People Service

An OpenAPI 3.1 contract authored and open-sourced by Ghent University Library for the people and organizations directory behind the Academic Bibliography. Sixteen operations covering person and organization records, identifier lookup, suggest, role and settings management, and an explicit set-person-orcid operation that makes ORCID a first-class field. servers[] is relative (/api/v1) because the service runs inside the university's own estate - no public base URL is published and none has been invented here. Authentication is an X-Api-Key header.

Ghent University Library People Service is one of 12 APIs that Ghent University publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Identity, People, Organizations, ORCID, and Research. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and authentication docs.

This API exposes 16 operations across 16 paths, and defines 26 schemas. It is described by OpenAPI 3.1.0, at version 0.0.1.

Requests are made against a single base URL, /api/v1.

16 operations 16 paths 26 schemas 16 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.0.1
Server
/api/v1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Ghent University Library People Service declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Api-Key (apiKey). By default, every request must be authenticated.

Paths & Operations 16

Across 16 paths, the API surfaces 16 operations — 16 POST. Each is listed below with its method, path, parameters, and response codes.

Operations 16
POST
/add-person
Insert/update a single person record
AddPerson body → 200default
POST
/get-person
Retrieve a single person record
GetPerson body → 200default
POST
/get-people-by-identifier
Retrieve person records by one of the extra identifiers
GetPeopleByIdentifier body → 200default
POST
/get-people-by-id
Retrieve person records by their ids
GetPeopleById body → 200default
POST
/get-people
Get all person records
GetPeople body → 200default
POST
/suggest-people
Search on person records
SuggestPeople body → 200default
POST
/set-person-orcid
Update person ORCID
SetPersonOrcid body → 200default
POST
/set-person-token
Update person tokens
SetPersonToken body → 200default
POST
/set-person-role
Update person role
SetPersonRole body → 200default
POST
/set-person-settings
Update person settings
SetPersonSettings body → 200default
POST
/add-organization
Insert/update a single organization record
AddOrganization body → 200default
POST
/get-organization
Get single organization record
GetOrganization body → 200default
POST
/get-organizations-by-identifier
Get organization records by one of the extra identifiers
GetOrganizationsByIdentifier body → 200default
POST
/get-organizations-by-id
Get organization records by their ids
GetOrganizationsById body → 200default
POST
/get-organizations
Get all organization records
GetOrganizations body → 200default
POST
/suggest-organizations
Search on organization records
SuggestOrganizations body → 200default

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are Person (19 properties), Organization (9 properties), OrganizationParent (5 properties), SetPersonTokenRequest (3 properties). Each schema is shown below with its type and property counts.

Error
object
2 properties 2 required
StringMap
object
OrganizationMember
object
3 properties 1 required
Person
object
19 properties
OrganizationParent
object
5 properties 2 required
Organization
object
9 properties
PersonListResponse
object
1 property 1 required
PersonPagedListResponse
object
2 properties 1 required
OrganizationListResponse
object
1 property 1 required
OrganizationPagedListResponse
object
2 properties 1 required
GetPersonRequest
object
1 property 1 required
AddPersonRequest
AddOrganizationRequest
GetPeopleByIdentifierRequest
object
1 property 1 required
GetPeopleByIdRequest
object
1 property 1 required
GetPeopleRequest
object
1 property
SuggestPeopleRequest
object
3 properties 1 required
SetPersonOrcidRequest
object
2 properties 2 required
SetPersonTokenRequest
object
3 properties 3 required
SetPersonRoleRequest
object
2 properties 2 required
SetPersonSettingsRequest
object
2 properties 2 required
GetOrganizationRequest
object
1 property 1 required
GetOrganizationsByIdentifierRequest
object
1 property 1 required
GetOrganizationsByIdRequest
object
1 property 1 required
GetOrganizationsRequest
object
1 property
SuggestOrganizationsRequest
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ghent-people-service-openapi.yaml Raw ↑

Other APIs Ghent University publishes across the network.

Ghent University Academic Bibliography API
Ghent University Academic Bibliography OAI-PMH
Ghent University Academic Bibliography SRU
Hydra Resto API
Ghent University Library Projects Service
Ghent University Library OAI Service
Ghent University SAML 2.0 Identity Provider
Ghent University Library catalogue (Ex Libris Alma/Primo VE tenancy)
Crossref membership
ROR registration
Where this information came from

This is an independent, third-party profile of Ghent University Library People Service, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.