Suppression Groups
List Suppression Groups
List all suppression groups in your account using the AutoSend API.
GET
/
suppression-groups
curl --request GET \
--url 'https://api.autosend.com/v1/suppression-groups?includeGlobal=true' \
--header 'Authorization: Bearer <token>'
import requests
response = requests.get(
"https://api.autosend.com/v1/suppression-groups",
params={"includeGlobal": True},
headers={"Authorization": "Bearer <token>"},
)
print(response.json())
const response = await fetch(
"https://api.autosend.com/v1/suppression-groups?includeGlobal=true",
{
method: "GET",
headers: {
Authorization: "Bearer <token>",
},
}
);
const data = await response.json();
console.log(data);
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.autosend.com/v1/suppression-groups?includeGlobal=true");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer <token>",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.autosend.com/v1/suppression-groups?includeGlobal=true", nil)
req.Header.Set("Authorization", "Bearer <token>")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.*;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.autosend.com/v1/suppression-groups?includeGlobal=true"))
.header("Authorization", "Bearer <token>")
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
require "net/http"
require "uri"
uri = URI("https://api.autosend.com/v1/suppression-groups?includeGlobal=true")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer <token>"
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts response.body
{
"success": true,
"data": {
"groups": [
{
"id": "69044947cc370f8a63845236",
"groupId": "20XWO",
"name": "Marketing Unsubscribes",
"description": "Users who opted out of marketing",
"isGlobal": false,
"isActive": true,
"createdAt": "2025-10-31T05:29:43.906Z",
"updatedAt": "2026-02-27T10:16:26.095Z",
"suppressionCount": 0
},
{
"id": "69c3a0c19278fca074bebb74",
"groupId": "B43YU",
"name": "Bounced Addresses",
"description": "Hard bounces from transactional sends",
"isGlobal": true,
"isActive": true,
"createdAt": "2026-03-25T08:45:53.085Z",
"updatedAt": "2026-03-25T08:45:53.085Z",
"suppressionCount": 196
}
]
}
}
curl --request GET \
--url 'https://api.autosend.com/v1/suppression-groups?includeGlobal=true' \
--header 'Authorization: Bearer <token>'
import requests
response = requests.get(
"https://api.autosend.com/v1/suppression-groups",
params={"includeGlobal": True},
headers={"Authorization": "Bearer <token>"},
)
print(response.json())
const response = await fetch(
"https://api.autosend.com/v1/suppression-groups?includeGlobal=true",
{
method: "GET",
headers: {
Authorization: "Bearer <token>",
},
}
);
const data = await response.json();
console.log(data);
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.autosend.com/v1/suppression-groups?includeGlobal=true");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer <token>",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.autosend.com/v1/suppression-groups?includeGlobal=true", nil)
req.Header.Set("Authorization", "Bearer <token>")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.*;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.autosend.com/v1/suppression-groups?includeGlobal=true"))
.header("Authorization", "Bearer <token>")
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
require "net/http"
require "uri"
uri = URI("https://api.autosend.com/v1/suppression-groups?includeGlobal=true")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer <token>"
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts response.body
{
"success": true,
"data": {
"groups": [
{
"id": "69044947cc370f8a63845236",
"groupId": "20XWO",
"name": "Marketing Unsubscribes",
"description": "Users who opted out of marketing",
"isGlobal": false,
"isActive": true,
"createdAt": "2025-10-31T05:29:43.906Z",
"updatedAt": "2026-02-27T10:16:26.095Z",
"suppressionCount": 0
},
{
"id": "69c3a0c19278fca074bebb74",
"groupId": "B43YU",
"name": "Bounced Addresses",
"description": "Hard bounces from transactional sends",
"isGlobal": true,
"isActive": true,
"createdAt": "2026-03-25T08:45:53.085Z",
"updatedAt": "2026-03-25T08:45:53.085Z",
"suppressionCount": 196
}
]
}
}
Authorizations
string | header
required
Bearer authentication header of the form Bearer
<token>, where <token> is your auth token.Query Parameters
boolean
When
true, returns only global suppression groups, excluding any project-specific groups.boolean
When
true, includes global suppression groups in the results alongside project-specific groups.Response
Suppression groups retrieved successfullyboolean
Example:
trueobject
Show child attributes
Show child attributes
object[]
Array of suppression groups.
Show group attributes
Show group attributes
string
Unique identifier for the suppression group.
string
Short code identifier used when referencing the group in campaigns and templates.Example:
"20XWO"string
Display name of the suppression group.
string
Optional description of the suppression group.
boolean
Whether this is a global suppression group shared across all projects.
boolean
Whether the suppression group is active.
integer
Number of email addresses currently suppressed in this group.
string
ISO 8601 creation timestamp.
string
ISO 8601 last-updated timestamp.
Was this page helpful?
⌘I
curl --request GET \
--url 'https://api.autosend.com/v1/suppression-groups?includeGlobal=true' \
--header 'Authorization: Bearer <token>'
import requests
response = requests.get(
"https://api.autosend.com/v1/suppression-groups",
params={"includeGlobal": True},
headers={"Authorization": "Bearer <token>"},
)
print(response.json())
const response = await fetch(
"https://api.autosend.com/v1/suppression-groups?includeGlobal=true",
{
method: "GET",
headers: {
Authorization: "Bearer <token>",
},
}
);
const data = await response.json();
console.log(data);
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.autosend.com/v1/suppression-groups?includeGlobal=true");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer <token>",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.autosend.com/v1/suppression-groups?includeGlobal=true", nil)
req.Header.Set("Authorization", "Bearer <token>")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.*;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.autosend.com/v1/suppression-groups?includeGlobal=true"))
.header("Authorization", "Bearer <token>")
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
require "net/http"
require "uri"
uri = URI("https://api.autosend.com/v1/suppression-groups?includeGlobal=true")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer <token>"
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts response.body
{
"success": true,
"data": {
"groups": [
{
"id": "69044947cc370f8a63845236",
"groupId": "20XWO",
"name": "Marketing Unsubscribes",
"description": "Users who opted out of marketing",
"isGlobal": false,
"isActive": true,
"createdAt": "2025-10-31T05:29:43.906Z",
"updatedAt": "2026-02-27T10:16:26.095Z",
"suppressionCount": 0
},
{
"id": "69c3a0c19278fca074bebb74",
"groupId": "B43YU",
"name": "Bounced Addresses",
"description": "Hard bounces from transactional sends",
"isGlobal": true,
"isActive": true,
"createdAt": "2026-03-25T08:45:53.085Z",
"updatedAt": "2026-03-25T08:45:53.085Z",
"suppressionCount": 196
}
]
}
}