List all subnets
Returns all subnets accessible to the authenticated user or daemon.
Daemons can only access subnets within their assigned network.
Supports pagination via limit and offset query parameters,
and ordering via group_by, order_by, and order_direction.
User API key (Bearer scp_u_...). Create in Platform > API Keys.
In: header
Query Parameters
Filter by network ID
Primary ordering field (used for grouping). Always sorts ASC to keep groups together.
Secondary ordering field (sorting within groups or standalone sort).
Direction for order_by field (group_by always uses ASC).
Maximum number of results to return (1-1000, default: 50). Use 0 for no limit.
Number of results to skip. Default: 0.
As-of timestamp (ISO 8601). When set, returns SCD2 state as of this instant (snapshot view) instead of live state.
true returns only subnets discovery hasn't observed within their
network's staleness window; false returns only those it has. Omit for
both. Evaluated per row against the subnet's own network's window.
Response Body
application/json
curl -X GET "https://example.com/api/v1/subnets"{
"data": [
{
"cidr": "192.168.1.0/24",
"cidr_source": "DaemonSelfReport",
"created_at": "2026-01-15T10:30:00Z",
"description": "Local area network",
"first_discovery_id": null,
"id": "550e8400-e29b-41d4-a716-446655440004",
"last_discovery_id": null,
"last_seen_at": "2026-01-15T10:30:00Z",
"lineage_id": null,
"name": "LAN",
"network_id": "550e8400-e29b-41d4-a716-446655440002",
"source": {
"type": "Manual"
},
"subnet_type": "Lan",
"tags": [],
"updated_at": "2026-01-15T10:30:00Z",
"valid_from": "2026-01-15T10:30:00Z",
"valid_to": null,
"virtualization_service_id": null
}
],
"meta": {
"api_version": 1,
"pagination": {
"has_more": true,
"limit": 50,
"offset": 0,
"total_count": 142
},
"server_version": "0.17.17"
},
"success": true,
"error": "string"
}