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

# List suppression rules

> Returns the organization's suppression rules, newest first. Suppressed visitors are still identified, but they consume no credits and trigger no webhooks or integrations. Paginated: `limit` defaults to 500 and caps at 5000. `counts` and `total` always describe the whole list, not the returned page. Authenticates via X-API-Key header.



## OpenAPI

````yaml https://api.aws53.cloud/openapi-data.json get /v1/data/suppression-rules
openapi: 3.1.0
info:
  title: Identification API
  version: 1.0.0
  description: >-
    Programmatic access to your visitor data and pixel management. Authenticate
    with your API key (X-API-Key header).
servers:
  - url: https://api.aws53.cloud
    description: Production
security:
  - apiKeyAuth: []
tags:
  - name: Visitors
  - name: Pixels
  - name: Account
  - name: Visitor Suppression
paths:
  /v1/data/suppression-rules:
    get:
      tags:
        - Visitor Suppression
      summary: List suppression rules
      description: >-
        Returns the organization's suppression rules, newest first. Suppressed
        visitors are still identified, but they consume no credits and trigger
        no webhooks or integrations. Paginated: `limit` defaults to 500 and caps
        at 5000. `counts` and `total` always describe the whole list, not the
        returned page. Authenticates via X-API-Key header.
      parameters:
        - schema:
            type: string
            enum:
              - email
              - domain
              - company_domain
              - industry
            description: Return only rules of this type
          required: false
          description: Return only rules of this type
          name: type
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 5000
            default: 500
          required: false
          name: limit
          in: query
        - schema:
            type:
              - integer
              - 'null'
            minimum: 0
            default: 0
          required: false
          name: offset
          in: query
      responses:
        '200':
          description: Suppression rules
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuppressionRuleList'
        '401':
          description: Missing or invalid API key
        '403':
          description: Revoked key or inactive organization
      security:
        - apiKeyAuth: []
components:
  schemas:
    SuppressionRuleList:
      type: object
      properties:
        data:
          type: object
          properties:
            rules:
              type: array
              items: bf1e5594-d19d-4d23-8b92-e23dd0972c2a
            counts:
              type: object
              properties:
                email:
                  type: number
                domain:
                  type: number
                company_domain:
                  type: number
                industry:
                  type: number
              required:
                - email
                - domain
                - company_domain
                - industry
              description: Stored rules per type, across the whole list
            total:
              type: number
              description: Total rules stored, ignoring the type filter
            filteredTotal:
              type: number
              description: Rules matching the type filter
            limit:
              type: number
            offset:
              type: number
            hasMore:
              type: boolean
          required:
            - rules
            - counts
            - total
            - filteredTotal
            - limit
            - offset
            - hasMore
      required:
        - data
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Organization API key (sk_...). Get yours from Settings > API Keys in the
        dashboard.

````