Documentation

GET /service/api/notifications/subscriptions/{subscriptionId}

Gets information about a specific subscription.

Request Information

URI Parameters

Name	Description	Type	Additional Information
subscriptionId	The identifier of the subscription to retrieve.	string	Required

URI Sample(s)

GET	https://unityapi.webrootcloudav.com/service/api/notifications/subscriptions/2da46f9d-ef97-4baa-aefd-57b557f9a30a

Body Parameters

None.

Response Information

Resource Description

Information about a specific subscription with information on the subscribed domain and event types.

GetSubscriptionResponseModel

Name	Description	Type	Additional Information
SubscriptionId	The subscription identifier.	string	None.
DeliveryType	The delivery type of the subscription.	string	None.
Domain	The domain the subscription has been created for.	SubscriptionResponseModelDomain	None.
EventTypes	The list of subscribed event types.	Collection of string	None.
Webhook	Information about webhook properties set for the subscription. This value is null, if DeliveryType is anything other than "webhook".	SubscriptionResponseModelWebhook	None.
CreatedDate	The time when the subscription was created.	date	None.
UpdatedDate	The time when the subscription was last updated.	date	None.

Sample Response

{
  "SubscriptionId": "d0e71eff-3834-418d-8317-3dfd8d563072",
  "DeliveryType": "fetch",
  "Domain": {
    "Type": "Site",
    "Values": [
      {
        "Name": "GSMKey",
        "Value": "2561-116F-545E-446B-9A7D"
      },
      {
        "Name": "SiteKey",
        "Value": "5C7D-5818-710D-48A0-B7F0"
      }
    ]
  },
  "EventTypes": [
    "Endpoint.FileDetection"
  ],
  "Webhook": {
    "DeliveryContext": "MyCustomCorrelationString",
    "DeliveryRateInSeconds": 90,
    "DeliveryUrl": "https://my.company.com/wrunity/notifications/webhook",
    "Suspended": false,
    "Statistics": null
  },
  "CreatedDate": "2024-12-29T02:50:48.3469463Z",
  "UpdatedDate": "2025-01-29T02:50:48.3469463Z"
}

<GetSubscriptionResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Notifications.Models">
  <CreatedDate>2024-12-29T02:50:48.3469463Z</CreatedDate>
  <DeliveryType>fetch</DeliveryType>
  <Domain>
    <Type>Site</Type>
    <Values>
      <SubscriptionResponseModelDomainValue>
        <Name>GSMKey</Name>
        <Value>2561-116F-545E-446B-9A7D</Value>
      </SubscriptionResponseModelDomainValue>
      <SubscriptionResponseModelDomainValue>
        <Name>SiteKey</Name>
        <Value>5C7D-5818-710D-48A0-B7F0</Value>
      </SubscriptionResponseModelDomainValue>
    </Values>
  </Domain>
  <EventTypes xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>Endpoint.FileDetection</d2p1:string>
  </EventTypes>
  <SubscriptionId>d0e71eff-3834-418d-8317-3dfd8d563072</SubscriptionId>
  <UpdatedDate>2025-01-29T02:50:48.3469463Z</UpdatedDate>
  <Webhook>
    <DeliveryContext>MyCustomCorrelationString</DeliveryContext>
    <DeliveryRateInSeconds>90</DeliveryRateInSeconds>
    <DeliveryUrl>https://my.company.com/wrunity/notifications/webhook</DeliveryUrl>
    <Statistics i:nil="true" />
    <Suspended>false</Suspended>
  </Webhook>
</GetSubscriptionResponseModel>