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:

Method Example Required
Bearer token Authorization: Bearer YOUR_IPTV_API_KEY Recommended
Query parameter ?api_key=YOUR_IPTV_API_KEY Supported

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"
}