NetPulse Looking Glass

GET /api/v1/routers

List all available routers.

Response:

{
  "success": true,
  "data": [
    {
      "slug": "core1",
      "name": "Core Router 1",
      "location": "DC1 - Primary",
      "model": "MX304"
    }
  ]
}

GET /api/v1/connections

List connections for a router.

Parameters:

• router (required) - Router slug

Example:

GET /api/v1/connections?router=core1

GET /api/v1/ping

Execute ICMP ping from a router through a specific upstream.

Parameters:

• target (required) - IP address or hostname
• router (required) - Router slug
• connection (required) - Connection ID

Example:

GET /api/v1/ping?target=8.8.8.8&router=core1&connection=1

Response:

{
  "success": true,
  "data": {
    "target": "8.8.8.8",
    "router": "Core Router 1",
    "connection": "Cogent Transit",
    "source_ip": "203.0.113.1",
    "command": "ping 8.8.8.8 source 203.0.113.1 count 5",
    "output": "PING 8.8.8.8: 56 data bytes\n...",
    "duration_ms": 1523
  }
}

GET /api/v1/traceroute

Execute traceroute from a router through a specific upstream.

Parameters:

• target (required) - IP address or hostname
• router (required) - Router slug
• connection (required) - Connection ID
• as_lookup (optional) - Include AS number lookup (true/false)

Example:

GET /api/v1/traceroute?target=google.com&router=core1&connection=1&as_lookup=true

GET /api/v1/aspath

Get BGP AS path information from BIRD route-server.

Parameters:

• target (required) - IP address or prefix
• router (optional) - Router slug (defaults to first available)

Example:

GET /api/v1/aspath?target=8.8.8.0/24

GET /api/v1/aspath/all-routers

Get BGP AS path from all routers (consolidated view).

Parameters:

• target (required) - IP address or prefix

Example:

GET /api/v1/aspath/all-routers?target=8.8.8.0/24