Skip to content
Prefactor Docs

Fetch device

GET
/api/v1/device/{device_id}

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
device_id
required

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Success

object
status
string
Allowed values: success 
success
summary
Device_Summary
object
account_id
Account_Id

A valid account ID

string
013xrzp12g3nqk8n505tp6wqnscpdy8q
domain_id
Domain_Id

A valid domain ID

string
013xrzp12g3nqk8nz2ccx5vt2j6f6hjz
dynamic_client_details
One of:
object
auth_profile
string
Allowed values: openid mcp 
openid
client_secret
One of:
string
pkce_required
boolean
redirect_uris
Array<string>
title
string
first_seen
One of:
InteractionDetails

A snapshot of the details of a particular device

object
asn
ASN

Autonomous System Number

integer
>= 1 
4764
at
Timestamp

Unix timestamp, seconds since midnight January 1, 1970 UTC

number
1234567890
city
City

City name

string
Melbourne
country_code
CountryCode

ISO 3166-1 alpha-2 country code

string
/^[A-Z]{2}$/ 
AU
ja4_fingerprint
JA4Fingerprint

JA4 TLS client fingerprint

string
q13d0314h3_55b375c5d22e_61e396c58b1f
lat_long
LatLong

Latitude and longitude coordinates as [latitude, longitude]

Array<number>
>= 2 items <= 2 items 
[
  -37.8159,
  144.9669
]
region_code
RegionCode

Region or state code

string
VIC
remote_ip
One of:

IPv4 address in dotted-decimal notation

string format: ipv4 
127.0.0.1
timezone
Timezone

IANA timezone identifier

string
Australia/Melbourne
user_agent
UserAgent

User-Agent string

string
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36
id
Device_Id

A valid device ID

string
013xrzp12g3nqk8nyvk0xwzcb2gzp8z1
last_seen
One of:
InteractionDetails

A snapshot of the details of a particular device

object
asn
ASN

Autonomous System Number

integer
>= 1 
4764
at
Timestamp

Unix timestamp, seconds since midnight January 1, 1970 UTC

number
1234567890
city
City

City name

string
Melbourne
country_code
CountryCode

ISO 3166-1 alpha-2 country code

string
/^[A-Z]{2}$/ 
AU
ja4_fingerprint
JA4Fingerprint

JA4 TLS client fingerprint

string
q13d0314h3_55b375c5d22e_61e396c58b1f
lat_long
LatLong

Latitude and longitude coordinates as [latitude, longitude]

Array<number>
>= 2 items <= 2 items 
[
  -37.8159,
  144.9669
]
region_code
RegionCode

Region or state code

string
VIC
remote_ip
One of:

IPv4 address in dotted-decimal notation

string format: ipv4 
127.0.0.1
timezone
Timezone

IANA timezone identifier

string
Australia/Melbourne
user_agent
UserAgent

User-Agent string

string
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36
pool_id
Pool_Id

A valid pool ID

string
013xrzp12g3nqk8n6z7f3q8wqgbmh3n9
session_type
string
Allowed values: browser api mcp 
browser
status
string
Allowed values: active revoked 
active
title
string
type
string
Allowed values: device 
device

default

Section titled “default ”

Error

One of:
object
code
string
Allowed values: bad_request bad_authtoken not_authenticated not_permitted not_implemented unknown not_found unexpected_ref_type unexpected invalid_action invalid_value required_value 
bad_request
message
string
status
string
Allowed values: error 
error