---
title: "List Networks"
method: GET
path: "/v2/cloud-gateways/networks"
tags: ["Networks"]
---

# List Networks

`GET /v2/cloud-gateways/networks`

Returns a paginated list of networks.

## Query parameters

- `filter` NetworksFilterParameters
  - `name` union
    - union — Filters on the given string field value by exact match.
      - string
      - object
        - `eq` string, required
    - StringFieldContainsFilter — Filters on the given string field value by fuzzy match.
      - `contains` string, required
    - StringFieldNEQFilter — Filters on the given string field value by exact match inequality.
      - `neq` string, required
    - StringFieldOEQFilter — Returns entities that exact match any of the comma-delimited phrases in the filter string.
      - `oeq` string, required
    - StringFieldOContainsFilter — Returns entities that fuzzy-match any of the comma-delimited phrases in the filter string.
      - `ocontains` string, required
  - `state` union
    - union — Filter a network state by exact match.
      - 'created' | 'initializing' | 'offline' | 'ready' | 'terminating' | 'terminated' — State of the network.
      - object
        - `eq` 'created' | 'initializing' | 'offline' | 'ready' | 'terminating' | 'terminated', required — State of the network.
    - NetworkStateFieldNotEqualsFilter — Filter a network state by inequality match.
      - `neq` 'created' | 'initializing' | 'offline' | 'ready' | 'terminating' | 'terminated', required — State of the network.
    - NetworkStateFieldOrEqualityFilter — Filter a network state by determining if the value is equal to any in a set of values, where the set is a comma-delimited list.
      - `oeq` string, required
- `page[size]` integer
- `page[number]` integer

## Response `200`

A paginated list for a collection of networks.

- object
  - `meta` PaginatedMeta, required — returns the pagination information
    - `page` PageMeta, required — Contains pagination query parameters and the total number of objects returned.
      - `number` number, required
      - `size` number, required
      - `total` number, required
  - `data` Network[], required
    - `id` string, uuid, required
    - `name` string, required — Human-readable name of the network.
    - `default` boolean, required — Whether the network is a default network or not. Default networks are Networks that are created automatically by Konnect when an organization is linked to a provider account.
    - `cloud_gateway_provider_account_id` string, uuid, required
    - `region` string, required — Region ID for cloud provider region.
    - `availability_zones` string[], required — List of availability zones that the network is attached to.
    - `cidr_block` string, required — CIDR block configuration for the network.
    - `state` 'created' | 'initializing' | 'offline' | 'ready' | 'terminating' | 'terminated', required — State of the network.
    - `state_metadata` NetworkStateMetadata — Metadata describing the backing state of the network and why it may be in an erroneous state.
      - `reported_status` string — Reported status of the network from backing infrastructure.
      - `reason` string — Reason why the network may be in an erroneous state, reported from backing infrastructure.
    - `provider_metadata` NetworkProviderMetadata, required — Metadata describing attributes returned by cloud-provider for the network.
      - `vpc_id` string
      - `subnet_ids` string[]
    - `transit_gateway_count` integer, required — The number of transit gateways attached to this network.
    - `configuration_reference_count` integer, required — The number of configurations that reference this network.
    - `entity_version` integer, required — Monotonically-increasing version count of the network, to indicate the order of updates to the network.
    - `created_at` string, date-time, required — An RFC-3339 timestamp representation of network creation date.
    - `updated_at` string, date-time, required — An RFC-3339 timestamp representation of network update date.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2025-05-14** `87c135153b84` — 1 info
  - added the optional property `data/items/state_metadata` to the response with the `200` status

[Change history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v2/cloud-gateways/networks/get.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kong/konnect-api-go-sdk/revisions/2a7df3ca52c8/schema)