Getting Started with uicAPI

Welcome to the uicAPI Documentation! Here you will find everything you need to get started with our API and access data programmatically. (Currently only supports CS classes)

Base URL

All API requests start with the following base URL:

https://uic-api.xyz/api/v1

Authentication

To access the API, you must include your API key in the request headers. If you don't have an API key yet, sign up on the Developer Dashboard and generate one.

Header: Authorization: Bearer YOUR_API_KEY

Endpoints

1. Get Class Data

  • URL: /api/v1/courses
  • Method: GET
  • Description: Retrieve a list of all classes. 'DEP' is can only equal to CS (as of now)
GET https://uic-api.xyz/api/v1/courses/{DEP}
      Authorization: Bearer YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY

2. Get Specific Class

  • URL: /api/v1/courses/{crn}
  • Method: GET
  • Description: Retrieve details for a specific class by its CRN.
GET https://uic-api.xyz/api/v1/courses/{CRN}
  Authorization: Bearer YOUR_API_KEY

Error Codes

Here are the common errors you may encounter:

  • 400: Bad Request - Your request is invalid or missing required parameters.
  • 401: Unauthorized - Your API key is missing or invalid.
  • 404: Not Found - The requested resource does not exist.
  • 500: Internal Server Error - An error occurred on the server.

Support

If you have any questions or issues, contact our support team: