List Your Channels

List your channels with HTTP GET

Request

HTTP Method

GET

URL

https://api.thingspeak.com/channels.<format>

Input Arguments

NameDescription

<format>

(Required) Format for the HTTP response, specified as json or xml.

Example: https://api.thingspeak.com/channels.json

Query String Parameters

NameDescriptionValue Type
api_key

(Required) Specify User API Key, which you can find in your profile. This key is different from the channel API keys.

string

tag

(Optional) Specify a tag to search for in your channels.

string

Content-Type

application/x-www-form-urlencoded

Response

Success

HTTP Status Code

200 OK

Body
GET https://api.thingspeak.com/channels.json?api_key=XXXXXXXXXXXXXXXX

The response is a JSON object of your channels and has the license_id tag, if you are using a paid account. For example:

[
  {
    "id": 9,
    "name": "my_house",
    "description": "Netduino Plus connected to sensors around the house",
    "latitude": "40.44",
    "longitude": "-79.996",
    "created_at": "2010-12-13T20:20:06-05:00",
    "elevation": "",
    "last_entry_id": 6062691,
    "public_flag": true
    "url": ""
    "ranking" :100,
    "metadata": "",
    "license_id": 40526371,
    "tags": [
        {
          "id": 9,
          "name": "temp"
        },
        {
          "id": 25,
          "name": "light"
        },
        {
          "id": 3,
          "name": "sensor"
        }
     ]
    "api_keys":
    [
      {
        "api_key": "XXXXXXXXXXXXXXXX",
        "write_flag": true
      }
      {
        "api_key": "YYYYYYYYYYYYYYYY",
        "write_flag": false
      }    
    ]
  },
  {
    "id": 5683,
    "name": "Residential Data Points",
    "description": "Connected Arduino",
    "latitude": "32.664548",
    "longitude": "-73.654972",
    "created_at": "2013-05-15T12:33:57-04:00",
    "elevation": "100",
    "last_entry_id": 731713,
    "public_flag": true
    "url": ""
    "ranking": 100,
    "metadata": "",
    "license_id": 40526371,
    "tags": [],
    "api_keys":
    [
      {
        "api_key": "XXXXXXXXXXXXXXXX",
        "write_flag": true
      }
      {
        "api_key": "YYYYYYYYYYYYYYYY",
        "write_flag": false
      }    
    ]
  }
]
GET https://api.thingspeak.com/channels.xml?api_key=XXXXXXXXXXXXXXXX

The response is an XML object of your channels and has the license_id tag, if you are using a paid account. For example:


<?xml version="1.0" encoding="UTF-8"?>
<channels type="array">
  <channel>
    <id type="integer">9</id>
    <name>my_house</name>
    <description>
    Netduino Plus connected to sensors around the house
    </description>
    <latitude type="decimal">40.44</latitude>
    <longitude type="decimal">-79.996</longitude>
    <created-at type="dateTime">2010-12-13T20:20:06-05:00</created-at>
    <elevation/>
    <last-entry-id type="integer">6062720</last-entry-id>
    <public-flag type="boolean">true</public-flag>
    <url/>
    <ranking type="integer">100</ranking>
    <metadata/>
    <license_id type="integer">40526371</license_id>
    <tags type="array">
        <tag>
           <id type="integer">9</id>
           <name>temp</name>
       </tag>
       <tag>
          <id type="integer">25</id>
          <name>light</name>
       </tag>
       <tag>
          <id type="integer">3</id>
          <name>sensor<name>
       </tag>
    </tags>
    <api-keys type="array">
        <api-key>
            <api-key>XXXXXXXXXXXXXXXX</api-key>
            <write-flag type="boolean">true</write-flag>
        </api-key>
        <api-key>
            <api-key>YYYYYYYYYYYYYYYY</api-key>
            <write-flag type="boolean">false</write-flag>
        </api-key>
    </api-keys>
  </channel>
  <channel>
    <id type="integer">5683</id>
    <name>Residential Data Points</name>
    <description>Connected Arduino</description>
    <latitude type="decimal">32.664548</latitude>
    <longitude type="decimal">-73.654972</longitude>
    <created-at type="dateTime">2013-05-15T12:33:57-04:00</created-at>
    <elevation>100</elevation>
    <last-entry-id type="integer">731720</last-entry-id>
    <public-flag type="boolean">true</public-flag>
    <url/>
    <ranking type="integer">100</ranking>
    <metadata/>
    <license_id type="integer">40526371</license_id>
    <tags type="array" />
    <api-keys type="array">
        <api-key>
            <api-key>XXXXXXXXXXXXXXXX</api-key>
            <write-flag type="boolean">true</write-flag>
        </api-key>
        <api-key>
            <api-key>YYYYYYYYYYYYYYYY</api-key>
            <write-flag type="boolean">false</write-flag>
        </api-key>
    </api-keys>
  </channel>
</channels>

Error

For the full list, see Error Codes.

See Also

Functions

Topics