List suppressed addresses

Request

curl -X GET 'https://app.mailyte.com/api/v1/email-suppressions' \
  -H 'Authorization: Bearer mk_live_YOUR_API_KEY'

const response = await fetch('https://app.mailyte.com/api/v1/email-suppressions', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer mk_live_YOUR_API_KEY',
  },
});
const { data } = await response.json();

import requests
response = requests.get(
    "https://app.mailyte.com/api/v1/email-suppressions",
    headers={"Authorization": "Bearer mk_live_YOUR_API_KEY"},
)
data = response.json()["data"]

<?php

$response = Http::withToken('mk_live_YOUR_API_KEY')
    ->get('https://app.mailyte.com/api/v1/email-suppressions');

$data = $response->json('data');

require "net/http"
require "json"
uri = URI("https://app.mailyte.com/api/v1/email-suppressions")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer mk_live_YOUR_API_KEY"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

Response

Success.

• dataobject
  • dataarray<object>
    • objectstringsuppression
    • idstring
    • emailstring

      The address, or the bare domain when scope is domain. Always lowercase.

    • scopestringaddress | domain

      A domain rule blocks every recipient at that EXACT domain. Subdomains are separate rules, matching SendGrid and Mailgun, so a rule never blocks more than the string somebody typed.

    • applies_tostringall | marketing

      What this blocks. all stops every email, including app email such as receipts and password resets. marketing stops only marketing. An unsubscribe blocks marketing; a bounce or complaint blocks everything.

    • reasonstring

      Why the address is blocked: usually unsubscribed, complained, bounced or manual. Imported rows can carry other values (import by default), so do not treat this as a closed list.

    • sourcestringmanual | automatic

      manual is a person or your API call; automatic is our bounce and complaint listener. A manual entry is never downgraded to automatic by a later event.

    • notestring

      Your own note. Null when none was written; entries we add automatically have none.

    • suppressed_atstring

      When the address was blocked.

    • expires_atstring

      When the block ends and the address can be emailed again. Null means never, which is the case for everything you add and for every bounce, complaint and unsubscribe. The one block that ends: a mailbox that stayed full for three days is skipped for 30.

  • pagination_metaany

Returned inside the standard envelope.

Errors

Every status, with what causes it and what to do, is on the error reference.