Skip to content
Prefactor Docs

List devices

GET
/api/v1/device

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
pool_id
required
sorting
pagination[offset]
pagination[page_size]

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Success

object
pagination
One of:
PaginationOutput

Pagination information

object
item_count

The total number of items

number
item_end

The index of the last item in the page (one-based)

number
item_start

The index of the first item in the page (one-based)

number
next_page_offset
One of:

The offset of the next page (null if last page)

number
page_count

The total number of pages

number
page_index

The index of the current page (one-based)

number
page_offset

The offset of the first item in the page (zero-based)

number
page_size

The number of items per page

number
previous_page_offset
One of:

The offset of the previous page (null if first page)

number
 
{
  "item_count": 200,
  "item_end": 100,
  "item_start": 91,
  "next_page_offset": 110,
  "page_count": 20,
  "page_index": 10,
  "page_offset": 90,
  "page_size": 10,
  "previous_page_offset": 80
}
sorting
One of:
Sorting

Sorting information

object
direction

The direction to sort by

string
Allowed values: asc desc 
asc
field

The field to sort by (values depend on the type of list)

string
Allowed values: id last_seen status title 
id
status
string
Allowed values: success 
success
summaries
Array<object>
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