---
title: "Get semantic field groups for an organization"
method: GET
path: "/api/{org_id}/alerts/deduplication/semantic-groups"
tags: ["Alerts"]
---

# Get semantic field groups for an organization

`GET /api/{org_id}/alerts/deduplication/semantic-groups`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/alerts/deduplication/semantic-groups`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/alerts/deduplication/semantic-groups/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `org_id` string, required

## Response `200`

Success

- FieldAlias[]
  - `display` string, required: Human-readable display name (e.g., "Host", "K8s Cluster")
  - `fields` string[], required: List of field names that are equivalent (e.g., ["host", "hostname", "node"]) Note: Field names can overlap with other groups. First-defined group wins.
  - `group` string, nullable: Category/group this semantic field belongs to (e.g., "Common", "Kubernetes", "AWS", "GCP", "Azure") Used for UI organization and preset templates
  - `id` string, required: Unique identifier (lowercase, dash-separated, e.g., "host", "k8s-cluster")
  - `is_workload_type` boolean: When true, this alias is a workload-type dimension used to build identity sets. Aliases with this flag are grouped by their `group` field to form `IdentitySet` entries with `distinguish_by` populated from those alias IDs. Aliases without this flag (HTTP, Database, System, etc.) are never used as identity set discriminators.

## Other responses

- `500`: Internal server error

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)