---
title: "List notifiers"
method: GET
path: "/v2/notifiers"
tags: ["Notifiers"]
---

# List notifiers

`GET /v2/notifiers`

Returns notifier destinations visible to the caller, ordered by creation time with the newest notifier first.

## Query parameters

- `limit` integer
- `starting_after` string
- `ending_before` string
- `project_id` string
- `search` string
- `type` NotifierType[]

## Response `200`

OK

- ListNotifiersResponse
  - `object` string, required — Object discriminator for list responses; always `list`.
  - `data` Notifier[], required — Page of notifiers.
    - union — Notifier resource. The destination field present on the resource depends on `type` and is captured in `oneOf`.
      - object — `emails` is present for email notifiers.
        - `_id` string, required — Unique notifier identifier assigned by ORQ.
        - `project_id` string — Project that contains the notifier. Empty for workspace-wide notifiers.
        - `display_name` string, required — Human-readable notifier name.
        - `created_at` string, date-time, required — Time when the notifier was created.
        - `updated_at` string, date-time, required — Time when the notifier was last updated.
        - `created_by_id` string — User ID that created the notifier.
        - `updated_by_id` string — User ID that last updated the notifier.
        - `metadata` object — Custom JSON metadata stored with the notifier.
        - `type` 'NOTIFIER_TYPE_EMAIL', required
        - `emails` string[], required — Email addresses notified when `type` is `NOTIFIER_TYPE_EMAIL`.
        - `incoming_webhook_url` string — Slack incoming webhook URL used when `type` is `NOTIFIER_TYPE_SLACK_WEBHOOK`.
        - `webhook_url` string — Generic webhook URL used when `type` is `NOTIFIER_TYPE_WEBHOOK`.
        - `headers` object — Optional HTTP headers for generic webhooks. Each entry may be a string value or an object with `secret` and `value`.
      - object — `incoming_webhook_url` is present for Slack webhook notifiers.
        - `_id` string, required — Unique notifier identifier assigned by ORQ.
        - `project_id` string — Project that contains the notifier. Empty for workspace-wide notifiers.
        - `display_name` string, required — Human-readable notifier name.
        - `created_at` string, date-time, required — Time when the notifier was created.
        - `updated_at` string, date-time, required — Time when the notifier was last updated.
        - `created_by_id` string — User ID that created the notifier.
        - `updated_by_id` string — User ID that last updated the notifier.
        - `metadata` object — Custom JSON metadata stored with the notifier.
        - `type` 'NOTIFIER_TYPE_SLACK_WEBHOOK', required
        - `emails` string[] — Email addresses notified when `type` is `NOTIFIER_TYPE_EMAIL`.
        - `incoming_webhook_url` string, required — Slack incoming webhook URL used when `type` is `NOTIFIER_TYPE_SLACK_WEBHOOK`.
        - `webhook_url` string — Generic webhook URL used when `type` is `NOTIFIER_TYPE_WEBHOOK`.
        - `headers` object — Optional HTTP headers for generic webhooks. Each entry may be a string value or an object with `secret` and `value`.
      - object — `webhook_url` is present for generic webhook notifiers; `headers` is optional.
        - `_id` string, required — Unique notifier identifier assigned by ORQ.
        - `project_id` string — Project that contains the notifier. Empty for workspace-wide notifiers.
        - `display_name` string, required — Human-readable notifier name.
        - `created_at` string, date-time, required — Time when the notifier was created.
        - `updated_at` string, date-time, required — Time when the notifier was last updated.
        - `created_by_id` string — User ID that created the notifier.
        - `updated_by_id` string — User ID that last updated the notifier.
        - `metadata` object — Custom JSON metadata stored with the notifier.
        - `type` 'NOTIFIER_TYPE_WEBHOOK', required
        - `emails` string[] — Email addresses notified when `type` is `NOTIFIER_TYPE_EMAIL`.
        - `incoming_webhook_url` string — Slack incoming webhook URL used when `type` is `NOTIFIER_TYPE_SLACK_WEBHOOK`.
        - `webhook_url` string, required — Generic webhook URL used when `type` is `NOTIFIER_TYPE_WEBHOOK`.
        - `headers` object — Optional HTTP headers for generic webhooks. Each entry may be a string value or an object with `secret` and `value`.
  - `has_more` boolean, required — Whether more notifiers are available in the selected pagination direction.

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/versions/41c02aedc7c0/schema)