GET
/
devices
List Devices
curl --request GET \
  --url https://api.altostrat.io/arp/devices \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "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"
    }
  ],
  "links": {
    "first": "<string>",
    "last": "<string>",
    "prev": "<string>",
    "next": "<string>"
  },
  "meta": {
    "path": "<string>",
    "per_page": 123,
    "next_cursor": "<string>",
    "prev_cursor": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
mac_address
string

Filter by MAC address (partial match).

Maximum length: 17
​
hostname
string

Filter by hostname (partial match).

Maximum length: 255
​
alias
string

Filter by alias (partial match).

Maximum length: 255
​
manufacturer
string

Filter by manufacturer (partial match).

Maximum length: 255
​
site_id
string

Filter by site UUID (partial match).

​
ip_address
string

Filter by associated IP address (checks history, partial match).

Maximum length: 45
​
current_ip_only
boolean

Only return devices with a current IP.

​
last_seen_days
integer

Filter by devices seen in the last N days.

Required range: 1 <= x <= 365
​
sort_by
enum<string>
default:last_seen_at
Available options:
mac_address,
hostname,
alias,
manufacturer,
created_at,
last_seen_at
​
sort_direction
enum<string>
default:desc
Available options:
asc,
desc
​
per_page
integer
default:25

Items per page for cursor pagination.

Required range: 5 <= x <= 5000
​
cursor
string

Pagination cursor.

Response

200
application/json

A paginated list of devices.

The response is of type object.