API Reference

v1 · REST · JSON · JWT auth · 99.95% SLO

Base URL

https://api.qwardprep.io/v1

Endpoints

POST/v1/auth/session
GET/v1/me
GET/v1/items
POST/v1/items
PATCH/v1/items/:id
DELETE/v1/items/:id
POST/v1/exams
POST/v1/exams/:id/attempts
POST/v1/engine/next
GET/v1/analytics/cohorts
GET/v1/analytics/mastery
POST/v1/billing/subscriptions
POST/v1/webhooks/vimeo

Sample request

curl -X POST https://api.qwardprep.io/v1/engine/next \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "session_id": "sess_8f2d", "category_focus": ["Cardiac"] }'

Response · 200

{
  "item": {
    "id": "Q-10293",
    "type": "SATA",
    "category": "Cardiac",
    "difficulty": "Hard",
    "stem": "A patient with new-onset atrial fibrillation…"
  },
  "engine": { "selection_reason": "category_gap+difficulty_fit" }
}

Auth

JWT (RS256)

Rate limit

120 r/s

SDKs

Dart · TS

Webhooks

HMAC-SHA256