---
title: "List alert destinations"
method: GET
path: "/api/{org_id}/alerts/destinations"
tags: ["Alerts"]
---

# List alert destinations

`GET /api/{org_id}/alerts/destinations`

## 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/destinations`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/alerts/destinations/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of all alert destinations configured for an organization. Optionally filter by module type (alert or pipeline) to get specific destination categories. Returns destination names, types, and basic configuration details to help administrators manage notification routing and review available delivery options. Destinations the caller may not PUT come with the URL cut to its origin and header values and credential metadata blanked.

## Path parameters

- `org_id` string, required

## Query parameters

- `module` string
- `include_usage` boolean

## Response `200`

Success

- object[]
  - `auto_investigate` 'off' | 'critical'
  - `buttons` boolean, nullable: Acknowledge, Mute and Investigate on each message; default true.
  - `channel_id` string, nullable
  - `channel_name` string, nullable
  - `installation_id` string, nullable
  - `mention` union: Who a repeat or a level-up mentions; `Default` is `@here` for critical and nobody otherwise.
    - 'default'
    - 'here'
    - 'channel'
    - 'none'
    - object
      - `subteam` object, required
        - `handle` string, required
        - `subteam_id` string, required
  - `oncall_room_confirmed` boolean, nullable: Required true when an on-call team pages into this channel through a Slack webhook.
  - `previous_webhook` object, nullable: The webhook a switch replaced, kept so it can be switched back; never sent to.
  - `refire_reuse_minutes` integer, nullable: 0 to 240; default 30.
  - `shared_channel_confirmed` boolean, nullable: Required true when the channel is shared with another company.
  - `aws_region` string, nullable: AWS region for SNS destinations. Required when `type` is `sns`.
  - `destination_type_name` string, nullable: Specific destination type identifier (e.g., "openobserve", "splunk", "elasticsearch").
  - `emails` string[]: Email recipients for Email destinations. Required when `type` is `email`.
  - `headers` object, nullable: Optional HTTP headers for webhook requests; values read back blank without PUT.
  - `metadata` object: Optional key-value metadata; without PUT, values outside the known plain keys read blank.
  - `method` 'post' | 'put' | 'get'
  - `name` string: Unique name for this destination. Must be unique within the organization.
  - `output_format` union
    - 'json'
    - 'ndjson'
    - 'nestedevent'
    - object
      - `esbulk` object, required
        - `index` string, required
    - object
      - `stringseparated` object, required
        - `separator` string, required
  - `skip_tls_verify` boolean: Whether to skip TLS certificate verification for HTTP destinations.
  - `sns_topic_arn` string, nullable: SNS topic ARN for SNS destinations. Required when `type` is `sns`.
  - `template` string, nullable: REQUIRED for alert destinations. Name of the template to use for formatting alert messages. Use "Default" for the built-in default template. Without a template, the destination becomes a pipeline destination and cannot be used with alerts.
  - `type` 'http' | 'email' | 'sns' | 'slack_app'
  - `url` string: Webhook URL, required for `http`; without PUT, its origin, or empty for a keyed host.
  - `uses` DestinationUseResponse[], nullable: Every consumer referencing this destination; present only when `include_usage=true`.
    - `consumer` 'alert' | 'composite_alert' | 'pipeline' | 'synthetic_check' | 'oncall_policy' | 'oncall_team_channel' | 'workflow' | 'anomaly_detection' | 'incident_integration' | 'downtime', required: Wire form of `DestinationConsumer`; no wildcard arm, so a new consumer must compile here too.
    - `folder_id` string, nullable
    - `id` string, required
    - `name` string, required

## Other responses

- `400`: 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)