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

# List all suppressed contacts or domains

Retrieves a list of all suppressed email addresses and domains within the organization. Results can be sorted by contact/domain, blocked count, or creation date in ascending or descending order. Suppressed entries prevent emails from being received from those addresses or domains.


## OpenAPI

````yaml https://api.getfernand.com/openapi.json get /contacts/suppressed
openapi: 3.0.3
info:
  title: Fernand API Documentation
  version: '3.0'
  description: This is the documentation for the [Fernand](https://getfernand.com) API.
  termsOfService: https://getfernand.com/terms
  contact:
    name: Fernand Support
    url: https://getfernand.com
    email: support@getfernand.com
  x-logo:
    url: https://app.getfernand.com/images/favicon/icon_128.png
servers:
  - url: https://api.getfernand.com
    description: ''
    x-last-modified: 1764750693905
security:
  - apiKeyHeader: []
externalDocs:
  description: You can access our documentation online by visiting https://api.fernand.help
  url: https://api.fernand.help
paths:
  /contacts/suppressed:
    get:
      tags:
        - Contact Suppressions
      summary: List all suppressed contacts or domains
      description: >-
        Retrieves a list of all suppressed email addresses and domains within
        the organization. Results can be sorted by contact/domain, blocked
        count, or creation date in ascending or descending order. Suppressed
        entries prevent emails from being received from those addresses or
        domains.
      operationId: listSuppressedContacts
      parameters:
        - name: order_by
          in: query
          required: false
          schema:
            type: string
            enum:
              - contact
              - blocked
              - created
            default: created
          description: Field to order results by. "contact" orders by domain name.
          example: created
        - name: way
          in: query
          required: false
          schema:
            type: string
            enum:
              - asc
              - desc
            default: asc
          description: Sort direction for the results.
          example: desc
      responses:
        '200':
          description: List of suppressed contacts retrieved successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                      format: int64
                      description: Unique identifier for the suppression record
                      example: 123
                    email:
                      type: string
                      description: >-
                        Suppressed email address or domain pattern (e.g.,
                        "*@domain.com")
                      example: spam@hooli.com
                    created:
                      type: string
                      format: date-time
                      description: Timestamp when the suppression was created (UTC)
                      example: '2024-01-15T10:30:00Z'
                    blocked:
                      type: integer
                      description: >-
                        Number of times emails to this address/domain have been
                        blocked
                      example: 5
                    is_common:
                      type: boolean
                      description: >-
                        Whether this is a common webmail domain (true) or a
                        company domain (false)
                      example: true
        '400':
          description: Invalid order_by or way parameter.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
components:
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      description: >-
        Authenticate your account by including your secret key in API requests.

        You can manage your API keys in the
        [Dashboard](https://app.getfernand.com/).


        Authentication to the API is performed by using the HTTP Header
        X-API-Key.
      name: X-API-Key
      in: header
      x-last-modified: 1764750344730

````