GET v3/subscribers/{subscriberId}/events

https://api.questline.com/v3/subscribers/{subscriberId}/events

Gets a list of events for a subscriber.

Request Information

URI Parameters

Name Description Type Additional Info
subscriberId The ID of the subscriber. globally unique identifier Required

Body Parameters

None.

Filters

Name Description Usage
automatedCampaignId Filters the request by automated campaign ID. GET v3/subscribers/{subscriberId}/events?filter=automatedcampaignid~{operator}~{value}
automatedCampaignStepId Filters the request by automated campaign step ID. GET v3/subscribers/{subscriberId}/events?filter=automatedcampaignstepid~{operator}~{value}
date Filters the request by date. GET v3/subscribers/{subscriberId}/events?filter=date~{operator}~{value}
eventType Filters the request by event type. GET v3/subscribers/{subscriberId}/events?filter=eventtype~{operator}~{value}
newsletterCampaignId Filters the request by newsletter campaign ID. GET v3/subscribers/{subscriberId}/events?filter=newslettercampaignid~{operator}~{value}
newsletterCampaignSendId Filters the request by newsletter campaign send ID. GET v3/subscribers/{subscriberId}/events?filter=newslettercampaignsendid~{operator}~{value}
standardCampaignId Filters the request by standard campaign ID. GET v3/subscribers/{subscriberId}/events?filter=standardcampaignid~{operator}~{value}
standardCampaignSendId Filters the request by standard campaign send ID. GET v3/subscribers/{subscriberId}/events?filter=standardcampaignsendid~{operator}~{value}

Sorting

Name Description Usage
date Sorts the request by date. GET v3/subscribers/{subscriberId}/events?sort=date~{direction}

Paging

Name Description Usage
index The index to retrieve when requesting paged results. GET v3/subscribers/{subscriberId}/events?page=index~{value}
size The size of the page when requesting paged results. GET v3/subscribers/{subscriberId}/events?page=size~{value}

Response Information

Resource Description

GetSubscriberEventsResponseV3
Name Description Type Additional Info
SubscriberEvents The list of events. Collection of SubscriberEventV3 None.
NextPageUrl The URL of the next page of data for the list. string None.
PageIndex The index of the requested page. integer None.
PageSize The size of the requested page. integer None.
TotalPages The total number of pages, based on total results and page size. integer None.
TotalResults The total number of results. integer None.
Error The response error, if any. ResponseErrorV3 None.

Response Formats

application/json, text/json

Sample:

{
  "SubscriberEvents": [
    {
      "AutomatedCampaignId": 1,
      "AutomatedCampaignStepId": 1,
      "Date": "2025-04-03T22:17:25.8311862+00:00",
      "EventGuid": "35a5bfdb-f536-4a4d-bc5d-f0a03f862703",
      "EventType": "sample string 3",
      "StandardCampaignId": "4c011117-7cea-4316-8af5-c6d50f9cd8f1",
      "StandardCampaignSendId": "f02f178a-d243-464a-b814-e7216d822b6a",
      "SubscriberId": "58b809cf-fc89-4a66-a098-2a7cff25a178",
      "Target": "sample string 5",
      "Data": "sample string 6",
      "NewsletterCampaignId": 1,
      "NewsletterCampaignSendId": 1
    },
    {
      "AutomatedCampaignId": 1,
      "AutomatedCampaignStepId": 1,
      "Date": "2025-04-03T22:17:25.8311862+00:00",
      "EventGuid": "35a5bfdb-f536-4a4d-bc5d-f0a03f862703",
      "EventType": "sample string 3",
      "StandardCampaignId": "4c011117-7cea-4316-8af5-c6d50f9cd8f1",
      "StandardCampaignSendId": "f02f178a-d243-464a-b814-e7216d822b6a",
      "SubscriberId": "58b809cf-fc89-4a66-a098-2a7cff25a178",
      "Target": "sample string 5",
      "Data": "sample string 6",
      "NewsletterCampaignId": 1,
      "NewsletterCampaignSendId": 1
    }
  ],
  "NextPageUrl": "sample string 1",
  "PageIndex": 1,
  "PageSize": 1,
  "TotalPages": 1,
  "TotalResults": 1,
  "Error": {
    "ErrorId": 1,
    "ErrorMessage": "sample string 1"
  }
}

text/javascript, application/javascript, application/json-p

Sample:

/**/ typeof  === 'function' && ({"SubscriberEvents":[{"AutomatedCampaignId":1,"AutomatedCampaignStepId":1,"Date":"2025-04-03T22:17:25.8311862+00:00","EventGuid":"35a5bfdb-f536-4a4d-bc5d-f0a03f862703","EventType":"sample string 3","StandardCampaignId":"4c011117-7cea-4316-8af5-c6d50f9cd8f1","StandardCampaignSendId":"f02f178a-d243-464a-b814-e7216d822b6a","SubscriberId":"58b809cf-fc89-4a66-a098-2a7cff25a178","Target":"sample string 5","Data":"sample string 6","NewsletterCampaignId":1,"NewsletterCampaignSendId":1},{"AutomatedCampaignId":1,"AutomatedCampaignStepId":1,"Date":"2025-04-03T22:17:25.8311862+00:00","EventGuid":"35a5bfdb-f536-4a4d-bc5d-f0a03f862703","EventType":"sample string 3","StandardCampaignId":"4c011117-7cea-4316-8af5-c6d50f9cd8f1","StandardCampaignSendId":"f02f178a-d243-464a-b814-e7216d822b6a","SubscriberId":"58b809cf-fc89-4a66-a098-2a7cff25a178","Target":"sample string 5","Data":"sample string 6","NewsletterCampaignId":1,"NewsletterCampaignSendId":1}],"NextPageUrl":"sample string 1","PageIndex":1,"PageSize":1,"TotalPages":1,"TotalResults":1,"Error":{"ErrorId":1,"ErrorMessage":"sample string 1"}});