---
title: "List Dataset"
method: GET
path: "/policies/dataset"
tags: ["dataset"]
---

# List Dataset

`GET /policies/dataset`

## Query parameters

- `limit` integer
- `offset` integer
- `name` string
- `order` 'name' | 'id'
- `dir` 'asc' | 'desc'
- `tags` object

## Response `200`

Data retrieved.

- DatasetPageSchema
  - `dataset` DatasetObjSchema[], required
    - `id` string, uuid, required — Unique identifier (UUID)
    - `name` string — A unique name label
    - `agent_group_id` string, uuid — Unique identifier (UUID) of an agent_group
    - `agent_policy_id` string, uuid — Unique identifier (UUID) of an agent_policy
    - `sink_ids` string[] — An array of one or more sink unique identifier
    - `valid` boolean — Boolean field indicating whether the dataset is valid
    - `tags` object — User defined key/values for organization and searching
    - `ts_created` string, date-time — Timestamp of creation
  - `total` integer — Total number of items
  - `offset` integer — Number of items to skip during retrieval
  - `limit` integer — Maximum number of items to return in one page

## Other responses

- `400` — Failed due to malformed query parameters.
- `401` — Missing or invalid access token provided.
- `404` — A non-existent entity request.
- `500` — Unexpected server-side error occurred.

---

[API](https://skmtc.net/orb-community/apis/orb-policies.md) · [All operations](https://skmtc.net/orb-community/apis/orb-policies/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orb-community/orb-policies/versions/d95ee7691efb/schema)