---
title: "Get notification targets by ids (getNotificationTargetsByIds)"
method: GET
path: "/api/notification/targets"
tags: ["notification-target-controller"]
---

# Get notification targets by ids (getNotificationTargetsByIds)

`GET /api/notification/targets`

Returns the list of notification targets found by provided ids.

Available for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority.

## Query parameters

- `pageSize` integer, required
- `page` integer, required
- `textSearch` string
- `sortProperty` string
- `sortOrder` string
- `notificationType` 'GENERAL' | 'ALARM' | 'DEVICE_ACTIVITY' | 'ENTITY_ACTION' | 'ALARM_COMMENT' | 'RULE_ENGINE_COMPONENT_LIFECYCLE_EVENT' | 'ALARM_ASSIGNMENT' | 'NEW_PLATFORM_VERSION' | 'ENTITIES_LIMIT' | 'ENTITIES_LIMIT_INCREASE_REQUEST' | 'API_USAGE_LIMIT' | 'RULE_NODE' | 'RATE_LIMITS' | 'EDGE_CONNECTION' | 'EDGE_COMMUNICATION_FAILURE' | 'TASK_PROCESSING_FAILURE' | 'RESOURCES_SHORTAGE'
- `ids` string[], required

## Response `200`

OK

- union
  - NotificationTarget[]
    - `id` NotificationTargetId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'NOTIFICATION_TARGET', required — string
    - `createdTime` integer — Entity creation timestamp in milliseconds since Unix epoch
    - `tenantId` TenantId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'TENANT', required — string
    - `name` string, required
    - `configuration` union, required
      - MicrosoftTeamsNotificationTargetConfig
        - `description` string
        - `type` string, required
        - `webhookUrl` string, required
        - `channelName` string, required
        - `useOldApi` boolean
        - `id` unknown
        - `title` string
        - `email` string
        - `firstName` string
        - `lastName` string
      - PlatformUsersNotificationTargetConfig
        - `description` string
        - `type` string, required
        - `usersFilter` union, required
          - AffectedTenantAdministratorsFilter
            - `type` string, required
          - AffectedUserFilter
            - `type` string, required
          - AllUsersFilter
            - `type` string, required
          - CustomerUsersFilter
            - `type` string, required
            - `customerId` string, uuid, required
          - OriginatorEntityOwnerUsersFilter
            - `type` string, required
          - SystemAdministratorsFilter
            - `type` string, required
          - TenantAdministratorsFilter
            - `type` string, required
            - `tenantsIds` string[]
            - `tenantProfilesIds` string[]
          - UserListFilter
            - `type` string, required
            - `usersIds` string[], required
      - SlackNotificationTargetConfig
        - `description` string
        - `type` string, required
        - `conversationType` 'DIRECT' | 'PUBLIC_CHANNEL' | 'PRIVATE_CHANNEL'
        - `conversation` SlackConversation, required
          - `type` 'DIRECT' | 'PUBLIC_CHANNEL' | 'PRIVATE_CHANNEL', required
          - `id` string, required
          - `name` string, required
          - `wholeName` string
          - `email` string
          - `title` string
  - PageDataNotificationTarget
    - `data` NotificationTarget[] — Array of the entities
      - `id` NotificationTargetId
        - `id` string, uuid, required — ID of the entity, time-based UUID v1
        - `entityType` 'NOTIFICATION_TARGET', required — string
      - `createdTime` integer — Entity creation timestamp in milliseconds since Unix epoch
      - `tenantId` TenantId
        - `id` string, uuid, required — ID of the entity, time-based UUID v1
        - `entityType` 'TENANT', required — string
      - `name` string, required
      - `configuration` union, required
        - MicrosoftTeamsNotificationTargetConfig
          - `description` string
          - `type` string, required
          - `webhookUrl` string, required
          - `channelName` string, required
          - `useOldApi` boolean
          - `id` unknown
          - `title` string
          - `email` string
          - `firstName` string
          - `lastName` string
        - PlatformUsersNotificationTargetConfig
          - `description` string
          - `type` string, required
          - `usersFilter` union, required
            - AffectedTenantAdministratorsFilter
              - …
            - AffectedUserFilter
              - …
            - AllUsersFilter
              - …
            - CustomerUsersFilter
              - …
            - OriginatorEntityOwnerUsersFilter
              - …
            - SystemAdministratorsFilter
              - …
            - TenantAdministratorsFilter
              - …
            - UserListFilter
              - …
        - SlackNotificationTargetConfig
          - `description` string
          - `type` string, required
          - `conversationType` 'DIRECT' | 'PUBLIC_CHANNEL' | 'PRIVATE_CHANNEL'
          - `conversation` SlackConversation, required
            - `type` 'DIRECT' | 'PUBLIC_CHANNEL' | 'PRIVATE_CHANNEL', required
            - `id` string, required
            - `name` string, required
            - `wholeName` string
            - `email` string
            - `title` string
    - `totalPages` integer — Total number of available pages. Calculated based on the 'pageSize' request parameter and total number of entities that match search criteria
    - `totalElements` integer — Total number of elements in all available pages
    - `hasNext` boolean — 'false' value indicates the end of the result set

---

[API](https://skmtc.net/thingsboard/apis/thingsboard-rest-api.md) · [All operations](https://skmtc.net/thingsboard/apis/thingsboard-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thingsboard/thingsboard-rest-api/revisions/40169ccdec5c/schema)