Pro plan

APS Calculator API

University-specific APS scores for all 26 South African institutions

Submit a student matric subject marks and receive an accurate APS score calculated using each university own rules and method. Supports all 26 South African public universities. Combine with the qualifications endpoint to check programme eligibility.

Get API Key Free View Docs

What is included

All 26 Universities

Every public university has its own APS rules configured and maintained.

University-specific Methods

Handles standard bands, percentage-based, weighted subjects, and custom rules per institution.

Per-subject Breakdown

Response includes each subject, its APS category, percentage, and points contribution.

Life Orientation Handling

Correctly handles LO inclusion and exclusion per university policy.

Batch Calculation

Calculate scores for all universities in a single request.

Eligibility Checking

Combine with the qualifications endpoint to check programme eligibility including subject requirements.

Available endpoints

POST/v1/data/aps-calculatorCalculate APS for a university

Example

Request

curl -X POST https://api.labs.org.za/v1/data/aps-calculator \
  -H "Authorization: Bearer labs_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "university_id": "e67bc005-68f8-41b5-9849-38e0f9581efd",
    "subjects": [
      { "name": "English Home Language", "subject_type": "english_hl", "percentage": 72 },
      { "name": "Mathematics", "subject_type": "math", "percentage": 65 },
      { "name": "Physical Sciences", "subject_type": "other", "percentage": 58 },
      { "name": "Life Orientation", "subject_type": "life_orientation", "percentage": 70 }
    ]
  }'

Response

{
  "data": {
    "university": {
      "id": "e67bc005-68f8-41b5-9849-38e0f9581efd",
      "name": "Central University of Technology",
      "short_name": "CUT"
    },
    "aps_score": 27,
    "breakdown": [
      {
        "subject": "English Home Language",
        "subject_type": "english_hl",
        "aps_category": "english_hl",
        "percentage": 72,
        "points": 5
      },
      {
        "subject": "Mathematics",
        "subject_type": "math",
        "aps_category": "mathematics",
        "percentage": 65,
        "points": 5
      }
    ],
    "notes": null
  }
}

Ready to start building?

Requires Pro plan or above. Start free and upgrade when ready.

Get started free