# Alpha Learning

> Enroll students in mastery curricula, read progress, award points, publish leaderboards.

Canonical: https://grout.app/developer/documentation/learning/alpha/

Alpha Learning is Grout's two-hour mastery loop: a curriculum of concepts, daily plans, sessions and spaced review, with points, streaks and badges on top. The API exposes enrollment and progress so an LMS can show it or drive it.

## Curricula

```bash
curl $API/alpha/curricula -H "Authorization: Bearer $KEY"        # published; institution-owned + shared
```

## Enroll

```bash
curl -X POST $API/alpha/enrollments -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{ "curriculum_id": "cur_…", "student_ids": ["u_1", "u_2"], "daily_target_minutes": 120 }'
curl -X PATCH $API/alpha/enrollments/enr_… -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{ "status": "paused" }'
curl "$API/alpha/enrollments?student_id=u_1" -H "Authorization: Bearer $KEY"
```

## Progress

```bash
curl $API/alpha/students/u_1 -H "Authorization: Bearer $KEY"             # drill-down
curl $API/alpha/students/u_1/mastery -H "Authorization: Bearer $KEY"     # per-concept score/status
curl $API/alpha/students/u_1/points -H "Authorization: Bearer $KEY"      # stats + ledger
curl "$API/alpha/leaderboard?limit=20" -H "Authorization: Bearer $KEY"
```

## Award points

```bash
curl -X POST $API/alpha/students/u_1/points -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{ "points": 25, "note": "Science fair", "ref": "fair-2026" }'
```

±100 per call, idempotent on `ref`.

## Events

`alpha.points_awarded`, `alpha.badge_granted`. Guardians receive weekly reports; read them via `GET /guardians/reports`.