> ## Documentation Index > Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt > Use this file to discover all available pages before exploring further. # List all Tailscale Subnet Routers > Returns a paginated list of the Tailscale Subnet Routers on the account, with support for filtering by Network. ## OpenAPI ````yaml /openapi/source/external/netapps/netapps.json get /tailscale_subnet_routers openapi: 3.1.0 info: version: 2.0.0 title: Telnyx API x-latency-category: responsive x-endpoint-cost: light description: SIP trunking, SMS, MMS, Call Control and Telephony Data Services. license: name: MIT identifier: MIT contact: email: support@telnyx.com servers: - url: https://api.telnyx.com/v2 description: Version 2.0.0 of the Telnyx API security: - bearerAuth: [] tags: - name: Networks description: Network operations - name: Public Internet Gateways description: Public Internet Gateway operations - name: WireGuard Interfaces description: WireGuard Interface operations - name: Tailscale Subnet Routers description: Tailscale Subnet Router operations - name: Virtual Cross Connects description: Virtual Cross Connect operations - name: Regions description: Regions - name: Global IPs description: Global IPs paths: /tailscale_subnet_routers: get: tags: - Tailscale Subnet Routers summary: List all Tailscale Subnet Routers description: >- Returns a paginated list of the Tailscale Subnet Routers on the account, with support for filtering by Network. operationId: ListTailscaleSubnetRouters parameters: - name: filter in: query style: deepObject explode: true description: >- Consolidated filter parameter (deepObject style). Originally: filter[network_id] schema: type: object properties: network_id: type: string example: 0de011ae-ee53-4df4-ba96-754728eb5aad description: The id of the Network to filter on. - $ref: '#/components/parameters/PageConsolidated' responses: '200': description: Successful response content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/TailscaleSubnetRouter' meta: $ref: '#/components/schemas/PaginationMeta' example: 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: 1 total_results: 1 page_number: 1 page_size: 25 '422': $ref: '#/components/responses/UnprocessableEntity' default: $ref: '#/components/responses/GenericErrorResponse' components: parameters: PageConsolidated: name: page in: query style: deepObject explode: true description: >- Consolidated page parameter (deepObject style). Originally: page[number], page[size] schema: type: object properties: number: type: integer minimum: 1 default: 1 description: The page number to load size: type: integer minimum: 1 maximum: 250 default: 20 description: The size of the page schemas: TailscaleSubnetRouter: type: object title: TailscaleSubnetRouter properties: id: type: string format: uuid description: Identifies the resource. readOnly: true example: 5c6f0a7e-6c7b-4d7f-9f2e-3b1e4e9a8c21 record_type: type: string description: Identifies the type of the resource. readOnly: true example: tailscale_subnet_router name: type: string minLength: 1 maxLength: 128 description: A user specified name for the router. example: tailnet-ashburn network_id: type: string format: uuid description: The id of the Network the router is attached to. example: 0de011ae-ee53-4df4-ba96-754728eb5aad region_code: type: string description: >- The code of the region the router is created in. `GET /network_coverage` lists the regions whose `available_services` include `tailscale_subnet_router`. example: ashburn-va advertised_routes: type: array minItems: 1 maxItems: 64 uniqueItems: true items: type: string example: 172.27.0.0/24 example: - 172.27.0.0/24 description: >- IPv4 subnets of the Network that the router advertises to the tailnet. Each entry is a canonical CIDR that the Network routes. Default, loopback, link-local, multicast, and Tailscale (`100.64.0.0/10`) ranges are rejected. So are ranges that overlap the router's own, `172.27.254.0/24` and `198.18.0.0/20`. status: type: string enum: - provisioning - provisioned - failed - deleting readOnly: true example: provisioned description: >- `provisioning`: Telnyx is creating the router or applying a change. `provisioned`: the router is on the tailnet and advertises its routes; the tailnet still approves them. `failed`: enrollment did not complete, and `PATCH` retries it. `deleting`: the router is being removed. customer_address: type: string readOnly: true example: 172.27.254.1 description: >- The router's address on the Network, from `172.27.254.0/24`. Tailnet traffic enters the Network from this address. device_id: type: - string - 'null' readOnly: true example: n5c6f0a7e1CNTRL description: >- The router's node id on the tailnet. Set once the router has enrolled. tailnet_name: type: - string - 'null' readOnly: true example: acme.example description: >- The name of the tailnet the router is enrolled in. Set once the router has enrolled. tailscale_ips: type: array readOnly: true items: type: string example: - 100.101.2.30 - fd7a:115c:a1e0::2a description: >- The router's addresses on the tailnet. Empty until the router has enrolled. created_at: type: string format: date-time description: >- ISO 8601 formatted date-time indicating when the resource was created. readOnly: true example: '2026-10-13T15:04:05.123456Z' updated_at: type: string format: date-time description: >- ISO 8601 formatted date-time indicating when the resource was updated. readOnly: true example: '2026-10-13T15:09:41.654321Z' PaginationMeta: type: object properties: total_pages: type: integer example: 3 total_results: type: integer example: 55 page_number: type: integer example: 2 page_size: type: integer example: 25 Errors: properties: errors: type: array items: $ref: '#/components/schemas/Error' type: object Error: required: - code - title properties: code: type: string title: type: string detail: type: string source: type: object properties: pointer: description: JSON pointer (RFC6901) to the offending entity. type: string parameter: description: Indicates which query parameter caused the error. type: string meta: type: object additionalProperties: true type: object responses: UnprocessableEntity: description: Unprocessable entity. Check the 'detail' field in response for details. content: application/json: schema: $ref: '#/components/schemas/Errors' example: errors: - code: '10027' title: Unprocessable Entity detail: >- The server understood the syntax of the request but was unable to process the instructions. GenericErrorResponse: description: Unexpected error content: application/json: schema: $ref: '#/components/schemas/Errors' securitySchemes: bearerAuth: type: http scheme: bearer ````