Skip to main content
POST
/
suppression-groups
/
entries
curl --request POST \
  --url 'https://api.autosend.com/v1/suppression-groups/entries' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "groupId": "AB12C3",
    "reason": "unsubscribed",
    "page": 1,
    "limit": 20,
    "startDate": "2026-01-01T00:00:00.000Z",
    "endDate": "2026-03-01T00:00:00.000Z"
  }'

{
  "success": true,
  "data": {
    "entries": [
      {
        "id": "69b28d3f806d99a2a35e4f1d",
        "email": "[email protected]",
        "groupId": "AB12C3",
        "reason": "BOUNCE",
        "createdAt": "2026-03-12T09:54:07.697Z",
        "updatedAt": "2026-03-12T09:54:07.697Z"
      },
      {
        "id": "69aff842806d99a2a3527a5e",
        "email": "[email protected]",
        "groupId": "AB12C3",
        "reason": "BOUNCE",
        "createdAt": "2026-03-10T10:53:54.327Z",
        "updatedAt": "2026-03-10T10:53:54.327Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 142,
      "pages": 8
    }
  }
}

curl --request POST \
  --url 'https://api.autosend.com/v1/suppression-groups/entries' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "groupId": "AB12C3",
    "reason": "unsubscribed",
    "page": 1,
    "limit": 20,
    "startDate": "2026-01-01T00:00:00.000Z",
    "endDate": "2026-03-01T00:00:00.000Z"
  }'

{
  "success": true,
  "data": {
    "entries": [
      {
        "id": "69b28d3f806d99a2a35e4f1d",
        "email": "[email protected]",
        "groupId": "AB12C3",
        "reason": "BOUNCE",
        "createdAt": "2026-03-12T09:54:07.697Z",
        "updatedAt": "2026-03-12T09:54:07.697Z"
      },
      {
        "id": "69aff842806d99a2a3527a5e",
        "email": "[email protected]",
        "groupId": "AB12C3",
        "reason": "BOUNCE",
        "createdAt": "2026-03-10T10:53:54.327Z",
        "updatedAt": "2026-03-10T10:53:54.327Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 142,
      "pages": 8
    }
  }
}

​
Authorizations

​
Authorizations
string | header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
Body

​
groupId
string
Filter entries to a specific suppression group ID.
​
reason
string
Filter entries by suppression reason (e.g. unsubscribed, bounced, spam_complaint).
​
page
integer
Page number for pagination. Must be 1 or greater. Defaults to 1.
​
limit
integer
Number of results per page. Must be between 1 and 100. Defaults to 20.
​
search
string
Free-text search string matched against the email address or other entry fields.
​
startDate
string
ISO 8601 timestamp. Returns only entries created on or after this date.
​
endDate
string
ISO 8601 timestamp. Returns only entries created on or before this date.
​
email
string
Filter entries to a specific email address.
​
isGlobal
boolean
When true, returns only entries belonging to global suppression groups.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
groupId
string
Example:

"AB12C3"

​
reason
string
Example:

"unsubscribed"

​
page
integer
Required range: x >= 1
Example:

1

​
limit
integer
Required range: 1 <= x <= 100
Example:

20

​
search
string
Example:

"example.com"

​
startDate
string<date-time>
Example:

"2026-01-01T00:00:00.000Z"

​
endDate
string<date-time>
Example:

"2026-03-01T00:00:00.000Z"

​
email
string<email>
​
isGlobal
boolean
Example:

false

Response

200 - application/json

Paginated list of suppression entries.

​
success
boolean
Example:

true

​
data
object