Listing Devices

Note Only use this API if you have 100 devices or less. Contact support for APIs for large device lists.

get
Get your device list

https://api.remot3.it/apv/v27/device/list/all
Get your list of devices.
Request
Response
Headers
developerkey
required
string
Your developer key which can be found by logging into remote.it and going to your "Account" settings page.
token
required
string
Your session token, created by logging in using the API.
200: OK
Connection with device successfully created.
{
"devices": [
{
"createdate": "2018-03-29T04:19:02.19-04:00",
"deviceaddress": "80:00:00:80:01:00:01:25",
"devicealias": "Demo_Router_Web_Port_80",
"devicelastip": "126.237.116.49",
"devicestate": "active",
"devicetype": "00:1E:00:00:00:01:00:00:04:60:00:50:00:01:00:00",
"georegion": "Asia"
"lastcontacted": "2018-12-29T14:56:50-05:00"
"lastinternalip": "10.61.12.80"
"ownerusername": "joeh@remot3.it"
"servicetitle": "Basic Web"
"shared": "shared-from"
}
],
"status": "true"
}

Note Some response values are omitted from the example above because they are only used in very specific circumstances.

Usage Examples

cURL
Node (Javascript)
Python
C#
PHP
#!/bin/sh
TOKEN="login_token"
DEVKEY="your_developer_key"
curl -H "token:$TOKEN" \
-H "developerkey:$DEVKEY" \
https://api.remot3.it/apv/v27/device/list/all
const axios = require("axios");
const developerkey = process.env.REMOTEIT_DEVELOPER_KEY;
const token = process.env.REMOTEIT_TOKEN;
axios
.get("https://api.remot3.it/apv/v27/device/list/all", {
headers: {
developerkey,
token
}
})
.then(response => {
console.log("Status Code:", response.status);
console.log("Body:", response.data);
})
.catch(error => {
console.log(error);
});
import requests
import os
headers = {
"developerkey": os.environ["REMOTEIT_DEVELOPER_KEY"],
# Created using the login API
"token": os.environ["REMOTEIT_TOKEN"]
}
url = "https://api.remot3.it/apv/v27/device/list/all"
response = requests.get(url, headers=headers)
response_body = response.json()
print("Status Code: %s" % response.status_code)
print("Raw Response: %s" % response.raw)
print("Body: %s" % response_body)
using System;
using System.Net.Http;
namespace remote.it_api_example
{
class Program
{
static void Main(string[] args)
{
string jsonString = "";
string url = "https://api.remot3.it/apv/v27/device/list/all";
HttpClient client = new HttpClient();
HttpRequestMessage requestData = new HttpRequestMessage();
// Configure the HTTP requests's url, headers, and body
requestData.Method = HttpMethod.Get;
requestData.RequestUri = new Uri(url);
requestData.Headers.Add("developerkey", Environment.GetEnvironmentVariable("REMOTEIT_DEVELOPER_KEY"));
requestData.Headers.Add("token", Environment.GetEnvironmentVariable("REMOTEIT_TOKEN"));
try
{
// Send the HTTP request and run the inner block upon recieveing a response
var response = client.SendAsync(requestData).ContinueWith((taskMessage) =>
{
var result = taskMessage.Result;
var jsonTask = result.Content.ReadAsStringAsync();
jsonTask.Wait();
// Store the body of API response
jsonString = jsonTask.Result;
});
response.Wait();
}
catch (HttpRequestException e)
{
// Triggered when the API returns a non-200 response code
jsonString = e.Message;
}
// Print JSON response from API
Console.WriteLine(jsonString);
}
}
}
<?php
$ch = curl_init();
curl_setopt_array($ch, array(
CURLOPT_URL => "https://api.remot3.it/apv/v27/device/list/all",
CURLOPT_HTTPHEADER => array(
"developerkey: ".$_ENV["REMOTEIT_DEVELOPER_KEY"],
"token: ".$_ENV["REMOTEIT_TOKEN"] // Created using the login API
),
CURLOPT_RETURNTRANSFER => true
));
$response = curl_exec($ch);
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print("Status Code: ".$statusCode."\n");
$responseData = json_decode($response);
print_r($responseData);
?>