---
title: "Get user calendar in iCal format"
method: GET
path: "/calendar/ical/{userId}"
tags: ["Calendar"]
---

# Get user calendar in iCal format

`GET /calendar/ical/{userId}`

Retrieve user's calendar data in iCalendar format

## Path parameters

- `userId` string, required

## Query parameters

- `token` string, required
- `type` 'basic' | 'full'

## Response `200`

iCalendar data

## Other responses

- `400` — Missing calendar share token
- `404` — User not found

## Changes

- **2026-07-17** `414e7e5c2028` — 1 breaking, 1 warning
  - added the new required `query` request parameter `token`
  - deleted the `query` request parameter `key`
- **2025-09-05** `db38717cf6d6` — 1 warning, 1 info
  - deleted the `query` request parameter `token`
  - added the new optional `query` request parameter `key`

[Change history](https://skmtc.dev/nthumodifications/apis/nthu-mods-api/changes/calendar/ical/:userId/get.md)

---

[API](https://skmtc.dev/nthumodifications/apis/nthu-mods-api.md) · [All operations](https://skmtc.dev/nthumodifications/apis/nthu-mods-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nthumodifications/nthu-mods-api/revisions/414e7e5c2028/schema)