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

# Get Suppressions

> Get the org suppression list — the emails and phone numbers excluded from automated messaging.



## OpenAPI

````yaml https://api.useinvent.com/openapi.json get /orgs/{org_id}/suppressions
openapi: 3.1.0
info:
  version: 1.0.0
  title: Invent API
servers:
  - url: https://api.useinvent.com
security:
  - bearerAuth: []
paths:
  /orgs/{org_id}/suppressions:
    get:
      tags:
        - Orgs Suppressions
      summary: Get Suppressions
      description: >-
        Get the org suppression list — the emails and phone numbers excluded
        from automated messaging.
      parameters:
        - schema:
            type: string
          required: true
          description: The ID of the org
          name: org_id
          in: path
        - schema:
            type: string
            maxLength: 256
            description: Search suppressions by identifier
          required: false
          description: Search suppressions by identifier
          name: search
          in: query
        - schema:
            $ref: '#/components/schemas/SuppressionChannelSchema'
          required: false
          description: The channel an identifier is suppressed on
          name: channel
          in: query
        - schema:
            $ref: '#/components/schemas/SuppressionReasonSchema'
          required: false
          description: Why the identifier is suppressed
          name: reason
          in: query
        - schema:
            $ref: '#/components/schemas/SuppressionSourceSchema'
          required: false
          description: What put the identifier on the list
          name: source
          in: query
        - schema:
            type: number
          required: false
          description: Page number
          name: page
          in: query
        - schema:
            type: number
          required: false
          description: Number of items to take
          name: take
          in: query
        - schema:
            type: string
          required: false
          description: Next page token (Only used on special endpoints)
          name: next
          in: query
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuppressionSchema'
components:
  schemas:
    SuppressionChannelSchema:
      type: string
      enum:
        - EMAIL
        - PHONE
      description: The channel an identifier is suppressed on
    SuppressionReasonSchema:
      type: string
      enum:
        - BOUNCE
        - COMPLAINT
        - UNSUBSCRIBE
        - MANUAL
        - LEGAL
      description: Why the identifier is suppressed
    SuppressionSourceSchema:
      type: string
      enum:
        - WEBHOOK
        - UNSUBSCRIBE_LINK
        - ADMIN
        - IMPORT
        - API
      description: What put the identifier on the list
    SuppressionSchema:
      type: object
      properties:
        id:
          type: string
        channel:
          $ref: '#/components/schemas/SuppressionChannelSchema'
        identifier:
          type: string
        reason:
          $ref: '#/components/schemas/SuppressionReasonSchema'
        source:
          $ref: '#/components/schemas/SuppressionSourceSchema'
        note:
          type:
            - string
            - 'null'
        metadata:
          $ref: '#/components/schemas/SuppressionMetadataSchema'
        created_by:
          allOf:
            - $ref: '#/components/schemas/UserLimitedSchema'
            - type:
                - object
                - 'null'
              description: >-
                Who added the entry. Null when it landed automatically (bounce,
                complaint, unsubscribe link).
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - id
        - channel
        - identifier
        - reason
        - source
        - note
        - metadata
        - created_by
        - created_at
        - updated_at
      description: Schema for the suppression
    SuppressionMetadataSchema:
      type:
        - object
        - 'null'
      properties:
        diagnostic_code:
          type: string
          maxLength: 1024
        complaint_type:
          type: string
          maxLength: 128
        feedback:
          type: string
          maxLength: 1024
        broadcast_id:
          type: string
        import_batch_id:
          type: string
      description: Diagnostic context kept alongside a suppression
    UserLimitedSchema:
      type: object
      properties:
        id:
          type: string
        name:
          type:
            - string
            - 'null'
        email:
          type: string
          format: email
        avatar:
          type:
            - string
            - 'null'
        seen_at:
          type:
            - string
            - 'null'
          format: date-time
      required:
        - id
        - name
        - email
        - avatar
        - seen_at
      description: The assigned user for the conversation
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: Bearer token authentication using your API key

````