Read Last Status

Read last status of channel with HTTP GET

Request

HTTP Method

GET

URL

https://api.thingspeak.com/channels/<channel_id>/status/last.<format>

URL Parameters

Name	Description
<channel_id>	(Required) Channel ID for the channel of interest.
<format>	(Required) Format for the HTTP response, specified as json, xml, csv, or txt.

Example: https://api.thingspeak.com/channels/266256/status/last.json

Query String Parameters

Name	Description	Value Type
api_key	(Required for private channels) Specify Read API Key for this specific channel. The Read API key is found on the API Keys tab of the channel view.	string

Examples

You can use your web browser to complete GET HTTP requests to the RESTful API for ThingSpeak™. To see the format for an HTTP response, click the link or copy it to your browser.

Read Last Status in JSON Format

Channel 276330 stores soil moisture information for an office plant. You can read data from this public channel. The format for the response occurs at the end of the URL, before any query string parameters. This example returns the last status entry from channel 9 in JSON format.

https://api.thingspeak.com/channels/276330/status/last.json

Read Last Status of Office Plant Channel in XML Format

Channel 276330 stores soil moisture information for an office plant. Use the extension XML on the request to return the last status in XML format.

https://api.thingspeak.com/channels/276330/status/last.xml

Read Last Status from a Private Channel in JSON Format

To read data from a private channel, supply the Read API Key after the parameter api_key. Append the first parameter after a question mark ?.

https://api.thingspeak.com/channels/276330/status/last.json?api_key=E52AWRAV1RSXQQJW

Response

Success

HTTP Status Code

200 OK

Body

 JSON Example

GET https://api.thingspeak.com/channels/9/status/last.json

The response is a JSON object of the most recent status, for example: { "created_at": "2018-01-25T20:05:28Z", "entry_id": 8153, "status": "Penny" }

 XML Example

GET https://api.thingspeak.com/channels/9/status/last.xml

The response is an XML object of the most recent status, for example: <feed> <created-at type="dateTime">2018-01-25T20:05:28Z</created-at> <entry-id type="integer">8153</entry-id> <status>Penny</status> <id type="integer" nil="true"/> </feed>

 Text Example

GET https://api.thingspeak.com/channels/9/status/last.text

The response is the most recent status, for example: Penny

Error

For the full list, see Error Codes.

If you do not have access to the channel, the response is -1.