YM REST Services

<back to all web services

CampaignReports

Requires Authentication
Requires any of the roles:admin, oauthadmin
The following routes are available for this service:
GET/Ams/{ClientID}/CampaignReports/{CampaignId}/MessagesReturn the Campaign Report details.
GET/Ams/{ClientID}/CampaignReports/{CampaignId}Return the Campaign Report details.
GET/Ams/{ClientID}/CampaignReports/{CampaignId}/Messages/{MessageId}Return a message's trace actions.
CampaignReports Parameters:
NameParameterData TypeRequiredDescription
CampaignIdpathintNo
MessageIdpathstringNo
ActivityFilterqueryintNo
RequestActionqueryRequestActionNo
FromDatequeryDateTimeNo
ToDatequeryDateTimeNo
TotalActivityqueryintNo
PageSizequeryintNo
PageNumberqueryintNo
BaseDto Parameters:
NameParameterData TypeRequiredDescription
UsingRedisformboolNo
AppInitTimeformDateTimeNo
ServerIDformstringNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
CampaignReportsResponse Parameters:
NameParameterData TypeRequiredDescription
TotalformCampaignReportItem<int>No
RateformCampaignReportItem<float>No
DailyTotalformList<CampaignReportItem<Int32>>No
DailyRateformList<CampaignReportItem<Single>>No
MessageActivityformList<CampaignReportMessageActivity>No
MessagesformList<CampaignReportMessage>No
CampaignReportItem<T> Parameters:
NameParameterData TypeRequiredDescription
DateformDateTime?No
ListSizeformTNo
ProcessformTNo
SendformTNo
DeliveryformTNo
OpenformTNo
OpenUniqueformTNo
ClickformTNo
ClickUniqueformTNo
HardBounceformTNo
SoftBounceformTNo
ComplaintformTNo
CategoryOptOutformTNo
EmailOptOutformTNo
SuppressHardBounceformTNo
SuppressCategoryOptOutformTNo
SuppressEmailOptOutformTNo
SuppressComplaintformTNo
FailformTNo
RejectformTNo
NotOpenformTNo
NotSendformTNo
AccountabilityformTNo
EngagementScoreformTNo
SuccessRateformTNo
CampaignReportMessageActivity Parameters:
NameParameterData TypeRequiredDescription
TypeIdformintNo
NameformstringNo
DateformDateTimeNo
CampaignReportMessage Parameters:
NameParameterData TypeRequiredDescription
MemberIdformintNo
FirstNameformstringNo
LastNameformstringNo
EmailformstringNo
MessageGuidformstringNo
ActivityformCampaignReportMessageActivityNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv

HTTP + CSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /Ams/{ClientID}/CampaignReports/{CampaignId}/Messages HTTP/1.1 
Host: ws.yourmembership.com 
Accept: text/csv
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

{"Total":{"Date":"0001-01-01T00:00:00.0000000","ListSize":0,"Process":0,"Send":0,"Delivery":0,"Open":0,"OpenUnique":0,"Click":0,"ClickUnique":0,"HardBounce":0,"SoftBounce":0,"Complaint":0,"CategoryOptOut":0,"EmailOptOut":0,"SuppressHardBounce":0,"SuppressCategoryOptOut":0,"SuppressEmailOptOut":0,"SuppressComplaint":0,"Fail":0,"Reject":0,"NotOpen":0,"NotSend":0,"Accountability":0,"EngagementScore":0,"SuccessRate":0},"Rate":{"Date":"0001-01-01T00:00:00.0000000","ListSize":0,"Process":0,"Send":0,"Delivery":0,"Open":0,"OpenUnique":0,"Click":0,"ClickUnique":0,"HardBounce":0,"SoftBounce":0,"Complaint":0,"CategoryOptOut":0,"EmailOptOut":0,"SuppressHardBounce":0,"SuppressCategoryOptOut":0,"SuppressEmailOptOut":0,"SuppressComplaint":0,"Fail":0,"Reject":0,"NotOpen":0,"NotSend":0,"Accountability":0,"EngagementScore":0,"SuccessRate":0},"DailyTotal":[{"Date":"0001-01-01T00:00:00.0000000","ListSize":0,"Process":0,"Send":0,"Delivery":0,"Open":0,"OpenUnique":0,"Click":0,"ClickUnique":0,"HardBounce":0,"SoftBounce":0,"Complaint":0,"CategoryOptOut":0,"EmailOptOut":0,"SuppressHardBounce":0,"SuppressCategoryOptOut":0,"SuppressEmailOptOut":0,"SuppressComplaint":0,"Fail":0,"Reject":0,"NotOpen":0,"NotSend":0,"Accountability":0,"EngagementScore":0,"SuccessRate":0}],"DailyRate":[{"Date":"0001-01-01T00:00:00.0000000","ListSize":0,"Process":0,"Send":0,"Delivery":0,"Open":0,"OpenUnique":0,"Click":0,"ClickUnique":0,"HardBounce":0,"SoftBounce":0,"Complaint":0,"CategoryOptOut":0,"EmailOptOut":0,"SuppressHardBounce":0,"SuppressCategoryOptOut":0,"SuppressEmailOptOut":0,"SuppressComplaint":0,"Fail":0,"Reject":0,"NotOpen":0,"NotSend":0,"Accountability":0,"EngagementScore":0,"SuccessRate":0}],"MessageActivity":[{"TypeId":0,"Name":"String","Date":"0001-01-01T00:00:00.0000000"}],"Messages":[{"MemberId":0,"FirstName":"String","LastName":"String","Email":"String","MessageGuid":"String","Activity":{"TypeId":0,"Name":"String","Date":"0001-01-01T00:00:00.0000000"}}],"CampaignId":0,"MessageId":"String","ActivityFilter":0,"RequestAction":"Details","FromDate":"0001-01-01T00:00:00.0000000","ToDate":"0001-01-01T00:00:00.0000000","TotalActivity":0,"PageSize":0,"PageNumber":0,"UsingRedis":true,"AppInitTime":"2024-05-03T02:57:06.8960121-04:00","ServerID":"WS-5-59-079","ClientID":0,"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}},"BypassCache":false,"DateCached":"2024-05-03T03:16:21.2026585-04:00","Device":"Desktop"}