Tailscale Subnet Routers

List all Tailscale Subnet Routers

Changed on

Returns a paginated list of the Tailscale Subnet Routers on the account, with support for filtering by Network.

get/tailscale_subnet_routers

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/tailscale_subnet_routers
  • Auth: HTTP bearer

Query parameters

network_idstring

The id of the Network to filter on.

Consolidated filter parameter (deepObject style). Originally: filter[network_id]

{
  "network_id": "0de011ae-ee53-4df4-ba96-754728eb5aad"
}
numberinteger

The page number to load

sizeinteger

The size of the page

Consolidated page parameter (deepObject style). Originally: page[number], page[size]

Response

Successful response

Example response

{
  "data": [
    {
      "id": "5c6f0a7e-6c7b-4d7f-9f2e-3b1e4e9a8c21",
      "record_type": "tailscale_subnet_router",
      "name": "tailnet-ashburn",
      "network_id": "0de011ae-ee53-4df4-ba96-754728eb5aad",
      "region_code": "ashburn-va",
      "advertised_routes": [
        "172.27.0.0/24"
      ],
      "status": "provisioned",
      "customer_address": "172.27.254.1",
      "device_id": "n5c6f0a7e1CNTRL",
      "tailnet_name": "acme.example",
      "tailscale_ips": [
        "100.101.2.30",
        "fd7a:115c:a1e0::2a"
      ],
      "created_at": "2026-10-13T15:04:05.123456Z",
      "updated_at": "2026-10-13T15:09:41.654321Z"
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 55,
    "page_number": 2,
    "page_size": 25
  }
}

Changes