Authentication & Headers

UMVA IPTV API Authentication

The IPTV API uses a subscription-specific API key. Each active IPTV subscription has its own key, and requests are allowed only while that subscription remains active.

How to get your API key:

  • Go to your IPTV dashboard in your UMVA user account.
  • Open a subscription from /user/iptv/subscription/{id}.
  • Copy the displayed API key or regenerate it if needed.

Supported authentication methods:

MethodExampleRequired
Bearer tokenAuthorization: Bearer YOUR_IPTV_API_KEYRecommended
Query parameter?api_key=YOUR_IPTV_API_KEYSupported

Base URL:https://umva.net/api/iptv

Standard headers:

  • Accept: application/json
  • Authorization: Bearer YOUR_IPTV_API_KEY (recommended)

Authentication failure responses:

{
"success": false,
"message": "API key is required. Provide via Authorization: Bearer header or ?api_key= query param."
}
{
"success": false,
"message": "Invalid API key."
}
{
"success": false,
"message": "Subscription is expired. Please renew your subscription.",
"status": "expired",
"expires_at": "2026-08-03T10:30:00+00:00"
}