---
title: "List networks for a tenant"
method: GET
path: "/networks"
tags: ["Network"]
---

# List networks for a tenant

`GET /networks`

Returns a paginated list of networks scoped to the tenant identified by the `tenant-id` header. Results are sorted by creation date, newest first, using offset-based pagination. Use this endpoint to browse or search all networks for a tenant; to fetch a single known network by ID use `GET /networks/{id}` instead. Requires the `READ_NETWORK` permission. Returns 200 with an empty `records` list when the tenant has no networks.

## Query parameters

- `page` integer
- `size` integer

## Headers

- `tenant-id` string, required

## Response `200`

Returned if the request is successful.

- GetAllNetworksResponse
  - `totalCount` integer
  - `records` NetworkResponse[]
    - `data` object
      - `id` string, uuid
      - `name` string
      - `contractId` string

## Other responses

- `400` — Returned if the request is invalid. `tenant-id` and `user-id` headers are required.
- `401` — Returned if the request is unauthorized. Authentication required.
- `403` — Returned if the request is forbidden. Insufficient permissions.
- `500` — Returned if the request is an internal server error.
- `502` — Returned if the request is a bad gateway. Downstream service error.
- `503` — Returned if the request is a service unavailable. Network connectivity issues.

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)