get
https://api-v2.pandavideo.com.br/user/limit/sub_accounts_usage
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
GET /user/limit/sub_accounts_usage
Returns usage and limits for every sub-account linked to the authenticated parent account. This is the primary endpoint for monitoring your sub-account portfolio.
AuthorizationOnly parent accounts (
has_sub_accounts = true) can call this endpoint (get-subaccountpermission). Sub-accounts are resolved automatically from the parent token; no query params are needed.
HTTP Method & Path
GET /user/limit/sub_accounts_usage
Base URL: https://api-v2.pandavideo.com.br
Authentication Requirements
- Security Scheme:
PandaAuth(apiKey) - Header:
Authorization: <your_api_token>(no Bearer prefix)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization | header | string | Yes | Your parent account API token |
No query parameters or request body are required.
Response
Success Response (200)
Returns an object with the sub_accounts array plus portfolio totals:
{
"sub_accounts": [
{
"user_id": "uuid",
"organization_name": "Academia XYZ",
"organization_id": "uuid",
"library_id": "uuid",
"storage": 250,
"storage_plan": 1000,
"traffic": 3500,
"traffic_plan": 10000,
"videos": 40,
"videos_plan": 500,
"traffic_drm": 0,
"traffic_drm_plan": 0,
"live_keys": [],
"credits_ai": { "balance": 0, "consumed": 0, "total": 0 },
"usage_percentage": { "storage": 25, "traffic": 35, "videos": 8 },
"status": "active",
"updated_at": "2026-01-01T00:00:00.000Z",
"last_canceled_at": null,
"last_blocked_at": null,
"has_api_key": true
}
],
"total_sub_accounts": 1,
"total_lives_plan": 5,
"used_live_keys": 2
}Response Schema
Top level:
| Field | Type | Description |
|---|---|---|
sub_accounts | array | One usage object per sub-account (see below) |
total_sub_accounts | number | Number of sub-accounts |
total_lives_plan | number | Total live slots available in the parent plan |
used_live_keys | number | Live stream keys currently in use across the account |
Each sub_accounts[] item:
| Field | Type | Description |
|---|---|---|
user_id | string (uuid) | null | Sub-account root user |
organization_name | string | Sub-account name |
organization_id | string (uuid) | Sub-account organization ID |
library_id | string (uuid) | null | Sub-account library |
storage / storage_plan | number | Storage used / limit |
traffic / traffic_plan | number | Bandwidth used / limit |
videos / videos_plan | number | Videos used / limit |
traffic_drm / traffic_drm_plan | number | DRM bandwidth used / limit |
live_keys | array | The sub-account's live stream keys |
credits_ai | object | { balance, consumed, total } |
usage_percentage | object | { storage, traffic, videos } percentages |
status | string | Sub-account status |
updated_at | string | null | Last usage update |
last_canceled_at / last_blocked_at | string | null | Lifecycle timestamps |
has_api_key | boolean | Whether the sub-account has an API key |
If the parent has no sub-accounts, the response is{ "sub_accounts": [], "total_sub_accounts": 0 }. Sub-accounts inerror/creatingreturn a zeroed variant (withoutlast_*/has_api_key).
Error Responses
- 400 Bad Request —
"Access denied. Only parent accounts can access this endpoint."(returned when the account is not a parent). - 401 Unauthorized — Invalid or missing API token.
- 404 Not Found — the account has no Library.
- 500 Internal Server Error — Server error.
Example Usage
cURL
curl -X GET \
'https://api-v2.pandavideo.com.br/user/limit/sub_accounts_usage' \
-H 'Authorization: your_api_token_here'Bad Request
Unauthorized
Not Found
Internal Server Error