Get watch history
What you watched and when, newest first.
GET https://cotlet.dev/api/v1/trakt/history
read
Returns your watch history in pages, newest first, with the date of each play. A title watched twice appears twice. Filter by type or by a start and end date to check a batch you logged.
Parameters
| Name | Type | Description |
|---|---|---|
| type string | string | Only this kind of title: 'movies', 'shows', 'seasons' or 'episodes'. Default: all. |
| start_at datetime | datetime | Only plays after this time. |
| end_at datetime | datetime | Only plays before this time. |
| page integer | integer | Page number, starting at 1. Default: 1. |
| limit integer | integer | Items per page. Default: 20. |
Request
curl https://cotlet.dev/api/v1/trakt/history \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("trakt", "get_history")const result = await cotlet.call('trakt', 'get_history');cotlet call trakt get_historyExample response
{
"items": [
{
"type": "episode",
"show": "Slow Horses",
"season": 4,
"episode": 3,
"title": "Hello Goodbye",
"watched_at": "2026-10-10T21:40:00Z"
},
{
"type": "movie",
"title": "Perfect Days",
"year": 2023,
"watched_at": "2026-10-06T19:30:00Z"
}
],
"page": 1,
"total_pages": 4
}