List filter segments in lean form

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

List filter segments in Dynatrace with the Grail Filter Segments API in a minimal form for faster responses, with optional additional fields.

Overview

You use add-fields to request additional fields while listing filter segments in a minimal representational form. The operation returns all filter segments and is optimized for quicker response times than the detailed get-all endpoint.

Authentication

To execute this request, you need a platform token or OAuth access token with storage:filter-segments:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Response

{
  "filterSegments": [
    {
      "uid": "D82a1jdA23a",
      "name": "dev_environment",
      "variables": {
        "type": "query",
        "value": "fetch logs | limit 1"
      },
      "isPublic": false
    },
    {
      "uid": "aa2E2xA01yA",
      "name": "prod_environment",
      "variables": {
        "type": "query",
        "value": "fetch logs | limit 1"
      },
      "isPublic": true
    }
  ]
}

{
  "error": {
    "code": 400,
    "message": "Missing request header",
    "errorDetails": [
      {
        "type": "parameter",
        "parameterDescriptor": "Dt-Tenant",
        "message": "is required"
      }
    ]
  }
}