# Clipboard Public API

> REST API for accessing a school's extracurricular data on Clipboard: activities, sessions, rolls, teams and the students enrolled in them.

Key facts:

- The API is served from https://api.clipboard.app. This documentation site, https://api-docs.clipboard.app, does not serve the API.
- Authenticate with a Bearer API token provisioned on the Clipboard Integration page (IT Admin only), sent as `Authorization: Bearer YOUR_TOKEN` on every request.
- List endpoints are paginated and return a `{ data, pagination }` envelope.

## Docs

- [OpenAPI specification](https://api-docs.clipboard.app/openapi.yaml): the machine-readable OpenAPI 3.1 contract. This specification is being rolled out endpoint by endpoint and does not yet cover the whole public API; the written documentation remains authoritative for endpoints not listed here.
- [Written documentation](https://api-docs.clipboard.app/homepage.md): the full written documentation as raw markdown, covering every endpoint including those the specification does not list yet.
- [Interactive API reference](https://api-docs.clipboard.app/api-reference.html): the specification rendered for people.
- [Integration Data Processing Terms](https://www.clipboard.app/legal/integration-data-processing-terms): the terms that govern access to the API.

## Endpoints

The operations the specification covers so far, grouped by resource.

### Activities

Activities offered by the organisation, each belonging to a department.

- GET /activities: List activities

### Activity Selections

Student selections of activities offered for a season.

- GET /activity-selections: List activity selections

### Attendance Records

Student attendance records for session rolls.

- GET /attendance-records: List attendance records

### Departments

Overarching categories that activities fall under, e.g. Music, Co-Curricular or Sport.

- GET /departments: List departments

### Incidents

Incident reports logged against students, e.g. injuries or concussion checks.

- GET /incidents: List incidents

### Locations

Places or venues at which sessions or fixtures can be held.

- GET /locations: List locations

### Pre-Explained Absences

Planned absences submitted ahead of time so a student is excused.

- GET /pre-explained-absences: List pre-explained absences

### Sessions

Calendar events such as lessons, rehearsals and fixtures, and the rolls taken for them.

- GET /sessions: List sessions
- GET /sessions/{id}: Get a session

### Students

Students enrolled at the school.

- GET /students: List students

### Student Teams

A student's membership of a team, and the window over which it was held.

- GET /student-teams: List student teams

### Teams

Teams, ensembles and groups of students.

- GET /teams: List teams
- GET /teams/{id}: Get a team

### Users

Staff users of the Clipboard App.

- GET /users: List users

### Year Groups

Groupings of students by age or the academic year they are enrolled in.

- GET /year-groups: List year groups