Contents
On this page

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