{"_id":"55fc249ff4dbbf0d008f43ef","project":"55dd9f2e0efd5821000d54d9","editedParams2":true,"__v":2,"category":{"_id":"55e047b258c5460d0076a9a7","__v":24,"project":"55dd9f2e0efd5821000d54d9","version":"55dd9f4dab0e4d210045aae9","pages":["55ed71142bdb6a2d0064f216","55ed71e1a872a80d00acff1a","55ed72a8df21af2b009e215f","55ef03aae7f5490d000c0dfd","55f1872e5fe76419007dc703","55f2af86d1c4c7170033df2b","55f2d812525cb12300c6c517","55f2db08c93a2d230062f971","55f2deaacb01c71900c8e218","55f2e024fb7aad2300bf1823","55f2e1f6525cb12300c6c554","55f2e47ffb7aad2300bf182b","55f2ea90525cb12300c6c56c","55f2ed9ecb01c71900c8e24a","55f2f26f71c6462100e0fdf1","55f2f2e3c93a2d230062f9af","55f2f3bdc93a2d230062f9b1","55fc1d6ae013770d008fcbf3","55fc249ff4dbbf0d008f43ef","55fc2bd3e013770d008fcc0b","55ffda3d8c0c9d0d00dcacb4","55ffdf828c0c9d0d00dcacba","55ffe1a56932a00d00ba7abc","560d322c3616cf0d00a8cc97"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-08-28T11:36:18.041Z","from_sync":false,"order":5,"slug":"contacts","title":"Contacts"},"editedParams":true,"user":"55dd9841cafe7221002a4c62","version":{"_id":"55dd9f4dab0e4d210045aae9","__v":39,"project":"55dd9f2e0efd5821000d54d9","createdAt":"2015-08-26T11:13:17.024Z","releaseDate":"2015-08-26T11:13:17.024Z","categories":["55dd9f4dab0e4d210045aaea","55ddb5fa9067202b00ddff6f","55e0472c6bad670d0081f213","55e04764a44fae0d00214671","55e047a9a44fae0d00214672","55e047b258c5460d0076a9a7","55e95e337fc27b2d00d32cf2","55e979bda7ca823900ad549a","55edb8c18dcb210d0056900b","55f0365c8563861700a33765","55f03677d58f9b1900acf996","55f036938eeefc23001ea5de","55f036a38563861700a33767","55f036c08563861700a33769","55f036d02911b72100482cd7","55f036e92911b72100482cd9","55f036fa8563861700a3376b","55f0370ee507711900e58c69","55f0371df6101b1900c70700","55f0374f2911b72100482cdb","55f0375e2911b72100482cdc","560eb0f659cb8d0d0015cd52","560eb25239fad419002ae1e0","561fb64d4d67490d00804b2a","562b9f775a39cd0d009aff22","562ba0505a39cd0d009aff23","562ba149d56bc30d00f0cb18","562ba595f68a5f0d007b1f3b","562ba78fd56bc30d00f0cb1b","562ba8b95a39cd0d009aff27","562baadf6562140d001501d2","562bab37f68a5f0d007b1f3d","562bc1bf9ebc950d000f7523","562bc99ced4bea0d00c11dfa","562bd29c1b98640d00714520","562bd5875a39cd0d009aff60","562bdfabff2da50d002c0aaf","562be0bd5a39cd0d009aff75","57a0b476d8313e1900454439"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-18T14:50:07.658Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"name":"","code":"var url = \"/v2/contacts/suppressed-since/2015-01-01\";\n\nusing (var httpClient = new HttpClient())\n{\n\thttpClient.BaseAddress = new Uri(\"https://api.dotmailer.com\");\n\tvar credentials = Encoding.ASCII.GetBytes(\"username:password\");\n\thttpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", Convert.ToBase64String(credentials));\n\tvar result = httpClient.GetAsync(url).Result;\n}","language":"csharp"},{"code":"","language":"json"},{"code":"$url = $baseUrl . “/v2/contacts/suppressed-since/2015-01-01“;\n$ch = curl_init();\ncurl_setopt($ch, CURLOPT_URL, $url);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt(\n\t$ch, CURLOPT_HTTPHEADER, array('Accept: application/json',\n    \t'Content-Type: application/json')\n);\ncurl_setopt($ch, CURLAUTH_BASIC, CURLAUTH_DIGEST);\ncurl_setopt(\n\t$ch, CURLOPT_USERPWD,\n    $apiUsername . ':' . $apiPassword\n);\n\t\t\t\n$response = json_decode(curl_exec($ch));","language":"php"}]},"method":"get","results":{"codes":[{"status":200,"language":"json","code":"[\n  {\n    \"suppressedContact\": {\n      \"id\": 25,\n      \"email\": \"terry.mccarthy:::at:::example.com\",\n      \"optInType\": \"VerifiedDouble\",\n      \"emailType\": \"Html\",\n      \"dataFields\": null,\n      \"status\": \"Unsubscribed\"\n    },\n    \"dateRemoved\": \"2015-02-24T13:06:42.933Z\",\n    \"reason\": \"Unsubscribed\"\n  },\n  {\n    \"suppressedContact\": {\n      \"id\": 38,\n      \"email\": \"eleanor.halloran@example.com\",\n      \"optInType\": \"Unknown\",\n      \"emailType\": \"PlainText\",\n      \"dataFields\": null,\n      \"status\": \"HardBounced\"\n    },\n    \"dateRemoved\": \"2015-09-20T09:40:18.527Z\",\n    \"reason\": \"HardBounced\"\n  },\n]","name":""}]},"settings":"","auth":"required","params":[{"_id":"55df006286ae7f0d00db4bf0","ref":"","in":"path","required":true,"desc":"The date from which any unsubscribed contacts are returned, which needs to be included within the URL.","default":"","type":"datetime","name":"Date"},{"_id":"55df006286ae7f0d00db4bef","ref":"","in":"query","required":false,"desc":"The select parameter requires a number between 1 and 1000 (0 is not a valid number). You may only select a maximum of 1000 results in a single request. This parameter goes within the URL.","default":"","type":"int","name":"Select"},{"_id":"55df006286ae7f0d00db4bee","ref":"","in":"query","required":false,"desc":"The skip parameter should be used in tandem with the select parameter when wanting to iterate through a whole data set. If you want to select the next 1000 records you should set the select parameter to 1000 and the skip parameter to 1000, which will return records 1001 to 2000. You should continue to do this until 0 records are returned to retrieve the whole data set. This parameter goes within the URL.","default":"","type":"int","name":"Skip"}],"url":"/v:version/contacts/suppressed-since/[Date]?select=[Select]&skip=[Skip]"},"isReference":false,"order":20,"body":"This operation can be used to a retrieve a list of contacts who have been suppressed in your account after a specified date, giving a reason for their suppression.\n\nPlease note that contact data field details are not returned in the results for suppressed contacts.\n\nThe possible suppression reasons can be:\n\n  * 'Unsubscribed' - The contact is unsubscribed from your communications\n  * 'SoftBounced' - The contact’s address is temporarily unavailable, possibly because their mailbox is too full, or their mail server won’t accept a message of the size sent, or their server is having temporary issues accepting any mail\n  * 'HardBounced' - The contact’s address is permanently unreachable, most likely because they, or the server they were hosted on, does not exist\n  * 'IspComplained' - The contact has submitted a spam complaint to us via their internet service provider\n  * 'MailBlocked' - The mail server indicated that it didn’t want to receive the mail. No reason was given \n  * 'DirectComplaint' - The contact has complained directly to either us, a hosting facility or possibly even a blacklist about receiving your communications\n  * 'Suppressed' - The contact that has been actively suppressed by you in your account\n  * 'NotAllowed' - The contact's email address is fully blocked from our system\n  * 'DomainSuppression' - The contact’s email domain is on your domain suppression list\n  * 'NoMxRecord' - The contact’s email domain does not have an MX DNS record. A mail exchange record provides the address of the mail server for that domain.","excerpt":"Gets a list of suppressed contacts after a given date along with the reason for suppression","slug":"get-suppressed-contacts-since-date","type":"endpoint","title":"Get suppressed contacts since date"}

getGet suppressed contacts since date

Gets a list of suppressed contacts after a given date along with the reason for suppression

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

Date:
required
datetime
The date from which any unsubscribed contacts are returned, which needs to be included within the URL.

Query Params

Select:
integer
The select parameter requires a number between 1 and 1000 (0 is not a valid number). You may only select a maximum of 1000 results in a single request. This parameter goes within the URL.
Skip:
integer
The skip parameter should be used in tandem with the select parameter when wanting to iterate through a whole data set. If you want to select the next 1000 records you should set the select parameter to 1000 and the skip parameter to 1000, which will return records 1001 to 2000. You should continue to do this until 0 records are returned to retrieve the whole data set. This parameter goes within the URL.

Examples


Result Format


Documentation

This operation can be used to a retrieve a list of contacts who have been suppressed in your account after a specified date, giving a reason for their suppression. Please note that contact data field details are not returned in the results for suppressed contacts. The possible suppression reasons can be: * 'Unsubscribed' - The contact is unsubscribed from your communications * 'SoftBounced' - The contact’s address is temporarily unavailable, possibly because their mailbox is too full, or their mail server won’t accept a message of the size sent, or their server is having temporary issues accepting any mail * 'HardBounced' - The contact’s address is permanently unreachable, most likely because they, or the server they were hosted on, does not exist * 'IspComplained' - The contact has submitted a spam complaint to us via their internet service provider * 'MailBlocked' - The mail server indicated that it didn’t want to receive the mail. No reason was given * 'DirectComplaint' - The contact has complained directly to either us, a hosting facility or possibly even a blacklist about receiving your communications * 'Suppressed' - The contact that has been actively suppressed by you in your account * 'NotAllowed' - The contact's email address is fully blocked from our system * 'DomainSuppression' - The contact’s email domain is on your domain suppression list * 'NoMxRecord' - The contact’s email domain does not have an MX DNS record. A mail exchange record provides the address of the mail server for that domain.