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

# List suppressions

> Newest first, cursor-paged. Requires `read`.



## OpenAPI

````yaml /api-reference/openapi.yaml get /v1/suppressions
openapi: 3.1.0
info:
  title: Sendbaze API
  version: '1.0'
  description: >
    Transactional email and SMS for Africa. Send from your own domain through
    Amazon SES in Cape Town.

    Every send returns an id immediately; delivery is reported by webhook and in
    the dashboard logs.
  contact:
    name: Sendbaze support
    email: support@sendbaze.com
    url: https://www.sendbaze.com
servers:
  - url: https://api.sendbaze.com
security:
  - bearerAuth: []
tags:
  - name: Emails
  - name: Templates
  - name: Domains
  - name: Suppressions
  - name: Webhooks
  - name: SMS
  - name: Usage
paths:
  /v1/suppressions:
    get:
      tags:
        - Suppressions
      summary: List suppressions
      description: Newest first, cursor-paged. Requires `read`.
      operationId: listSuppressions
      parameters:
        - name: email
          in: query
          description: Substring match on the address.
          schema:
            type: string
            maxLength: 254
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 200
            default: 50
        - $ref: '#/components/parameters/Cursor'
      responses:
        '200':
          description: A page of suppressions
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - nextCursor
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Suppression'
                  nextCursor:
                    type:
                      - string
                      - 'null'
components:
  parameters:
    Cursor:
      name: cursor
      in: query
      description: The `nextCursor` of the previous page.
      schema:
        type: string
  schemas:
    Suppression:
      type: object
      required:
        - id
        - email
        - reason
        - messageId
        - note
        - createdAt
      properties:
        id:
          type: string
          example: sup_01j9x7k2r4m8q3v5n6b7c8d9e0
        email:
          type: string
        reason:
          type: string
          enum:
            - hard_bounce
            - complaint
            - unsubscribe
            - manual
        messageId:
          type:
            - string
            - 'null'
          description: The message whose bounce
          complaint or unsubscribe created the entry.: null
        note:
          type:
            - string
            - 'null'
        createdAt:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An API key from the dashboard. `sk_live_…` sends; `sk_test_…` validates
        and returns ids without sending.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.