Get calendar
Episodes of your shows airing in the coming days.
GET https://cotlet.dev/api/v1/trakt/calendar
read
Returns the episodes airing from a start date for a number of days, in air order, with show, season, episode and air time in UTC. Your calendar covers shows you watched or watchlisted, minus hidden shows. A call covers at most 33 days.
Parameters
| Name | Type | Description |
|---|---|---|
| start_date date | date | First day, YYYY-MM-DD. Default: today. |
| days integer | integer | 1 to 33. Default: 7. |
Request
curl https://cotlet.dev/api/v1/trakt/calendar \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("trakt", "get_calendar")const result = await cotlet.call('trakt', 'get_calendar');cotlet call trakt get_calendarExample response
{
"days": [
{
"date": "2026-10-19",
"episodes": [
{
"show": "Slow Horses",
"season": 5,
"episode": 1,
"title": "Cold Open",
"first_aired": "2026-10-19T01:00:00Z"
}
]
},
{
"date": "2026-10-21",
"episodes": [
{
"show": "Severance",
"season": 3,
"episode": 4,
"title": "The Long Floor",
"first_aired": "2026-10-21T01:00:00Z"
}
]
}
]
}