https://github.com/devsoc-unsw/calendar
A simple API to fetch key UNSW academic calendar dates
https://github.com/devsoc-unsw/calendar
api calendar fastify notangles typescript unsw
Last synced: about 1 month ago
JSON representation
A simple API to fetch key UNSW academic calendar dates
- Host: GitHub
- URL: https://github.com/devsoc-unsw/calendar
- Owner: devsoc-unsw
- License: apache-2.0
- Created: 2025-11-07T03:02:08.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-11-08T15:17:59.000Z (8 months ago)
- Last Synced: 2025-11-08T17:22:28.583Z (8 months ago)
- Topics: api, calendar, fastify, notangles, typescript, unsw
- Language: TypeScript
- Homepage:
- Size: 40 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# UNSW Academic Calendar API
This repo contains a basic API to fetch UNSW term dates, scraping for updates on a daily basis directly from UNSW.
## Endpoints
- `GET /v1/dates/:year`: Fetches the term dates for the specified year.
```json5
// Example response for GET /v1/dates/2025
{
U1: {
teaching_period: {
start: "2025-01-06",
end: "2025-02-07",
},
exams: {
start: "2025-02-08",
end: "2025-02-10",
},
},
T1: {
o_week: {
start: "2025-02-10",
end: "2025-02-14",
},
teaching_period: {
start: "2025-02-17",
end: "2025-04-24",
},
flex_week: {
start: "2025-03-24",
end: "2025-03-30",
},
study_period: {
start: "2025-04-26",
end: "2025-05-01",
},
exams: {
start: "2025-05-02",
end: "2025-05-15",
},
},
T2: {
o_week: {
start: "2025-05-26",
end: "2025-05-30",
},
teaching_period: {
start: "2025-06-02",
end: "2025-08-08",
},
flex_week: {
start: "2025-07-07",
end: "2025-07-13",
},
study_period: {
start: "2025-08-09",
end: "2025-08-14",
},
exams: {
start: "2025-08-15",
end: "2025-08-28",
},
},
T3: {
o_week: {
start: "2025-09-08",
end: "2025-09-12",
},
teaching_period: {
start: "2025-09-15",
end: "2025-11-21",
},
flex_week: {
start: "2025-10-20",
end: "2025-10-26",
},
study_period: {
start: "2025-11-22",
end: "2025-11-27",
},
exams: {
start: "2025-11-28",
end: "2025-12-11",
},
},
}
```