Complete reference for all PaperStack API endpoints, request parameters, and response structures.

API Endpoints

PaperStack exposes a RESTful API organized by exam, year, shift, and file. Discovery endpoints are public; data endpoints require authentication.

Public Endpoints (No Auth Required)

These endpoints return metadata about available data. No API key needed.

These endpoints require a valid API key in the Authorization header.

All protected endpoints require Authorization: Bearer ps_xxxxx. Requests without a valid key return 401 Unauthorized.

PaperStack supports smart shift resolution. You can reference shifts in three ways:

Input Type	Example	Resolves To
Full shift name	`05may-s1`	Exact match
Suffix alias (recommended)	`s1`	First `-s1` shift chronologically
Date prefix	`05may`	First shift starting with `05may`

Use shorthand aliases (s1, s2) for simpler URLs. PaperStack resolves the full shift name automatically.