---
title: "Get MSTeams Subscription"
method: GET
path: "/NotificationSubscriptions/msteams"
tags: ["NotificationSubscriptions"]
---

# Get MSTeams Subscription

`GET /NotificationSubscriptions/msteams`

## Request

- Base URL: `https://sb2api.servicechannel.com/v3`
- URL: `https://sb2api.servicechannel.com/v3/NotificationSubscriptions/msteams`
- Auth: OAuth 2
  - Authorization code: `https://sb2login.servicechannel.com/oauth/authorize`
  - Token URL: `https://sb2login.servicechannel.com/oauth/token`
- TypeScript: <https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/docs/NotificationSubscriptions/msteams/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the details of the specified subscription.

## Query parameters

- `conversationId` string, required

## Response `200`

The requested subscription is in the response.

- ServiceChannelServicesMessagingNotificationsMSBotNotificationSubscriptionResponse: MSBotNotificationSubscriptionResponse
  - `Id` integer: Subscription identifier
  - `UserId` integer: Service Channel User identifier
  - `UserEmailAddress` string: Service Channel User Email Address
  - `SubscriberId` integer: Subscriber identifier
  - `ProviderId` integer: Provider identifier
  - `IsEnabled` boolean: Is Enabled
  - `ConversationReference` ServiceChannelServicesMessagingNotificationsMSBotConversationReference: MSBotConversationReference
    - `ConversationId` string: Gets or sets channel id
    - `TenantId` string: Gets or sets conversation's tenant ID
    - `UserId` string: Gets or sets the user identifier
    - `UserName` string: Gets or sets user name
    - `ServiceUrl` string: Gets or sets (Optional) Service endpoint where operations referenced

## Other responses

- `400`: The requested data are not found. <br/>Error codes: 502 - Subscription not found
- `401`: The request is not authorized. <br/>Error codes: 504 - Missing or incorrect authentication credentials

---

[API](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3.md) - [All operations](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/llms.txt) - [OpenAPI document](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/revisions/d490d6596809?raw)