Contents
Watch History - Plugixa Stream
GET /plugixa-stream/v1/me/history
Every episode the caller has progress in, most recently watched first.
Any signed-in user (an Application Password, or the login cookie with an X-WP-Nonce header). Signed out, it answers 401 plugixa_stream_login_required. It always acts on the caller’s own account.
Request
GET https://your-site.example/wp-json/plugixa-stream/v1/me/history?per_page=10
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
page |
integer |
No | Page to return, from 1. Defaults to 1. |
per_page |
integer |
No | Entries per page, 1 to 100. Defaults to 24. |
Responses
200 OK. data is a list of entries.
{
"success": true,
"data": [
{
"series": {
"id": 2814,
"slug": "flash-gordon",
"kind": "series",
"year": 1936,
"title": "Flash Gordon",
"poster": "https://your-site.example/wp-content/uploads/2026/10/flash-gordon-1936-poster-768x1165.jpg",
"genres": ["Action", "Adventure", "Sci-Fi"],
"episode_count": 13,
"duration": 0,
"release_status": "completed",
"url": "https://your-site.example/series/flash-gordon/",
"watch_url": "https://your-site.example/watch/#/series/2814"
},
"episode": {
"id": 2816,
"series_id": 2814,
"number": 2,
"season": 1,
"title": "Chapter 2: The Tunnel of Terror",
"duration": 1147,
"thumbnail": "",
"free": true,
"locked": false
},
"position": 312,
"completed": false,
"watched_at": "2026-11-17 08:41:20"
}
]
}
| Field | Type | Meaning |
|---|---|---|
data[].series |
object |
The title card |
data[].episode |
object |
The episode with its lock state |
data[].position |
integer |
Seconds |
data[].completed |
boolean |
Finished |
data[].watched_at |
string |
Last saved, UTC, Y-m-d H:i:s |
There is no meta: ask for the next page until one comes back shorter than per_page. Entries of titles that are no longer published are skipped, so a page can be shorter.
Errors
| Status | Code | When |
|---|---|---|
401 |
plugixa_stream_login_required |
Signed out. |
400 |
rest_invalid_param |
per_page is outside 1 to 100. |
Plus the errors every endpoint can return.
Examples
curl -s "https://your-site.example/wp-json/plugixa-stream/v1/me/history?per_page=10" \
-u "$WP_USER:$WP_APP_PASSWORD"
<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-stream/v1/me/history?per_page=10');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_USERPWD => getenv('WP_USER') . ':' . getenv('WP_APP_PASSWORD'),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
const response = await fetch('https://your-site.example/wp-json/plugixa-stream/v1/me/history?per_page=10', {
headers: {
'Authorization': `Basic ${btoa(`${process.env.WP_USER}:${process.env.WP_APP_PASSWORD}`)}`,
},
});
const { data } = await response.json();
Quick Links
Share