Every device discovery knows, across every source that has reported it: whether it is linked

curl --request GET \
  --url https://app.assetinfinity.ai/api/discovered_devices

const options = {method: 'GET'};

fetch('https://app.assetinfinity.ai/api/discovered_devices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.assetinfinity.ai/api/discovered_devices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.assetinfinity.ai/api/discovered_devices"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.assetinfinity.ai/api/discovered_devices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

[
  {
    "asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "asset_name": "<string>",
    "asset_number": "<string>",
    "current_attributes": "<string>",
    "device_class": "<string>",
    "device_class_guess": "<string>",
    "dismissed_at": "<string>",
    "dismissed_note": "<string>",
    "dismissed_reason": "<string>",
    "first_seen_at": "<string>",
    "hostname": "<string>",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "identities": "<string>",
    "ip_address": "<string>",
    "is_managed": true,
    "last_seen_at": "<string>",
    "last_source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "last_source_name": "<string>",
    "last_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "link_reason": "<string>",
    "link_score": 123,
    "linked_at": "<string>",
    "linked_by": "<string>",
    "mac_vendor": "<string>",
    "manufacturer": "<string>",
    "model": "<string>",
    "os_guess": "<string>",
    "os_name": "<string>",
    "os_version": "<string>",
    "primary_mac": "<string>",
    "serial_number": "<string>",
    "site_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "software_installed": 123,
    "status": "<string>"
  }
]

IT assets

Every device discovery knows, across every source that has reported it: whether it is linked

to an asset, unreviewed or dismissed, when it was first and last seen, and what it last said about itself. Manufacturer, model and operating system are as the device spelled them. os_guess is what a sweep without a credential inferred from how the device answered — WINDOWS, UNIX_LIKE or NETWORK_DEVICE — and is empty once the device has named its operating system. mac_vendor is who the IEEE registered the MAC address prefix to, which is the maker of the network card; empty for an address the device randomised. device_class_guess is PRINTER, CAMERA, NETWORK_EQUIPMENT, SMART_DEVICE or COMPUTER, inferred from the card’s maker, the guessed operating system and the ports that answered, and empty once the device has said what it is.

GET

discovered_devices

curl --request GET \
  --url https://app.assetinfinity.ai/api/discovered_devices

const options = {method: 'GET'};

fetch('https://app.assetinfinity.ai/api/discovered_devices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.assetinfinity.ai/api/discovered_devices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.assetinfinity.ai/api/discovered_devices"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.assetinfinity.ai/api/discovered_devices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

[
  {
    "asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "asset_name": "<string>",
    "asset_number": "<string>",
    "current_attributes": "<string>",
    "device_class": "<string>",
    "device_class_guess": "<string>",
    "dismissed_at": "<string>",
    "dismissed_note": "<string>",
    "dismissed_reason": "<string>",
    "first_seen_at": "<string>",
    "hostname": "<string>",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "identities": "<string>",
    "ip_address": "<string>",
    "is_managed": true,
    "last_seen_at": "<string>",
    "last_source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "last_source_name": "<string>",
    "last_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "link_reason": "<string>",
    "link_score": 123,
    "linked_at": "<string>",
    "linked_by": "<string>",
    "mac_vendor": "<string>",
    "manufacturer": "<string>",
    "model": "<string>",
    "os_guess": "<string>",
    "os_name": "<string>",
    "os_version": "<string>",
    "primary_mac": "<string>",
    "serial_number": "<string>",
    "site_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "software_installed": 123,
    "status": "<string>"
  }
]

Headers

Range

string

Limiting and Pagination

Range-Unit

string

default:items

Limiting and Pagination

Prefer

enum<string>

Preference

Available options:

count=none

Query Parameters

string

status

string

asset_id

string

asset_number

string

asset_name

string

site_id

string

first_seen_at

string

last_seen_at

string

last_source_id

string

last_source_name

string

is_managed

string

serial_number

string

hostname

string

primary_mac

string

ip_address

string

device_class

string

manufacturer

string

model

string

os_name

string

os_version

string

current_attributes

string

last_user_id

string

dismissed_reason

string

dismissed_note

string

dismissed_at

string

software_installed

string

identities

string

linked_by

string

linked_at

string

link_score

string

link_reason

string

os_guess

string

mac_vendor

string

device_class_guess

string

select

string

Filtering Columns

order

string

Ordering

offset

string

Limiting and Pagination

limit

string

Limiting and Pagination

Response

asset_id

string<uuid>

Note: This is a Foreign Key to asset_contracts.asset_id.

asset_name

string<character varying>

Maximum string length: 250

asset_number

string<character varying>

Maximum string length: 80

current_attributes

string<jsonb>

device_class

string<character varying>

Maximum string length: 60

device_class_guess

string<text>

dismissed_at

string<timestamp with time zone>

dismissed_note

string<text>

dismissed_reason

string<character varying>

Maximum string length: 30

first_seen_at

string<timestamp with time zone>

hostname

string<character varying>

Maximum string length: 255

string<uuid>

Note: This is a Primary Key.

identities

string<jsonb>

ip_address

string<text>

is_managed

boolean<boolean>

last_seen_at

string<timestamp with time zone>

last_source_id

string<uuid>

Note: This is a Foreign Key to discovery_sources.id.

last_source_name

string<character varying>

Maximum string length: 200

last_user_id

string<uuid>

Note: This is a Foreign Key to capex_invite_candidates.id.

link_reason

string<text>

link_score

number<numeric>

linked_at

string<timestamp with time zone>

linked_by

string<character varying>

Maximum string length: 10

mac_vendor

string<text>

manufacturer

string<character varying>

Maximum string length: 400

model

string<character varying>

Maximum string length: 400

os_guess

string<text>

os_name

string<character varying>

Maximum string length: 400

os_version

string<character varying>

Maximum string length: 120

primary_mac

string<character varying>

Maximum string length: 17

serial_number

string<character varying>

Maximum string length: 120

site_id

string<uuid>

Note: This is a Foreign Key to entry_currencies.for_site_id.

software_installed

integer<bigint>

status

string<character varying>

Maximum string length: 20