UniApplyForMe Labs

Examples

Editable, runnable recipes. Tweak the parameters, run them against api.labs.org.za with your own token, and copy the code into your app.

University search

Search the 26 public universities by name and filter by province for a directory or picker.

GET/v1/data/universitiesuniversities:read

Paginated list of the 26 public universities.

Query parameters

GET /v1/data/universities?search=Cape+Town&page=1&per_page=20

Code

curl "https://api.labs.org.za/v1/data/universities?search=Cape+Town&page=1&per_page=20" \
  -H "Authorization: Bearer labs_sandbox_your_token_here"

Response

Run the request to see a live response.

High school lookup

Build a province-aware high school selector backed by the EMIS directory.

GET/v1/data/high-schoolshigh_schools:read

The EMIS high school directory (8,000+ schools).

Query parameters

GET /v1/data/high-schools?search=Pretoria&province=Gauteng&page=1&per_page=20

Code

curl "https://api.labs.org.za/v1/data/high-schools?search=Pretoria&province=Gauteng&page=1&per_page=20" \
  -H "Authorization: Bearer labs_sandbox_your_token_here"

Response

Run the request to see a live response.

Postal code autocomplete

Resolve suburb, street code, and box code for address forms.

GET/v1/data/postal-codespostal_codes:read

Suburb, street code, and box code lookup.

Query parameters

GET /v1/data/postal-codes?search=Sandton&page=1&per_page=20

Code

curl "https://api.labs.org.za/v1/data/postal-codes?search=Sandton&page=1&per_page=20" \
  -H "Authorization: Bearer labs_sandbox_your_token_here"

Response

Run the request to see a live response.

Programme finder

Search qualifications by name and NQF level to power a course explorer.

GET/v1/data/qualificationsqualifications:read

Degree and diploma programmes with NQF levels and APS requirements.

Query parameters

GET /v1/data/qualifications?search=Computer+Science&page=1&per_page=20

Code

curl "https://api.labs.org.za/v1/data/qualifications?search=Computer+Science&page=1&per_page=20" \
  -H "Authorization: Bearer labs_sandbox_your_token_here"

Response

Run the request to see a live response.

Bursary finder

Surface bursaries and scholarships with closing dates and eligibility.

GET/v1/data/bursariesbursaries:read

Bursaries and scholarships with closing dates and eligibility.

Query parameters

GET /v1/data/bursaries?search=engineering&page=1&per_page=20

Code

curl "https://api.labs.org.za/v1/data/bursaries?search=engineering&page=1&per_page=20" \
  -H "Authorization: Bearer labs_sandbox_your_token_here"

Response

Run the request to see a live response.

APS calculator

Compute a university-specific APS score from a set of subject results.

POST/v1/data/aps-calculatoraps_calculator:use

University-specific APS score for a set of subject results.

university_slug plus a marks array of { subject_slug, percentage (0 to 100) }. All identifiers are slugs (for example university_slug "cput" and subject_slug "eng_hl", "math", "phsc"). Get subject_slug values from GET /v1/data/subjects.

subject_slug values come from GET /v1/data/subjects.

POST /v1/data/aps-calculator

Code

curl -X POST "https://api.labs.org.za/v1/data/aps-calculator" \
  -H "Authorization: Bearer labs_sandbox_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
  "university_slug": "cput",
  "marks": [
    { "subject_slug": "eng_hl", "percentage": 80 },
    { "subject_slug": "math", "percentage": 75 },
    { "subject_slug": "phsc", "percentage": 65 }
  ]
}'

Response

Run the request to see a live response.