Academic Curriculum API

Structured curriculum data including frameworks, subjects, topics, and learning outcomes. Build educational technology, content alignment tools, and assessment platforms using data from the SA Department of Basic Education (CAPS) and National Education Departments.

Live

Base URL

https://api.crimate.net/v1/curriculum

Authentication

Include your Curriculum API key in the Authorization header.

curl -H "Authorization: Bearer db_curriculum_live_YOUR_KEY" \
     https://api.crimate.net/v1/curriculum/subjects?framework=caps-za&grade=10

Endpoints

GET/v1/curriculum/frameworks

List curriculum frameworks with optional filters for country and education level

Parameters: country (ISO alpha-2), level (primary|secondary|tertiary), page, per_page

Example

GET /v1/curriculum/frameworks?country=ZA&level=secondary

GET/v1/curriculum/frameworks/{id}

Detailed curriculum framework including structure, phases, and subject areas

Parameters: id (required, path)

Example

GET /v1/curriculum/frameworks/caps-za

GET/v1/curriculum/subjects

List subjects within a framework, filterable by grade, phase, and category

Parameters: framework (required), grade (1-12), phase (foundation|intermediate|senior|fet), category, page, per_page

Example

GET /v1/curriculum/subjects?framework=caps-za&grade=10&phase=fet

GET/v1/curriculum/subjects/{id}/topics

Topic breakdown for a subject including content areas, weighting, and teaching hours

Parameters: id (required, path), term (1-4, optional)

Example

GET /v1/curriculum/subjects/caps-mathematics-gr10/topics?term=1

GET/v1/curriculum/outcomes

Learning outcomes and assessment standards for a subject and grade

Parameters: subject (required), grade (required), framework (optional), page, per_page

Example

GET /v1/curriculum/outcomes?subject=mathematics&grade=10&framework=caps-za

GET/v1/curriculum/outcomes/search

Full-text search across learning outcomes, skills, and knowledge statements

Parameters: q (required), framework (optional), grade (optional)

Example

GET /v1/curriculum/outcomes/search?q=quadratic+equations&framework=caps-za

GET/v1/curriculum/stats

Dataset statistics (total frameworks, subjects, outcomes, latest update)

Parameters: None

Example

GET /v1/curriculum/stats

Response Examples

Subject topics response:

{
  "subject": {
    "id": "caps-mathematics-gr10",
    "name": "Mathematics",
    "framework": "caps-za",
    "grade": 10,
    "phase": "FET"
  },
  "topics": [
    {
      "content_area": "Algebra",
      "topic": "Equations and Inequalities",
      "term": 1,
      "teaching_hours": 12,
      "weighting_pct": 15.0,
      "subtopics": [
        "Linear equations",
        "Quadratic equations",
        "Simultaneous equations",
        "Word problems"
      ],
      "outcomes": [
        {
          "code": "CAPS-M-10-ALG-01",
          "statement": "Solve quadratic equations by factorisation, completing the square, and using the quadratic formula.",
          "cognitive_level": "complex_procedures"
        },
        {
          "code": "CAPS-M-10-ALG-02",
          "statement": "Solve simultaneous linear equations algebraically and graphically.",
          "cognitive_level": "routine_procedures"
        }
      ]
    },
    {
      "content_area": "Functions",
      "topic": "Functions and Graphs",
      "term": 1,
      "teaching_hours": 15,
      "weighting_pct": 20.0,
      "subtopics": [
        "Linear functions",
        "Quadratic functions",
        "Hyperbolic functions",
        "Exponential functions"
      ],
      "outcomes": [
        {
          "code": "CAPS-M-10-FUN-01",
          "statement": "Identify and sketch graphs of linear, quadratic, hyperbolic, and exponential functions.",
          "cognitive_level": "complex_procedures"
        }
      ]
    }
  ],
  "total_topics": 10,
  "total_teaching_hours": 160
}

Try It

Enter your Curriculum API key to make a live request. Generate a key in the dashboard.

Try It

Make a live API call from your browser

API Key

Endpoint

GET

curl -H "Authorization: Bearer db_curriculum_live_YOUR_KEY" \
     "https://crimate.net/v1/curriculum/stats"

Data Sources

SA Dept of Basic Education (CAPS)

The Curriculum and Assessment Policy Statement (CAPS) is the national curriculum framework for South African schools from Grade R to Grade 12. Covers all subjects across Foundation, Intermediate, Senior, and FET phases with detailed content areas, topics, teaching time allocations, and assessment standards.

National Education Departments

Official curriculum frameworks from education ministries across multiple countries including the UK National Curriculum, Kenya CBC, Nigerian NERDC curriculum, and others. Enables cross-country curriculum comparison and content alignment.

Rate Limits

Tier	Price	Rate Limit	Daily Quota	Monthly Quota
Free	R0/mo	10 req/min	100	1,000
Starter	R1,999/mo	60 req/min	5,000	50,000
Pro	R4,999/mo	300 req/min	Unlimited	500,000

Error Codes

All error responses follow a consistent JSON format:

{
  "error": "error_code",
  "message": "Human-readable description."
}

Status	Error Code	Description
400	invalid_request	The request body or query parameters are malformed.
401	unauthorized	Missing or invalid API key.
403	no_subscription	No active subscription for this API product.
403	quota_exceeded	Daily or monthly quota exceeded.
404	not_found	The requested resource does not exist.
429	rate_limit_exceeded	Too many requests. Check X-RateLimit-Remaining header.
500	internal_error	An unexpected server error occurred.