Quickstart

Make your first API call in under 5 minutes.

1. Get a token from the dashboard

Sign up for a free account, no credit card required. Then open your Tokens page, click New token, choose a name, and select the scopes you need. Copy the token immediately: it is only shown once.

2. Make your first request

Pass your token in the Authorization header as a bearer token. The endpoint below requires the universities:read scope (Starter plan and above).

curl https://api.labs.org.za/v1/data/universities \
  -H "Authorization: Bearer labs_live_your_token_here"

3. Handle the response

All list endpoints return a data array and a meta object with pagination info. Use ?page=2 and ?per_page=20 to paginate.

{
  "data": [
    {
      "id": "7bdd6ee4-e5ba-48b1-8fa9-de3f4defc5cc",
      "name": "University of the Western Cape",
      "short_name": "UWC",
      "website_url": "https://www.uwc.ac.za",
      "logo_url": "https://assets.apply.org.za/20240302021930/1200px-UWC_logo.svg.png",
      "province_name": "Western Cape"
    }
    // ... more universities
  ],
  "meta": {
    "total": 26,
    "page": 1,
    "per_page": 20
  }
}

Next: read the Authentication guide to understand token types and scopes, or browse the API Reference for every available endpoint.