LIU Exams API

Retrieve results for LiU exams and other assignments.

Documentation

Rate limit: 500 requests per minute.

If there are too many unique requests, the upstream LiU API rate limit may be hit. This is expected; you should still be able to retrieve the course within about one minute.

All courses are cached for 24 hours from the time you first request them. This reduces the number of requests sent to LiU’s servers.

All responses are JSON.

GET https://liutentor.lukasabbe.com/api/courses/

Returns a list of all LiU course codes.

Response:

[
  "...",
  "tata24",
  "..."
]

GET https://liutentor.lukasabbe.com/api/courses/:courseCode

Returns results for the specified course.

Example: https://liutentor.lukasabbe.com/api/courses/TDDE35

Response:

{
  "courseCode": "TDDE35",
  "courseNameSwe": "Storskaliga distribuerade system och nätverk",
  "courseNameEng": "Large-Scale Distributed Systems and Networks",
  "lastUpdatedTimestamp": "1744731431257.0",
  "modules": [
    "...",
    {
      "moduleCode": "TEN1",
      "date": "2025-03-24T00:00:00Z",
      "grades": [
        {
          "grade": "5",
          "gradeOrder": 1,
          "quantity": 2
        },
        {
          "grade": "4",
          "gradeOrder": 2,
          "quantity": 9
        },
        {
          "grade": "3",
          "gradeOrder": 3,
          "quantity": 6
        },
        {
          "grade": "U",
          "gradeOrder": 4,
          "quantity": 12
        }
      ]
    },
    "..."
  ]
}

GET https://liutentor.lukasabbe.com/api/courses/bulk/:courseCodes

Fetch results for multiple courses in a single request.

Parameter: courseCodes is a comma-separated list of course codes (case-insensitive). Maximum 5 codes per request. Excess whitespace is ignored and duplicates are removed.

Example:

GET https://liutentor.lukasabbe.com/api/courses/bulk/TDDE35,TATA24

Response (array of course objects – same shape as the single course endpoint):

[
  {
    "courseCode": "TDDE35",
    "courseNameSwe": "…",
    "courseNameEng": "…",
    "lastUpdatedTimestamp": "1744731431257.0",
    "modules": [
      {
        "moduleCode": "TEN1",
        "date": "2025-03-24T00:00:00Z",
        "grades": [
          { "grade": "5", "gradeOrder": 1, "quantity": 2 },
          { "grade": "4", "gradeOrder": 2, "quantity": 9 },
          { "grade": "3", "gradeOrder": 3, "quantity": 6 },
          { "grade": "U", "gradeOrder": 4, "quantity": 12 }
        ]
      }
    ]
  },
  {
    "courseCode": "TATA24",
    "courseNameSwe": "…",
    "courseNameEng": "…",
    "lastUpdatedTimestamp": "1744731431257.0",
    "modules": ["..."]
  }
]

Rate limiting still counts each HTTP request (not per course). Keep bulk lists small for best performance.