---
title: "List a VPC's peers."
method: GET
path: "/v1/vpc/{id}/peers"
tags: ["VPC"]
---

# List a VPC's peers.

`GET /v1/vpc/{id}/peers`

## Request

- Base URL: `https://api.scalix.world`
- URL: `https://api.scalix.world/v1/vpc/{id}/peers`
- Auth: HTTP bearer

Returns all peers registered in the VPC.

## Path parameters

- `id` string, required

## Response `200`

All peers in the VPC

- VpcPeerJson[]
  - `id` string, required
  - `vpc_id` string, required
  - `name` string, required
  - `public_key` string, required
  - `allowed_ips` string[], required
  - `endpoint` string, nullable
  - `persistent_keepalive` integer, required
  - `created_at` string, required

## Other responses

- `401`: Missing or invalid credentials
- `403`: Token lacks the vpc:read scope
- `404`: VPC not found
- `500`: Internal error

---

[API](https://skmtc.dev/scalix/apis/scalix-cloud-api.md) · [All operations](https://skmtc.dev/scalix/apis/scalix-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scalix/apis/scalix-cloud-api/revisions/2c04ca0a90bb?raw)