How do I find free IP addresses?

Requires Basic

Quick answer

Notory doesn’t run a separate “free IP” calculator — instead, it tells addresses apart by their status. Free addresses carry the status Available. In the Network module, you spot them in the IP Addresses tab by the status column; via the API, you filter the list on status = available.

Prerequisites

Included in all plans from Basic onward.

Open the “IP Addresses” tab. Choose Network → IP Addresses. The list is sorted by address in ascending order.
Filter by status “Available”. Use search or sort the status column to narrow the list down to addresses with the status Available. Addresses marked Assigned, Reserved, or Deprecated are occupied or locked.

Screenshot pending netzwerk-freie-ips-01 IP address list filtered to the 'Available' status

The IP address list — free addresses carry the status 'Available'.
Assign the address. Open a free address and link it to an asset — see Assign an IP address to an asset.

You retrieve the list of all IP addresses via GET /api/v1/network/ips (scope read) and filter client-side on the status available — the endpoint sorts by address.

curl -H "Authorization: Bearer inv_dein_token" \
  https://demo.notory.io/api/v1/network/ips \
  | jq '[ .[] | select(.status == "available") ]'

[
  {
    "id": "0190f3a2-6c11-7b8e-9f2a-1c4d5e6f7a80",
    "address": "10.0.0.11",
    "status": "available",
    "assigned_asset_id": null
  },
  {
    "id": "0190f3a2-6c11-7b8e-9f2a-1c4d5e6f7a81",
    "address": "10.0.0.12",
    "status": "available",
    "assigned_asset_id": null
  }
]

Possible status values: available (Available), assigned (Assigned), reserved (Reserved), deprecated (Deprecated).

What happens behind the scenes?

Status instead of computation: “Free” isn’t a calculated state in Notory — it’s the result of maintained status values. Its accuracy depends on occupied addresses being consistently set to Assigned or Reserved.
No server-side filter at the endpoint: GET /network/ips returns all addresses for the tenant; narrowing the list down to free addresses happens in the interface or client-side (see the API example).
Subnets as context: IP ranges let you record which address space exists in the first place — but the individual free addresses within it remain the IP entries with status Available.