Skip to main content
For Developers

API Reference

Build on Scholium with our REST API and MCP server. Generate flashcards, access knowledge bases, and integrate spaced repetition into your workflow.

REST API Endpoints

Standard REST endpoints for integrating Scholium into your applications.

GET
/api/v1/projects

List all projects for the authenticated user.

GET
/api/v1/projects/:id/flashcards

Get all flashcards in a project with their review states.

POST
/api/v1/flashcards/generate

Generate flashcards from text using AI.

POST
/api/v1/review

Submit a review response and get the next scheduled review time.

GET
/api/v1/stats

Get learning statistics and review forecasts.

Authentication

OAuth 2.0 + PKCE for secure access to the API.

OAuth 2.0 Flow

  1. 1Redirect user to Scholium authorization endpoint
  2. 2User grants permission for requested scopes
  3. 3Exchange authorization code for access token
  4. 4Use access token in Authorization header

Available Scopes

read:projects

View your projects and study materials.

write:curriculum

Add content to your curriculum.

read:flashcards

View your flashcards and study progress.

write:flashcards

Create and modify flashcards.

read:knowledge

Search your knowledge base.

write:reviews

Record flashcard reviews.

Join the API Beta

The API and MCP server are currently in private beta. Sign up to get early access.

Join the Waitlist

We'll be in touch when your spot is ready.