List Ip_addresses
netbox_list_ip_addressesList and filter IP addresses from NetBox using address, parent CIDR, status, role, and pagination support.
Instructions
List individual IP addresses from NetBox.
Supports pagination and filtering. Common patterns:
Discovery: call with no filters to browse the first ip_addresses.
Lookup by id: use netbox_get_ip_address instead when you already have an id.
Narrow scan: combine 'q' (fuzzy text) with resource-specific filters below.
Pagination:
'limit' (max 1000, default 50) and 'offset'. Response includes 'has_more' and 'next_offset'.
Large list responses auto-truncate to keep under the character limit; keep calling with next_offset to continue.
Resource-specific filters:
address: Exact address with mask, e.g. '10.0.0.5/32'.
parent: Return addresses within this CIDR, e.g. '10.0.0.0/24'.
family:
status:
role:
dns_name:
vrf_id:
tenant_id:
assigned_to_interface:
interface_id: Restrict to one device interface.
vminterface_id: Restrict to one VM interface.
Universal filters:
q (string) Fuzzy text search across searchable fields.
tag (string[]) AND-filter by tag slugs.
created_after (date) ISO-8601 lower bound on 'created'.
created_before (date) ISO-8601 upper bound on 'created'.
Returns: Markdown summary (default) or JSON with shape: { total, count, offset, limit, items: [...], has_more, next_offset? }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Fuzzy full-text search across the object's searchable fields (name, description, etc.). | |
| tag | No | Filter to objects that have ALL of these tag slugs. Repeat for multiple tags (AND semantics in NetBox). | |
| role | No | ||
| limit | No | Maximum number of items to return per page (1-1000, default 50). | |
| family | No | ||
| offset | No | Number of items to skip for pagination. Use next_offset from a previous response. | |
| parent | No | Return addresses within this CIDR, e.g. '10.0.0.0/24'. | |
| status | No | ||
| vrf_id | No | ||
| address | No | Exact address with mask, e.g. '10.0.0.5/32'. | |
| dns_name | No | ||
| tenant_id | No | ||
| interface_id | No | Restrict to one device interface. | |
| created_after | No | ISO-8601 date; only return objects created on or after this date (e.g. 2024-01-01). | |
| created_before | No | ISO-8601 date; only return objects created on or before this date. | |
| vminterface_id | No | Restrict to one VM interface. | |
| response_format | No | Output format: 'markdown' (default, human-readable) or 'json' (full structured payload). Use 'json' when chaining follow-up tool calls. | markdown |
| assigned_to_interface | No |