> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autosend.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Suppression Entries

> Search for specific email addresses within a suppression group using the AutoSend API.

<RequestExample>
  ```bash cURL theme={null}
  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"
    }'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.autosend.com/v1/suppression-groups/entries",
      headers={
          "Authorization": "Bearer <token>",
          "Content-Type": "application/json",
      },
      json={
          "groupId": "AB12C3",
          "reason": "unsubscribed",
          "page": 1,
          "limit": 20,
          "startDate": "2026-01-01T00:00:00.000Z",
          "endDate": "2026-03-01T00:00:00.000Z",
      },
  )
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.autosend.com/v1/suppression-groups/entries",
    {
      method: "POST",
      headers: {
        Authorization: "Bearer <token>",
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        groupId: "AB12C3",
        reason: "unsubscribed",
        page: 1,
        limit: 20,
        startDate: "2026-01-01T00:00:00.000Z",
        endDate: "2026-03-01T00:00:00.000Z",
      }),
    }
  );
  const data = await response.json();
  console.log(data);
  ```

  ```php PHP theme={null}
  <?php
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, "https://api.autosend.com/v1/suppression-groups/entries");
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_POST, true);
  curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
      "groupId"   => "AB12C3",
      "reason"    => "unsubscribed",
      "page"      => 1,
      "limit"     => 20,
      "startDate" => "2026-01-01T00:00:00.000Z",
      "endDate"   => "2026-03-01T00:00:00.000Z",
  ]));
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      "Authorization: Bearer <token>",
      "Content-Type: application/json",
  ]);
  $response = curl_exec($ch);
  curl_close($ch);
  echo $response;
  ```

  ```go Go theme={null}
  package main

  import (
      "bytes"
      "encoding/json"
      "fmt"
      "io"
      "net/http"
  )

  func main() {
      payload, _ := json.Marshal(map[string]interface{}{
          "groupId":   "AB12C3",
          "reason":    "unsubscribed",
          "page":      1,
          "limit":     20,
          "startDate": "2026-01-01T00:00:00.000Z",
          "endDate":   "2026-03-01T00:00:00.000Z",
      })

      req, _ := http.NewRequest("POST", "https://api.autosend.com/v1/suppression-groups/entries", bytes.NewBuffer(payload))
      req.Header.Set("Authorization", "Bearer <token>")
      req.Header.Set("Content-Type", "application/json")

      client := &http.Client{}
      resp, _ := client.Do(req)
      defer resp.Body.Close()

      body, _ := io.ReadAll(resp.Body)
      fmt.Println(string(body))
  }
  ```

  ```java Java theme={null}
  import java.net.URI;
  import java.net.http.*;

  public class Main {
      public static void main(String[] args) throws Exception {
          String body = """
              {
                "groupId": "AB12C3",
                "reason": "unsubscribed",
                "page": 1,
                "limit": 20,
                "startDate": "2026-01-01T00:00:00.000Z",
                "endDate": "2026-03-01T00:00:00.000Z"
              }
              """;

          HttpRequest request = HttpRequest.newBuilder()
              .uri(URI.create("https://api.autosend.com/v1/suppression-groups/entries"))
              .header("Authorization", "Bearer <token>")
              .header("Content-Type", "application/json")
              .POST(HttpRequest.BodyPublishers.ofString(body))
              .build();

          HttpResponse<String> response = HttpClient.newHttpClient()
              .send(request, HttpResponse.BodyHandlers.ofString());
          System.out.println(response.body());
      }
  }
  ```

  ```ruby Ruby theme={null}
  require "net/http"
  require "uri"
  require "json"

  uri = URI("https://api.autosend.com/v1/suppression-groups/entries")
  req = Net::HTTP::Post.new(uri)
  req["Authorization"] = "Bearer <token>"
  req["Content-Type"] = "application/json"
  req.body = {
    groupId:   "AB12C3",
    reason:    "unsubscribed",
    page:      1,
    limit:     20,
    startDate: "2026-01-01T00:00:00.000Z",
    endDate:   "2026-03-01T00:00:00.000Z",
  }.to_json

  response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
  puts response.body
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "entries": [
        {
          "id": "69b28d3f806d99a2a35e4f1d",
          "email": "user@example.com",
          "groupId": "AB12C3",
          "reason": "BOUNCE",
          "createdAt": "2026-03-12T09:54:07.697Z",
          "updatedAt": "2026-03-12T09:54:07.697Z"
        },
        {
          "id": "69aff842806d99a2a3527a5e",
          "email": "another@example.com",
          "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
      }
    }
  }
  ```
</ResponseExample>

### Authorizations

<ParamField path="Authorizations" type="string | header" required>
  Bearer authentication header of the form Bearer `<token>`, where `<token>` is your auth token.
</ParamField>

#### Body

<ParamField body="groupId" type="string">
  Filter entries to a specific suppression group ID.
</ParamField>

<ParamField body="reason" type="string">
  Filter entries by suppression reason (e.g. `unsubscribed`, `bounced`, `spam_complaint`).
</ParamField>

<ParamField body="page" type="integer">
  Page number for pagination. Must be `1` or greater. Defaults to `1`.
</ParamField>

<ParamField body="limit" type="integer">
  Number of results per page. Must be between `1` and `100`. Defaults to `20`.
</ParamField>

<ParamField body="search" type="string">
  Free-text search string matched against the email address or other entry fields.
</ParamField>

<ParamField body="startDate" type="string">
  ISO 8601 timestamp. Returns only entries created on or after this date.
</ParamField>

<ParamField body="endDate" type="string">
  ISO 8601 timestamp. Returns only entries created on or before this date.
</ParamField>

<ParamField body="email" type="string">
  Filter entries to a specific email address.
</ParamField>

<ParamField body="isGlobal" type="boolean">
  When `true`, returns only entries belonging to global suppression groups.
</ParamField>


## OpenAPI

````yaml POST /suppression-groups/entries
openapi: 3.1.0
info:
  title: Suppression Groups API
  version: 1.0.0
  description: >-
    Manage suppression groups and suppression entries. Suppression groups let
    you categorize unsubscribes, bounces, and spam complaints so that you can
    control which emails are sent to which contacts.
servers:
  - url: https://api.autosend.com/v1
    description: Production
security:
  - bearerAuth: []
paths:
  /suppression-groups/entries:
    post:
      summary: Search Suppression Entries
      description: Searches suppression entries with optional filters and pagination.
      operationId: searchSuppressionEntries
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                groupId:
                  type: string
                  example: AB12C3
                reason:
                  type: string
                  example: unsubscribed
                page:
                  type: integer
                  minimum: 1
                  example: 1
                limit:
                  type: integer
                  minimum: 1
                  maximum: 100
                  example: 20
                search:
                  type: string
                  example: example.com
                startDate:
                  type: string
                  format: date-time
                  example: '2026-01-01T00:00:00.000Z'
                endDate:
                  type: string
                  format: date-time
                  example: '2026-03-01T00:00:00.000Z'
                email:
                  type: string
                  format: email
                  example: user@example.com
                isGlobal:
                  type: boolean
                  example: false
      responses:
        '200':
          description: Paginated list of suppression entries.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      entries:
                        type: array
                        items:
                          $ref: '#/components/schemas/SuppressionEntry'
                      total:
                        type: integer
                        example: 142
                      page:
                        type: integer
                        example: 1
                      limit:
                        type: integer
                        example: 20
components:
  schemas:
    SuppressionEntry:
      type: object
      properties:
        id:
          type: string
          example: entry_xyz789
        email:
          type: string
          format: email
          example: user@example.com
        groupId:
          type: string
          example: AB12C3
        reason:
          type: string
          example: unsubscribed
        createdAt:
          type: string
          format: date-time
          example: '2026-02-01T09:00:00.000Z'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer authentication header of the form `Bearer <token>`, where
        `<token>` is your auth token.

````