---
title: "List subscriptions"
method: GET
path: "/v6/subscriptions"
tags: ["User Subscriptions"]
---

# List subscriptions

`GET /v6/subscriptions`

Returns all notification subscriptions for the calling client, optionally filtered by tags. Use `having_any_tags` to match subscriptions that have at least one of the specified tags, or `having_all_tags` to match subscriptions that have all specified tags.

## Query parameters

- `having_any_tags` string, nullable
- `having_all_tags` string, nullable

## Response `200`

Successful response

- SubscriptionResponse[]
  - `channels` SubscriptionChannelResponse[], required
    - union
      - EmailSubscriptionChannelResponse
        - `id` string, required
        - `type` 'EMAIL', required
      - ExtoleClientSlackSubscriptionChannelResponse
        - `id` string, required
        - `type` 'EXTOLE_CLIENT_SLACK', required
      - SlackSubscriptionChannelResponse
        - `id` string, required
        - `type` 'SLACK', required
        - `webhook_url` string, required
      - ThirdPartyEmailSubscriptionChannelResponse
        - `id` string, required
        - `type` 'THIRD_PARTY_EMAIL', required
        - `recipient` string, required
      - WebhookSubscriptionChannelResponse
        - `id` string, required
        - `type` 'WEBHOOK', required
        - `webhook_id` string, required
  - `dedupe_duration_ms` integer, required
  - `filtering_level` 'ALL' | 'NONE' | 'NOTEWORTHY' | 'SOME', required
  - `having_all_tags` string[], required
  - `subscription_id` string, required
  - `user` SubscriptionUserResponse, required
    - `email` string
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `user_id` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `403` — Forbidden
- `415` — Unsupported Media Type
- `429` — Too Many Requests

---

[API](https://skmtc.net/extole/apis/integration-api-server-to-extole.md) · [All operations](https://skmtc.net/extole/apis/integration-api-server-to-extole/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/extole/integration-api-server-to-extole/revisions/c16e62e66755/schema)