Sign in

v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB
Security Monitoring

List datasets

List all Cloud SIEM datasets available to the organization, including both customer-defined datasets and Datadog out-of-the-box datasets.

get/api/v2/security_monitoring/datasets

Query parameters

page[size]integer
Example:50

Size for a given page. The maximum allowed value is 100.

page[number]integer
Example:1

Specific page number to return.

sortstring
Example:name

Attribute used to sort datasets. Prefix with - to sort in descending order.

filter[query]string
Example:sample_dataset

A search query to filter datasets by name or description.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "createdAt": "2025-03-20T10:00:00Z",
        "createdByHandle": "bruce.lee",
        "createdByName": "Bruce Lee",
        "definition": {
          "columns": [
            {
              "column": "message",
              "type": "string"
            }
          ],
          "data_source": "logs",
          "name": "sample_dataset",
          "query_filter": "status = 'active'",
          "search": {
            "query": "*"
          },
          "storage": "hot",
          "table_name": "my_reference_table",
          "time_window": {
            "from": 1700000000000,
            "to": 1700003600000
          }
        },
        "description": "A sample dataset used for detection rules.",
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "modifiedAt": "2025-03-20T10:00:00Z",
        "name": "sample_dataset",
        "updatedByHandle": "bruce.lee",
        "updatedByName": "Bruce Lee",
        "version": 1
      },
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "type": "dataset"
    }
  ],
  "meta": {
    "totalCount": 1
  }
}