---
title: "Get a single dataset by ID"
method: GET
path: "/api/v2/datasets/{dataset_id}"
tags: ["Datasets"]
---

# Get a single dataset by ID

`GET /api/v2/datasets/{dataset_id}`

Retrieves the dataset associated with the ID.

## Path parameters

- `dataset_id` string, required

## Response `200`

OK

- DatasetResponseSingle — Response containing a single dataset object.
  - `data` DatasetResponse — **Datasets Object Constraints** - **Tag Limit per Dataset**: - Each restricted dataset supports a maximum of 10 key:value pairs per product. - **Tag Key Rules per Telemetry Type**: - Only one tag key or attribute may be used to define access within a single telemetry type. - The same or different tag key may be used across different telemetry types. - **Tag Value Uniqueness**: - Tag values must be unique within a single dataset. - A tag value used in one dataset cannot be reused in another dataset of the same telemetry type.
    - `attributes` DatasetAttributesResponse — Dataset metadata and configuration(s).
      - `created_at` string, date-time, nullable — Timestamp when the dataset was created.
      - `created_by` string, uuid — Unique ID of the user who created the dataset.
      - `name` string — Name of the dataset.
      - `principals` string[] — List of access principals, formatted as `principal_type:id`. Principal can be 'team' or 'role'.
      - `product_filters` FiltersPerProduct[] — List of product-specific filters.
        - `filters` string[], required — Defines the list of tag-based filters used to restrict access to telemetry data for a specific product. These filters act as access control rules. Each filter must follow the tag query syntax used by Datadog (such as `@tag.key:value`), and only one tag or attribute may be used to define the access strategy per telemetry type.
        - `product` string, required — Name of the product the dataset is for. Possible values are 'apm', 'rum', 'metrics', 'logs', 'error_tracking', 'cloud_cost', 'sd_repoinfo', and 'secruntime'.
    - `id` string — Unique identifier for the dataset.
    - `type` 'dataset' — Resource type, always set to `dataset`.

## Other responses

- `400` — Bad Request
- `403` — Not Authorized
- `404` — Not Found
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)