This document details the public REST API for the OpenAthens system. In supersedes all previous versions.
The API described in this guide provides programmatic-access to OpenAthens user administration and may be used to perform registration and account management operations on data held within the system. This guide does not cover all possible account operations supported by the system – it primarily covers operations related to account and organisation management. These functions are known collectively as the "Management API"
If you are looking for documentation about connecting your local directory to OpenAthens using an API, see: API connector
There is also a reporting API available.
This document is intended for application architects and developers.
It is assumed that readers of this document are familiar with REST architectures, their associated standards, and identity management and federated access management (FAM) terminology.
This document is structured to cover the following main areas;
API overview and conventions.
An introduction to the API and a description of the conventions used throughout this guide.
An overview of the major objects used in the API and the relationships between them.
Describes how a client can use the API to perform tasks such as creating and modifying accounts.
Provides worked examples showing how the API can be used to perform common tasks.
The API documentation is split into the following sections: