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 .jsv suffix or ?format=jsv

HTTP + JSV

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: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	SuppressionList: 
	[
		{
			EmailAddress: String,
			SuppressionType: None,
			IsActive: False,
			BounceCount: 0,
			SuppressCount: 0,
			SuppressedDate: 0001-01-01,
			LastRemoved: 0001-01-01,
			OriginalBounceDate: 0001-01-01,
			EstimatedRemovalDate: 0001-01-01,
			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-03T08:39:18.3007400-04:00,
	Device: Desktop
}