get__devices_-id

GET /devices/{id}

Get Device Details

Retrieve detailed information about a specific device including its active sessions

TypeScript Client Library

// Note: This endpoint doesn't have a direct client method in the provided TypeScript client
// You would need to use the generic makeRequest method:
// this.makeRequest<any>(`devices/${id}`, 'GET', null);

Code Samples

Shell

# You can also use wget
curl -X GET https://backend.flashback.tech/devices/{id} \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

HTTP

GET https://backend.flashback.tech/devices/{id} HTTP/1.1
Host: localhost:3000
Accept: application/json

JavaScript

const headers = {
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'
};

fetch('https://backend.flashback.tech/devices/{id}',
{
  method: 'GET',
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

Ruby

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.get 'https://backend.flashback.tech/devices/{id}',
  params: {
  }, headers: headers

p JSON.parse(result)

Python

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://backend.flashback.tech/devices/{id}', headers = headers)

print(r.json())

PHP

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://backend.flashback.tech/devices/{id}', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

Java

URL obj = new URL("https://backend.flashback.tech/devices/{id}");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

Go

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://backend.flashback.tech/devices/{id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Parameters

Name	In	Type	Required	Description
id	path	string	true	Device identifier

Example responses

200 Response

{
  "success": true,
  "device": {
    "id": "string",
    "deviceName": "string",
    "deviceType": "string",
    "os": "string",
    "browser": "string",
    "ipAddress": "string",
    "country": "string",
    "city": "string",
    "isTrusted": true,
    "trustLevel": "string",
    "lastSeen": "2019-08-24T14:15:22Z",
    "createdAt": "2019-08-24T14:15:22Z",
    "trustExpiresAt": "2019-08-24T14:15:22Z",
    "userAgent": "string",
    "deviceFingerprint": "string",
    "sessions": [
      {
        "id": "string",
        "ipAddress": "string",
        "location": "string",
        "startedAt": "2019-08-24T14:15:22Z",
        "lastActivity": "2019-08-24T14:15:22Z",
        "expiresAt": "2019-08-24T14:15:22Z",
        "loginMethod": "string"
      }
    ]
  }
}

404 Response

{
  "success": false,
  "error": "Device not found"
}

500 Response

{
  "success": false,
  "error": "Failed to retrieve device details"
}

Responses

Status	Meaning	Description	Schema
200	OK	Device details with sessions	Inline
404	Not Found	Device not found	Inline
500	Internal Server Error	Server error	Inline

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Operation success status
» device	object	false	none	Device information
»» id	string	false	none	Unique device identifier
»» deviceName	string	false	none	Human-readable device name
»» deviceType	string	false	none	Device type (DESKTOP, MOBILE, TABLET)
»» os	string	false	none	Operating system
»» browser	string	false	none	Web browser
»» ipAddress	string	false	none	IP address of the device
»» country	string	false	none	Country location
»» city	string	false	none	City location
»» isTrusted	boolean	false	none	Whether device is trusted
»» trustLevel	string	false	none	Trust level (HIGH, MEDIUM, LOW, UNKNOWN)
»» lastSeen	string(date-time)	false	none	Last time device was active
»» createdAt	string(date-time)	false	none	When device was first registered
»» trustExpiresAt	string(date-time)	false	none	When device trust expires
»» userAgent	string	false	none	User agent string
»» deviceFingerprint	string	false	none	Device fingerprint hash
»» sessions	[object]	false	none	Array of active sessions
»»» id	string	false	none	Session identifier
»»» ipAddress	string	false	none	IP address used in session
»»» location	string	false	none	Session location
»»» startedAt	string(date-time)	false	none	When session started
»»» lastActivity	string(date-time)	false	none	Last activity in session
»»» expiresAt	string(date-time)	false	none	When session expires
»»» loginMethod	string	false	none	Authentication method used

Status Code 404

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Operation success status
» error	string	false	none	Error message

Status Code 500

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Operation success status
» error	string	false	none	Error message

To perform this operation, you must be authenticated by means of one of the following methods: BearerAuth