Pro plan

APS Calculator API

University-specific APS scores in one API call

Submit a student's matric subject marks and receive an accurate APS score calculated using each university's own rules and method. Supports all 26 public universities.

Get API Key Free View Docs

What is included

All 26 Universities

Every public university has its own APS rules configured.

University-specific Methods

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

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

Use /v1/me/aps to calculate scores for all universities in a single request.

Eligibility Checking

Combine with /v1/me/qualifications to check programme eligibility including subject requirements.

Available endpoints

POST/v1/aps/calculateCalculate APS for a university

GET/v1/me/apsAPS for all universities (UserJWT)

GET/v1/me/aps/{universitySlug}APS for one university (UserJWT)

GET/v1/universities/{idOrSlug}/aps-rulesGet raw APS rules

Example

Request

curl -X POST https://api.apply.org.za/v1/aps/calculate \
  -H "X-API-Key: uafm_live_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "university_slug": "uct",
    "marks": [
      { "subject_slug": "eng_hl", "percentage": 78 },
      { "subject_slug": "math", "percentage": 82 },
      { "subject_slug": "phsc", "percentage": 71 },
      { "subject_slug": "lfsc", "percentage": 65 }
    ]
  }'

Response

{
  "data": {
    "university": {
      "slug": "uct",
      "name": "University of Cape Town"
    },
    "aps_score": 38,
    "method": "standard_bands",
    "breakdown": [
      {
        "subject": "English Home Language",
        "subject_slug": "eng_hl",
        "aps_category": "language",
        "percentage": 78,
        "points": 6
      },
      {
        "subject": "Mathematics",
        "subject_slug": "math",
        "aps_category": "mathematics",
        "percentage": 82,
        "points": 7
      }
    ],
    "notes": null
  }
}

Ready to start building?

Free plan includes access to this endpoint. No credit card required.

Get started free