---
title: "Get list of subnetworks"
method: GET
path: "/v1/subnetworks"
tags: ["Subnetworks"]
---

# Get list of subnetworks

`GET /v1/subnetworks`

## Request

- Base URL: `https://api.emma.ms/external`
- URL: `https://api.emma.ms/external/v1/subnetworks`
- Auth: HTTP bearer

Returns a list of subnetworks within the project.

## Query parameters

- `projectId` integer

## Response `200`

Successful operation

- Subnetwork[]
  - `id` string: Subnetwork id
  - `name` string: Subnetwork name
  - `dataCenterId` string: ID of the cloud provider's data center
  - `subnetworkPrefix` string: The prefix for the subnetwork IP address range
  - `subnetworkSize` integer: The net mask size for the subnetwork
  - `resources` object[]: List of entities in the subnetwork
    - `id` integer: ID of the entity
    - `resourceType` string: Type of the entity
  - `status` string: Subnetwork status

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - Access is denied
- `500`: Internal server error

---

[API](https://skmtc.dev/emma/apis/public-emma-api.md) - [All operations](https://skmtc.dev/emma/apis/public-emma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/emma/apis/public-emma-api/revisions/9e55f0920078?raw)