Lineups

Lineups by postal code

/lineups

Returns information about television providers and channel lineups available in a specific geographic area. Current coverage includes USA, Canada, Europe, Latin America, and Caribbean countries. Lineup details include information about service providers, service type, and location.

Request Parameters

Parameter	Mandatory?	Description
country	No	Country abbreviation for provider location. Follows ISO 3166-1 alpha-3 standard. If not provided, defaults to USA. Valid country values are as shown below.
postalCode	Yes	Postal code identifying geographic area of service
api_key	Yes	24-character key obtained during application registration

Response Body

Response | Description

type | type of service (e.g., Cable, Satellite, MVPD, OTA)
lineupId | alphanumeric id which can be used to specify lineup in other API calls
name | name of provider and service (e.g., Comast NE Chicago - Digital (Chicago) )
device | service provider designation for device type
location | city name for service area; this field also appended to name (in parentheses)
mso | multi-system operator (cable or satellite provider), will not be present for small or independent providers; can be used for grouping lineups in display
id | numeric MSO (multi-system operator) id
name | MSO name

Country codes available for lineups

North America

• USA (United States)
• CAN (Canada) Asia-Pacific
• AUS (Austrialia) | Europe
• AUT (Austria)
• BEL (Belgium
• CHE (Switzerland)
• DEU (Germany)
• DNK (Denmark)
• ESP (Spain)
• FIN (Finland)
• FRA (France)
• GBR (United Kingdom)
• IRL (Ireland)
• ITA (Italy)
• NLD (The Netherlands)
• NOR (Norway)
• POL (Poland)
• SWE (Sweden)

Latin America

• ARG (Argentina)
• BLZ (Belize)
• BRA (Brazil)
• CHL (Chile)
• COL (Colombia)
• CRI (Costa Rica)
• ECU (Ecuador)
• GTM (Guatemala)
• GUY (Guyana)
• HND (Honduras)
• MEX (Mexico)
• PAN (Panama)
• PER (Peru)
• URY (Uruguay)
• VEN (Venezuela) | Caribbean
• AIA (Anguilla)
• ATG (Antigua/Barbuda)
• ABW (Aruba)
• BHS (Bahamas)
• BRB (Barbados)
• BMU (Bermuda)
• BES (Bonaire, Saba, St. Eustatius)
• VGB (British Virgin Islands)
• CYM (Cayman Islands)
• CUW (Curacao)
• DMA (Dominica)
• DOM (Dominican Republic)
• GRD (Grenada)
• JAM (Jamaica)
• PRI (Puerto Rico)
• MAF (Saint Martin)
• VCT (Saint Vincent/Grenadines)
• KNA (St. Kitts)
• LCA (St. Lucia)
• TTO (Trinidad and Tobago)
• TCA (Turks and Caicos)

Sample Request 1

Return all available lineups in US postal code 27713.

http://data.tmsapi.com/v1.1/lineups?country=USA&postalCode=27713&api_key=1234567890

Sample Request 2

Return all available lineups in UK postal code OX 1.

http://data.tmsapi.com/v1.1/lineups?country=GBR&postalCode=OX1&api_key=1234567890

Sample Response 1

Code
 
    [
      {
        "lineupId": "USA-OTA27713", 
        "name": "Local Over the Air Broadcast", 
        "type": "OTA"
      }, 
      {
        "device": "X", 
        "lineupId": "USA-NC67566-X", 
        "location": "Cary", 
        "mso": {
          "id": "17304", 
          "name": "AT&T U-verse TV"
        }, 
        "name": "AT&T U-verse TV Digital", 
        "type": "CABLE"
      }, 
      {
        "device": "DEFAULT", 
        "lineupId": "USA-NC66712-DEFAULT", 
        "location": "Durham", 
        "name": "Campus Crossing Durham - Cable", 
        "type": "CABLE"
      }, 
      {
        "device": "DEFAULT", 
        "lineupId": "USA-DITV560-DEFAULT", 
        "location": "Raleigh", 
        "mso": {
          "id": "17580", 
          "name": "DIRECTV"
        }, 
        "name": "DIRECTV Raleigh - Satellite", 
        "type": "SATELLITE"
      }, 
      {
        "device": "DEFAULT", 
        "lineupId": "USA-NC32461-DEFAULT", 
        "location": "Durham", 
        "mso": {
          "id": "08670", 
          "name": "Time Warner Cable"
        }, 
        "name": "Time Warner Cable - Cable", 
        "type": "CABLE"
      }, 
      {
        "device": "DEFAULT", 
        "lineupId": "USA-DITV-DEFAULT", 
        "location": "USA", 
        "mso": {
          "id": "17580", 
          "name": "DIRECTV"
        }, 
        "name": "DIRECTV - Satellite", 
        "type": "SATELLITE"
      },
      ... additional lineups ... 
    ]

### Sample Response 2
    
    [
      {
        "type":"OTA",
        "lineupId":"GBR-OTAOX1",
        "name":"Local"
      },
      {
        "type":"CABLE",
        "device":"X",
        "lineupId":"GBR-0000066-X",
        "name":"Virgin Media Oxford Digital",
        "location":"Oxford",
        "mso":{
          "id":"0000101",
          "name":"Virgin Media"
        }
      },
      {
        "type":"CABLE",
        "device":"DEFAULT",
        "lineupId":"GBR-0001207-DEFAULT",
        "name":"Freeview - Central (South) - Cable",
        "location":"London",
        "mso":{
          "id":"0000100",
          "name":"Freeview"
        }
      }
    ]