List Channels

List Channels: Returns active IPTV channels available to the authenticated subscription. Supports filtering by country, type, and search keyword.

Endpoint:GET /channels

Query Parameters:

  • country (optional, string): Filter by country name, e.g. United States.
  • type (optional, string): Filter by category/type, e.g. News.
  • search (optional, string): Search by channel name.
  • per_page (optional, integer): Page size. Defaults to 50, maximum 200.
  • page (optional, integer): Pagination page number.

Example Request (Bearer Auth):

curl -X GET "https://umva.net/api/iptv/channels?country=United%20States&type=News&per_page=25" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_IPTV_API_KEY"

Example Request (Query Param Auth):

curl "https://umva.net/api/iptv/channels?api_key=YOUR_IPTV_API_KEY&search=cnn&per_page=10"

Success Response Example (HTTP 200):

{
"success": true,
"data": [
{
"channel_id": "7a06cb8a-0e97-4d49-9efa-111111111111",
"channel_name": "CNN",
"channel_url": "https://umva.net/api/iptv/stream/7a06cb8a-0e97-4d49-9efa-111111111111?api_key=YOUR_IPTV_API_KEY",
"channel_url_type": "HLS",
"channel_country": "United States",
"channel_type": "News",
"channel_thumb": "https://example.com/cnn-logo.png"
}
],
"meta": {
"current_page": 1,
"last_page": 12,
"per_page": 25,
"total": 289,
"subscription_status": "active",
"subscription_expires_at": "2026-08-03T10:30:00+00:00"
}
}

Notes:

  • The returned channel_url is not the raw source URL; it is a UMVA-controlled stream proxy endpoint.
  • Use the pagination data in meta to iterate over large channel catalogs.
  • Combine filters as needed, for example country + type + search.