Skip to main content
Skip table of contents

OpenAthens REST API documentation


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.

Intended Audience

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.

Document structure

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.

Object types

An overview of the major objects used in the API and the relationships between them.

API usage

Describes how a client can use the API to perform tasks such as creating and modifying accounts.

Usage examples

Provides worked examples showing how the API can be used to perform common tasks.

The API documentation is split into the following sections:

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.