---
title: "Get all datasets"
method: GET
path: "/api/v2/datasets"
tags: ["Datasets"]
---

# Get all datasets

`GET /api/v2/datasets`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/datasets`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `user_access_read`

Get all datasets that have been configured for an organization.

## Response `200`

OK

- DatasetResponseMulti: Response containing a list of datasets.
  - `data` DatasetResponse[]: The list of datasets returned in response.
    - `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

- `403`: Not Authorized
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)