---
title: "List IpSets"
method: GET
path: "/delivery/v2.1/global/workspaces/{workspaceUUID}/ipsets"
tags: ["CDN and DNS (v2.1)"]
---

# List IpSets

`GET /delivery/v2.1/global/workspaces/{workspaceUUID}/ipsets`

Retrieves a paginated list of all IpSet objects in the specified workspace.
The response includes details about each IpSet such as its configuration,
status, and metadata. Results can be filtered using query parameters.

## Path parameters

- `workspaceUUID` string, required

## Response `200`

Successfully retrieved the list of IpSet objects. The response includes
basic IpSet information like name, creation time, and status.

- V2IpSetList
  - `apiVersion` 'delivery/v2' | 'delivery/v2.1', required — Version identifier of the API schema
  - `items` V2IpSet[], required — List of IpSet resources
    - `apiVersion` 'delivery/v2' | 'delivery/v2.1', required — Version identifier of the API schema
    - `kind` 'IpSet', required — The string value 'IpSet' that identifies the schema
    - `metadata` V2ObjectMeta, required — Standard resource metadata fields
      - `creationTimestamp` string, date-time, required
      - `labels` object, required — Labels are key-value pairs attached to resources for organization and categorization
      - `name` string, required — User-provided name that uniquely identifies the resource within its workspace
      - `namespace` string, required — Namespace is the namespace in which the resource exists
      - `uid` string, required — System-generated unique identifier for the resource
    - `spec` V1beta1IpSetSpec, required — Desired configuration for the IpSet
      - `cidrs` string[], required
  - `kind` 'IpSetList', required — The string value 'IpSetList' that identifies the schema
  - `metadata` V1ListMeta, required — Standard resource metadata fields
    - `continue` string
    - `remainingItemCount` integer, nullable
    - `resourceVersion` string
    - `selfLink` string

## Other responses

- `400` — Bad Request - invalid request payload or parameters
- `401` — Unauthorized - invalid or expired authentication token
- `403` — Forbidden - insufficient permissions

---

[API](https://skmtc.dev/sotoon/apis/sotoon-api.md) · [All operations](https://skmtc.dev/sotoon/apis/sotoon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sotoon/sotoon-api/revisions/c937cd9861c5/schema)