Skip to main content
GET
/
devices
/
{macAddress}
Get Device Details
curl --request GET \
  --url https://api.altostrat.io/arp/devices/{macAddress} \
  --header 'Authorization: Bearer <token>'
{
  "mac_address": "00:1A:2B:3C:4D:5E",
  "hostname": "my-laptop.lan",
  "alias": "John's Work Laptop",
  "manufacturer": "Apple, Inc.",
  "site_id": "9c148cc3-a628-440e-b9be-af654a2ac8e8",
  "current_ip": {
    "ip_address": "192.168.1.100",
    "interface": "ether2",
    "first_seen_at": "2025-04-08T10:00:00Z",
    "last_seen_at": "2025-04-08T14:20:30Z"
  },
  "first_seen_at": "2025-03-10T08:00:00Z",
  "last_seen_at": "2025-04-08T14:20:30Z"
}

Authorizations

Authorization
string
header
required

Enter the Bearer token (obtained via authentication or provided internally).

Path Parameters

macAddress
string
required

MAC address of the device (e.g., 00:1A:2B:3C:4D:5E)

Response

Device details.

mac_address
string
Example:

"00:1A:2B:3C:4D:5E"

hostname
string | null
Example:

"my-laptop.lan"

alias
string | null
Example:

"John's Work Laptop"

manufacturer
string | null
Example:

"Apple, Inc."

site_id
string<uuid>
Example:

"9c148cc3-a628-440e-b9be-af654a2ac8e8"

current_ip
object
first_seen_at
string<date-time>

Timestamp when the device was first recorded.

Example:

"2025-03-10T08:00:00Z"

last_seen_at
string<date-time>

Timestamp when the device was last seen in an ARP sync.

Example:

"2025-04-08T14:20:30Z"

I