[Документация Yandex Cloud](../../../index.md) > [Yandex Virtual Private Cloud](../../index.md) > Справочник API > [REST (англ.)](../index.md) > [Subnet](index.md) > ListUsedAddresses

# Virtual Private Cloud API, REST: Subnet.ListUsedAddresses

List used addresses in specified subnet.

## HTTP request

```
GET https://vpc.api.yandexcloud.kz/vpc/v1/subnets/{subnetId}/addresses
```

## Path parameters

#|
||Field | Description ||
|| subnetId | **string**

Required field. This field is required. ||
|#

## Query parameters {#yandex.cloud.vpc.v1.ListUsedAddressesRequest}

#|
||Field | Description ||
|| pageSize | **string** (int64) ||
|| pageToken | **string** ||
|| filter | **string** ||
|#

## Response {#yandex.cloud.vpc.v1.ListUsedAddressesResponse}

**HTTP Code: 200 - OK**

```json
{
  "addresses": [
    {
      "address": "string",
      "ipVersion": "string",
      "references": [
        {
          "referrer": {
            "type": "string",
            "id": "string"
          },
          "type": "string"
        }
      ]
    }
  ],
  "nextPageToken": "string"
}
```

#|
||Field | Description ||
|| addresses[] | **[UsedAddress](#yandex.cloud.vpc.v1.UsedAddress)** ||
|| nextPageToken | **string** ||
|#

## UsedAddress {#yandex.cloud.vpc.v1.UsedAddress}

#|
||Field | Description ||
|| address | **string** ||
|| ipVersion | **enum** (IpVersion)

- `IPV4`
- `IPV6` ||
|| references[] | **[Reference](#yandex.cloud.reference.Reference)** ||
|#

## Reference {#yandex.cloud.reference.Reference}

#|
||Field | Description ||
|| referrer | **[Referrer](#yandex.cloud.reference.Referrer)** ||
|| type | **enum** (Type)

- `MANAGED_BY`
- `USED_BY` ||
|#

## Referrer {#yandex.cloud.reference.Referrer}

#|
||Field | Description ||
|| type | **string**

`type = compute.instance, id = <instance id>`
* `type = compute.instanceGroup, id = <instanceGroup id>`
* `type = loadbalancer.networkLoadBalancer, id = <networkLoadBalancer id>`
* `type = managed-kubernetes.cluster, id = <cluster id>`
* `type = managed-mysql.cluster, id = <cluster id>` ||
|| id | **string** ||
|#