---
title: "List all WireGuard Peers"
method: GET
path: "/wireguard_peers"
tags: ["WireGuard Interfaces"]
---

# List all WireGuard Peers

`GET /wireguard_peers`

Returns a paginated list of your WireGuard peers, with support for filtering.

## Query parameters

- `filter` object
  - `wireguard_interface_id` string, uuid — The id of the associated WireGuard interface to filter on.
- `page` object
  - `number` integer — The page number to load
  - `size` integer — The size of the page

## Response `200`

Successful response

- object
  - `data` WireguardPeer[]
    - `id` string, uuid — Identifies the resource.
    - `record_type` string — Identifies the type of the resource.
    - `created_at` string — ISO 8601 formatted date-time indicating when the resource was created.
    - `updated_at` string — ISO 8601 formatted date-time indicating when the resource was updated.
    - `public_key` string — The WireGuard `PublicKey`.<br /><br />If you do not provide a Public Key, a new Public and Private key pair will be generated for you.
    - `last_seen` string — ISO 8601 formatted date-time indicating when peer sent traffic last time.
    - `wireguard_interface_id` string, uuid — The id of the wireguard interface associated with the peer.
    - `private_key` string — Your WireGuard `Interface.PrivateKey`.<br /><br />This attribute is only ever utlised if, on POST, you do NOT provide your own `public_key`. In which case, a new Public and Private key pair will be generated for you. When your `private_key` is returned, you must save this immediately as we do not save it within Telnyx. If you lose your Private Key, it can not be recovered.
  - `meta` PaginationMeta
    - `total_pages` integer
    - `total_results` integer
    - `page_number` integer
    - `page_size` integer

## Other responses

- `422` — Unexpected error
- `default` — Unexpected error

## Changes

> 99 revisions in range; 1 not diffed.

- **2026-09-16** `a6a61a29ecdd` — 2 breaking
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `422`
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `default`
- **2026-08-17** `1571b0380bd7` — 2 breaking
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `422`
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `default`
- **2026-08-04** `8f5f4e537994` — 2 breaking
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `422`
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `default`

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/wireguard_peers/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/227c33b1ac9c?raw)