---
title: "List private networks"
method: GET
path: "/v1/networks"
tags: ["public", "networks"]
---

# List private networks

`GET /v1/networks`

## Request

- Base URL: `https://api.vozora.io`
- URL: `https://api.vozora.io/v1/networks`
- Auth: API key in header `Authorization`

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

OK

- ProvisioningPublicNetworkList
  - `items` ProvisioningPublicNetworkView[]
    - `cidr` string
    - `created_at` string
    - `failure_reason` 'terminal_error' | 'max_attempts' | 'provisioning_deadline', nullable: Why this network is in the failed state: terminal_error (the provider refused it; recreating will not help without a change), max_attempts (it was retried and never succeeded), or provisioning_deadline (it ran out of time). null on any network that has not failed.
    - `id` string
    - `member_count` integer
    - `members` ProvisioningPublicNetworkMemberView[]
      - `instance_id` string
      - `private_ip` string
      - `state` string
    - `name` string
    - `state` 'pending' | 'active' | 'deleting' | 'failed' | 'deleted': The network lifecycle state. A failed network is terminal: delete it and create a new one. See failure_reason for why it failed.
    - `updated_at` string: When this network last changed state, RFC3339 UTC.
    - `zone` string: The slug of the zone the network is in. Absent when the zone is not known. GET /v1/zones lists the zones open for new orders, so a network in a zone that has since closed to new orders names a zone that list omits.
  - `next_cursor` string

## Other responses

- `400`: bad_cursor or bad_limit
- `401`: invalid or missing API key
- `403`: the key lacks networks:read

---

[API](https://skmtc.dev/vozora/apis/vozora-api.md) · [All operations](https://skmtc.dev/vozora/apis/vozora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vozora/apis/vozora-api/revisions/56f15734fc5a?raw)