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.