Contents
Get Viewer - Plugixa Stream
GET /plugixa-stream/v1/admin/viewers/{id}
Everything about one account’s money: balance, the last 100 coin movements, up to 200 unlocks, every VIP plan and the last 50 orders.
Needs a user with the plugixa_stream_manage_settings capability (signed in with an Application Password or the login cookie). Administrators hold it; other roles only when you grant it.
Request
GET https://your-site.example/wp-json/plugixa-stream/v1/admin/viewers/7
Path parameters
| Name | Type | Description |
|---|---|---|
id |
integer |
The user id |
Responses
200 OK.
{
"success": true,
"data": {
"id": 7,
"name": "Maya Lindqvist",
"email": "maya@example.com",
"balance": {
"paid": 300,
"bonus": 45,
"total": 345
},
"vip": "2026-12-16 19:03:40",
"ledger": [
{
"id": "88",
"type": "reward",
"coins_paid": "0",
"coins_bonus": "10",
"paid_after": "300",
"bonus_after": "45",
"ref_type": "checkin",
"ref_id": "0",
"note": "Daily check-in, day 3",
"created_at": "2026-11-17 07:15:02"
}
],
"unlocks": [
{
"episode_id": "2818",
"series_id": "2814",
"source": "coins",
"coins": "50",
"created_at": "2026-11-17 07:20:44",
"series_title": "Flash Gordon",
"number": 4
}
],
"subscriptions": [
{
"id": "12",
"user_id": "7",
"plan_id": "vip-month",
"gateway": "stripe",
"gateway_ref": "sub_1Q2w3e4r",
"status": "active",
"current_period_end": "2026-12-16 19:03:40",
"cancel_at_period_end": "0",
"created_at": "2026-11-16 19:03:40",
"updated_at": "2026-11-16 19:03:41"
}
],
"orders": [
{
"id": "41",
"user_id": "7",
"gateway": "stripe",
"gateway_ref": "cs_test_a1B2c3D4",
"payment_ref": "pi_3Q1x2y3z",
"product": "pack",
"product_id": "p300",
"amount": "1499",
"currency": "USD",
"coins": "300",
"bonus_coins": "30",
"coupon": "",
"discount": "0",
"trial_days": "0",
"status": "paid",
"created_at": "2026-11-16 19:02:11",
"paid_at": "2026-11-16 19:03:40"
}
]
}
}
| Field | Type | Meaning |
|---|---|---|
data.ledger |
object[] |
As in Get Coin History |
data.unlocks |
object[] |
episode_id, series_id, source (coins or bundle), coins, created_at, plus series_title and the episode number |
data.subscriptions |
object[] |
Every VIP plan, as in List Subscriptions |
data.orders |
object[] |
As in List Orders |
Plus the fields of List Viewers. The rows of the lists come as the database stores them: every value, numbers included, is a string.
Errors
| Status | Code | When |
|---|---|---|
401 / 403 |
plugixa_stream_forbidden |
The caller lacks the capability. |
404 |
plugixa_stream_not_found |
No user with that id. |
Plus the errors every endpoint can return.
Examples
curl -s "https://your-site.example/wp-json/plugixa-stream/v1/admin/viewers/7" \
-u "$WP_USER:$WP_APP_PASSWORD"
<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-stream/v1/admin/viewers/7');
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/admin/viewers/7', {
headers: {
'Authorization': `Basic ${btoa(`${process.env.WP_USER}:${process.env.WP_APP_PASSWORD}`)}`,
},
});
const { data } = await response.json();
Quick Links
Share