# Syllabus — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse Nigerian school subjects organized by class and retrieve weekly lesson topics structured by term. Plan your curriculum and stay aligned with the official Syllabus.ng scheme of work for your educational institution.

**Category:** Education | **Website:** [syllabus.ng/](https://syllabus.ng/) | **Docs:** [parse.bot/marketplace/d867d4e6-0044-4c20-95fd-67fa104d74bb/syllabus-ng-api](https://parse.bot/marketplace/d867d4e6-0044-4c20-95fd-67fa104d74bb/syllabus-ng-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-syllabus-ng-api-d867d4e6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_scheme_of_work

Returns the complete scheme of work for a specific class and subject, organized by term. Each term contains weekly topics with learning objectives. Typically returns First Term, Second Term, and Third Term data with 10-13 weeks each.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `class_slug` | string | Yes | Class level identifier (e.g. 'primary1', 'jss1', 'ss3'). |
| `subject_slug` | string | Yes | Subject identifier slug from list_subjects (e.g. 'math', 'english', 'basic-science'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-syllabus-ng-api-d867d4e6/get_scheme_of_work \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"class_slug":"<string>","subject_slug":"<string>"}'
```

### list_subjects

Returns the list of subjects available for a given class level. Each subject includes a slug usable as input to get_scheme_of_work. Coverage varies by class level (Primary classes have fewer subjects than JSS/SSS).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `class_slug` | string | Yes | Class level identifier (e.g. 'primary1', 'jss1', 'ss3'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-syllabus-ng-api-d867d4e6/list_subjects \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"class_slug":"<string>"}'
```