Api-docs

API

Build on top of Preppsy. Use our REST API to integrate question banks, progress tracking, and analytics into your existing platforms.

Quick Start

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.preppsy.app/api/questions?domain=pharmacology&difficulty=2

Get your API key from Settings → API.

Endpoints

GET
/api/questions

Retrieve questions filtered by domain, difficulty, and exam type.

POST
/api/sessions

Create a new practice session and track attempts.

GET
/api/mastery/:studentId

Get mastery data for a student across all concepts.

GET
/api/analytics

Retrieve aggregate analytics for a cohort or institution.

POST
/api/documents/upload

Upload a document for concept extraction and question generation.

GET
/api/concepts

Browse the psychology ontology with domain filtering.

Rate Limits

Free
100 requests / hour
Pro
1,000 requests / hour
Institution
10,000 requests / hour