List Your Public Channels

List channels for username with HTTP GET

Request

HTTP Method

GET

URL

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

URL Parameters

NameDescription

<user_id>

(Required) User ID for the channels of interest.

<format>

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

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

Query String Parameters

NameDescriptionValue Type
tag

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

string

Response

Success

HTTP Status Code

200 OK

Body
GET https://api.thingspeak.com/users/iothans/channels.json

The response is a JSON array of channel settings, for example:

{
"channels": [
{
"id": 3,
"name": "ioBridge Server",
"description": "ioBridge IO-204 connected to web server to report temperatures to ThingSpeak",
"latitude": "0.0",
"longitude": "0.0",
"created_at": "2010-12-03T14:26:23Z",
"elevation": "",
"last_entry_id": 365190,
"public_flag": true,
"url": "https://www.iobridge.com",
"ranking": 85,
"tags": [
{
"id": 24,
"name": "temperature"
},
{
"id": 317,
"name": "iobridge"
}
]
},
{
"id": 25,
"name": "light"
},
{
"id": 3,
"name": "sensor"
}
]
},
{
"id": 212,
"name": "Digital Step Demo",
"description": "",
"latitude": "0.0",
"longitude": "0.0",
"created_at": "2011-03-29T20:05:20Z",
"elevation": "",
"last_entry_id": 8,
"public_flag": true,
"url": "",
"ranking": 15,
"tags": []
}
]
}
GET https://api.thingspeak.com/users/iothans/channels.xml

The response is an XML array of channel settings, for example:

<response>
<channels type="array">
<channel>
<id type="integer">3</id>
<name>ioBridge Server</name>
<description>
ioBridge IO-204 connected to web server to report temperatures to ThingSpeak
</description>
<latitude type="decimal">0.0</latitude>
<longitude type="decimal">0.0</longitude>
<created-at type="dateTime">2010-12-03T14:26:23Z</created-at>
<elevation/>
<last-entry-id type="integer">365191</last-entry-id>
<public-flag type="boolean">true</public-flag>
<url>https://www.iobridge.com</url>
<ranking type="integer">85</ranking>
<tags type="array">
<tag>
<id type="integer">24</id>
<name>temperature</name>
</tag>
<tag>
<id type="integer">317</id>
<name>iobridge</name>
</tag>
</tags>
</channel>
<channel>
<id type="integer">212</id>
<name>Digital Step Demo</name>
<description/>
<latitude type="decimal">0.0</latitude>
<longitude type="decimal">0.0</longitude>
<created-at type="dateTime">2011-03-29T20:05:20Z</created-at>
<elevation/>
<last-entry-id type="integer">8</last-entry-id>
<public-flag type="boolean">true</public-flag>
<url/>
<ranking type="integer">15</ranking>
<tags type="array"/>
</channel>
</response>

Error

For the full list, see Error Codes.

See Also

| | |

Topics