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

HTTP + XML

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

<EmailSuppressionListResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/YM.Web.Services.Ams">
  <BypassCache xmlns="http://schemas.datacontract.org/2004/07/YM.Toolkit">false</BypassCache>
  <ClientID xmlns="http://schemas.datacontract.org/2004/07/YM.Toolkit">0</ClientID>
  <Device xmlns="http://schemas.datacontract.org/2004/07/YM.Toolkit">Desktop</Device>
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types" xmlns="http://schemas.datacontract.org/2004/07/YM.Toolkit">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
  <MemberID xmlns="http://schemas.datacontract.org/2004/07/YM.Toolkit">0</MemberID>
  <EmailSearchString>String</EmailSearchString>
  <EmailSuppressionFilter>Hard</EmailSuppressionFilter>
  <OffSet>0</OffSet>
  <OrderBy>String</OrderBy>
  <OrderByDirection>String</OrderByDirection>
  <PageNumber>0</PageNumber>
  <PageSize>0</PageSize>
  <ComplaintHealthRate>0</ComplaintHealthRate>
  <HardBounceHealthRate>0</HardBounceHealthRate>
  <SoftBounceHealthRate>0</SoftBounceHealthRate>
  <SuppressionList>
    <EmailSuppression>
      <BounceCount>0</BounceCount>
      <BounceReason>String</BounceReason>
      <EmailAddress>String</EmailAddress>
      <EstimatedRemovalDate>0001-01-01T00:00:00</EstimatedRemovalDate>
      <FeedbackType_Group>String</FeedbackType_Group>
      <FeedbackType_SubType>String</FeedbackType_SubType>
      <FeedbackType_Type>String</FeedbackType_Type>
      <IsActive>false</IsActive>
      <LastRemoved>0001-01-01T00:00:00</LastRemoved>
      <OriginalBounceDate>0001-01-01T00:00:00</OriginalBounceDate>
      <Status>String</Status>
      <SuppressCount>0</SuppressCount>
      <SuppressedDate>0001-01-01T00:00:00</SuppressedDate>
      <SuppressionType>None</SuppressionType>
    </EmailSuppression>
  </SuppressionList>
  <TotalResultsCount>0</TotalResultsCount>
</EmailSuppressionListResponse>