# Ghent University Library People Service

**Canonical:** https://apis.io/apis/ghent/people-service/  
**Provider:** Ghent University — https://apis.io/providers/ghent/  
**Base URL:** /api/v1  
**Documentation:** https://github.com/ugent-library/people-service

Ghent University Library People Service is one of 12 APIs that [Ghent University](https://apis.io/providers/ghent/) publishes on the [APIs.io](https://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.

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.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| POST | `/add-person` | Insert/update a single person record |
| POST | `/get-person` | Retrieve a single person record |
| POST | `/get-people-by-identifier` | Retrieve person records by one of the extra identifiers |
| POST | `/get-people-by-id` | Retrieve person records by their ids |
| POST | `/get-people` | Get all person records |
| POST | `/suggest-people` | Search on person records |
| POST | `/set-person-orcid` | Update person ORCID |
| POST | `/set-person-token` | Update person tokens |
| POST | `/set-person-role` | Update person role |
| POST | `/set-person-settings` | Update person settings |
| POST | `/add-organization` | Insert/update a single organization record |
| POST | `/get-organization` | Get single organization record |
| POST | `/get-organizations-by-identifier` | Get organization records by one of the extra identifiers |
| POST | `/get-organizations-by-id` | Get organization records by their ids |
| POST | `/get-organizations` | Get all organization records |
| POST | `/suggest-organizations` | Search on organization records |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/ghent/refs/heads/main/openapi/ghent-people-service-openapi.yaml
- **APIReference** — https://raw.githubusercontent.com/ugent-library/people-service/main/api/v1/openapi.yaml
- **SourceCode** — https://github.com/ugent-library/people-service
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/ghent/refs/heads/main/authentication/ghent-authentication.yml
- **Errors** — https://raw.githubusercontent.com/api-evangelist/ghent/refs/heads/main/errors/ghent-errors.yml

## Other Ghent University APIs (11)

- [Ghent University Academic Bibliography API](https://apis.io/apis/ghent/biblio/)
- [Ghent University Academic Bibliography OAI-PMH](https://apis.io/apis/ghent/biblio-oai/)
- [Ghent University Academic Bibliography SRU](https://apis.io/apis/ghent/biblio-sru/)
- [Hydra Resto API](https://apis.io/apis/ghent/hydra-resto/)
- [Ghent University Library Projects Service](https://apis.io/apis/ghent/projects-service/)
- [Ghent University Library OAI Service](https://apis.io/apis/ghent/oai-service/)
- [Ghent University SAML 2.0 Identity Provider](https://apis.io/apis/ghent/saml-idp/)
- [Ghent University Library catalogue (Ex Libris Alma/Primo VE tenancy)](https://apis.io/apis/ghent/library-catalog/)
- [Dodona](https://apis.io/apis/ghent/dodona/)
- [Crossref membership](https://apis.io/apis/ghent/crossref/)
- [ROR registration](https://apis.io/apis/ghent/ror/)

## Tags

Identity, People, Organizations, ORCID, Research, Library

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ghent/people-service/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ghent/.