Skip to main content
POST
/
v1
/
monitoring
/
arps
Search ARP Entries
curl --request POST \
  --url https://api.altostrat.io/v1/monitoring/arps \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "search": "192.168.1.10",
  "sites": [
    "d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8"
  ],
  "page": 1,
  "per_page": 10,
  "sort": "ip_address",
  "order": "asc"
}
'
{
  "current_page": 123,
  "data": [
    {
      "id": "0c8526584284b025f3c328904724cf48a1a3848b",
      "mac": "00:1A:2B:3C:4D:5E",
      "ip_address": "192.168.88.254",
      "interface": "bridge",
      "last_seen": "5 minutes ago",
      "group": "<string>",
      "hostname": "my-laptop.local",
      "manufacturer": "Apple, Inc.",
      "site_id": "d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8",
      "range": "192.168.88.0/24",
      "alias": "Main Server",
      "serial": "<string>"
    }
  ],
  "first_page_url": "<string>",
  "from": 123,
  "last_page": 123,
  "last_page_url": "<string>",
  "links": [
    {
      "url": "<string>",
      "label": "<string>",
      "active": true
    }
  ],
  "next_page_url": "<string>",
  "path": "<string>",
  "per_page": 123,
  "prev_page_url": "<string>",
  "to": 123,
  "total": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
search
string

A search term to filter by IP address, MAC address, hostname, or manufacturer.

Example:

"192.168.1.10"

​
sites
string<uuid>[]

An array of Site UUIDs to include in the search. If omitted, all accessible sites are searched.

Example:
["d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8"]
​
page
integer
default:1

The page number for pagination.

​
per_page
integer
default:10

The number of results to return per page.

​
sort
enum<string>
default:ip_address

The field to sort the results by.

Available options:
ip_address,
mac_address,
hostname,
manufacturer,
alias,
range
​
order
enum<string>
default:asc

The sort order.

Available options:
asc,
desc

Response

A paginated list of ARP entries matching the search criteria.

​
current_page
integer
​
data
object[]
​
first_page_url
string<uri>
​
from
integer
​
last_page
integer
​
last_page_url
string<uri>
​
links
object[]
​
next_page_url
string<uri> | null
​
path
string<uri>
​
per_page
integer
​
prev_page_url
string<uri> | null
​
to
integer
​
total
integer