YM REST Services

<back to all web services

EmailSuppressionList

Requires Authentication
Requires any of the roles:admin, oauthadmin
The following routes are available for this service:
GET/Ams/{ClientID}/EmailSuppressionListReturn a list of suppressed emails (hard, soft, complaint).
EmailSuppressionList Parameters:
NameParameterData TypeRequiredDescription
EmailSuppressionFilterqueryEmailSuppressionFilterNo

Allowable Values

  • Hard
  • Soft
  • Hard_Soft
  • Complaint
  • Hard_Complaint
  • Soft_Complaint
  • Hard_Soft_Complaint
PageSizequeryintNo
PageNumberqueryintNo
OffSetqueryintNo
OrderByquerystringNo
OrderByDirectionquerystringNo
EmailSearchStringquerystringNo
MemberBaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
MemberIDformintNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
EmailSuppressionListResponse Parameters:
NameParameterData TypeRequiredDescription
SuppressionListformList<EmailSuppression>No
TotalResultsCountformintNo
HardBounceHealthRateformdoubleNo
SoftBounceHealthRateformdoubleNo
ComplaintHealthRateformdoubleNo
EmailSuppression Parameters:
NameParameterData TypeRequiredDescription
EmailAddressformstringNo
SuppressionTypeformSuppressionTypeNo
IsActiveformboolNo
BounceCountformintNo
SuppressCountformintNo
SuppressedDateformDateTimeNo
LastRemovedformDateTimeNo
OriginalBounceDateformDateTimeNo
EstimatedRemovalDateformDateTimeNo
StatusformstringNo
BounceReasonformstringNo
FeedbackType_GroupformstringNo
FeedbackType_TypeformstringNo
FeedbackType_SubTypeformstringNo

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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

GET /Ams/{ClientID}/EmailSuppressionList HTTP/1.1 
Host: ws.yourmembership.com 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"SuppressionList":[{"EmailAddress":"String","SuppressionType":"None","IsActive":false,"BounceCount":0,"SuppressCount":0,"SuppressedDate":"0001-01-01T00:00:00.0000000","LastRemoved":"0001-01-01T00:00:00.0000000","OriginalBounceDate":"0001-01-01T00:00:00.0000000","EstimatedRemovalDate":"0001-01-01T00:00:00.0000000","Status":"String","BounceReason":"String","FeedbackType_Group":"String","FeedbackType_Type":"String","FeedbackType_SubType":"String"}],"TotalResultsCount":0,"HardBounceHealthRate":0,"SoftBounceHealthRate":0,"ComplaintHealthRate":0,"EmailSuppressionFilter":"Hard","PageSize":0,"PageNumber":0,"OffSet":0,"OrderBy":"String","OrderByDirection":"String","EmailSearchString":"String","MemberID":0,"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-03T06:11:36.3319874-04:00","Device":"Desktop"}