---
title: "GET /api/v1/config/datasets"
method: GET
path: "/api/v1/config/datasets"
tags: ["Dataset"]
---

# GET /api/v1/config/datasets

`GET /api/v1/config/datasets`

## Query parameters

- `page.max_size` integer
- `page.token` string
- `slugs` string[]
- `names` string[]
- `type` 'TRACES' | 'LOGS'

## Response `200`

A successful response.

- Configv1ListDatasetsResponse
  - `page` Configv1PageResult
    - `next_token` string — Opaque page token which identifies the next page of items which the client should request. An empty next_token indicates that there are no more items to return.
  - `datasets` Configv1Dataset[]
    - `name` string — Required. Name of the Dataset. You can modify this value after the Dataset is created.
    - `slug` string — Unique identifier of the Dataset. If a `slug` isn't provided, one will be generated based of the `name` field. You can't modify this field after the Dataset is created.
    - `created_at` string, date-time — Timestamp of when the Dataset was created. Cannot be set by clients.
    - `updated_at` string, date-time — Timestamp of when the Dataset was last updated. Cannot be set by clients.
    - `description` string — Required. Description of the dataset.
    - `configuration` DatasetDatasetConfiguration
      - `type` 'TRACES' | 'LOGS'
      - `trace_dataset` Configv1TraceDataset
        - `match_criteria` Configv1TraceSearchFilter
          - `trace` TraceSearchFilterTraceFilter
            - `duration` TraceSearchFilterDurationFilter
              - …
            - `error` TraceSearchFilterBoolFilter
              - …
          - `span` TraceSearchFilterSpanFilter[] — Specifies the span conditions to match on. All conditions must be true in a single span for the span to be considered a match. If `span_count` is specified, the number of spans within the trace that match span conditions must be within `[min, max]`. You can specify multiple span conditions, and each can be satisfied by any number of spans within the trace.
            - `match_type` 'INCLUDE' | 'EXCLUDE'
            - `service` TraceSearchFilterStringFilter
              - …
            - `operation` TraceSearchFilterStringFilter
              - …
            - `parent_service` TraceSearchFilterStringFilter
              - …
            - `parent_operation` TraceSearchFilterStringFilter
              - …
            - `duration` TraceSearchFilterDurationFilter
              - …
            - `error` TraceSearchFilterBoolFilter
              - …
            - `tags` TraceSearchFilterTagFilter[] — Matches the tags of the candidate span.
              - …
            - `span_count` TraceSearchFilterCountFilter
              - …
            - `is_root_span` TraceSearchFilterBoolFilter
              - …
      - `log_dataset` Configv1LogDataset
        - `match_criteria` Configv1LogSearchFilter
          - `query` string — Returns logs that match this query. The query can include only top-level operations. Nested clauses aren't supported. Only one type of `AND` or `OR` operator is allowed.

## Other responses

- `500` — An unexpected error response.
- `default` — An undefined error response.

---

[API](https://skmtc.net/chronosphere/apis/config-v1-api.md) · [All operations](https://skmtc.net/chronosphere/apis/config-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chronosphere/config-v1-api/versions/530951bd2ccf/schema)