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

# List available noise suppression engines

> Returns all noise suppression engines available to the authenticated user. Engines gated behind a feature flag are included only when the flag is enabled for the user's account. Results are not paginated; the number of engines is expected to remain small.



## OpenAPI

````yaml /openapi/source/external/noise-suppression-engines/noise-suppression-engines.json get /noise_suppression_engines
openapi: 3.0.0
info:
  version: 1.0.0
  title: Noise Suppression Engines API
  contact:
    email: support@telnyx.com
servers:
  - url: https://api.telnyx.com/v2
    description: Version 2.0.0 of the Telnyx API
security:
  - bearerAuth: []
tags:
  - name: Noise Suppression Engines
    description: >-
      Noise suppression engines that can be selected when configuring noise
      suppression on voice connections.
paths:
  /noise_suppression_engines:
    get:
      tags:
        - Noise Suppression Engines
      summary: List available noise suppression engines
      description: >-
        Returns all noise suppression engines available to the authenticated
        user. Engines gated behind a feature flag are included only when the
        flag is enabled for the user's account. Results are not paginated; the
        number of engines is expected to remain small.
      operationId: listNoiseSuppressionEngines
      responses:
        '200':
          description: >-
            A list of noise suppression engines available to the authenticated
            user
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NoiseSuppressionEnginesListResponse'
              example:
                data:
                  - value: denoiser
                    label: Denoiser
                    default_attenuation_level: 0
                  - value: deep_filter_net
                    label: DeepFilterNet
                    default_attenuation_level: 80
        '401':
          description: >-
            Unauthorized — the request did not carry valid Telnyx API
            credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errors:
                  - code: '10009'
                    title: Authentication failed
                    detail: >-
                      The required authentication headers were either invalid or
                      not included in the request.
      x-codeSamples:
        - lang: JavaScript
          source: >-
            import Telnyx from 'telnyx';


            const client = new Telnyx({
              apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
            });


            // Automatically fetches more pages as needed.

            for await (const response of client.noiseSuppressionEngines.list())
            {
              console.log(response);
            }
        - lang: Python
          source: |
            import os
            from telnyx import Telnyx

            client = Telnyx(
                api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
            )
            page = client.noise_suppression_engines.list()
            print(page.data)
        - lang: Go
          source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/team-telnyx/telnyx-go\"\n\t\"github.com/team-telnyx/telnyx-go/option\"\n)\n\nfunc main() {\n\tclient := telnyx.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tnoiseSuppressionEngines, err := client.NoiseSuppressionEngines.List(context.TODO())\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", noiseSuppressionEngines.Data)\n}\n"
        - lang: Java
          source: |-
            package com.telnyx.sdk.example;

            import com.telnyx.sdk.client.TelnyxClient;
            import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;

            public final class Main {
                private Main() {}

                public static void main(String[] args) {
                    TelnyxClient client = TelnyxOkHttpClient.fromEnv();

                    var page = client.noiseSuppressionEngines().list();
                }
            }
        - lang: Ruby
          source: |-
            require "telnyx"

            telnyx = Telnyx::Client.new(api_key: "My API Key")

            page = telnyx.noise_suppression_engines.list

            puts(page)
        - lang: PHP
          source: >-
            <?php


            require_once dirname(__DIR__) . '/vendor/autoload.php';


            use Telnyx\Client;

            use Telnyx\Core\Exceptions\APIException;


            $client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API
            Key');


            try {
              $page = $client->noiseSuppressionEngines->list();

              var_dump($page);
            } catch (APIException $e) {
              echo $e->getMessage();
            }
        - lang: CLI
          source: |-
            telnyx noise-suppression-engines list \
              --api-key 'My API Key'
components:
  schemas:
    NoiseSuppressionEnginesListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/NoiseSuppressionEngine'
      required:
        - data
    ErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            required:
              - code
              - title
            properties:
              code:
                type: string
              title:
                type: string
              detail:
                type: string
              meta:
                type: object
                properties:
                  url:
                    type: string
              source:
                type: object
                properties:
                  pointer:
                    type: string
      required:
        - errors
    NoiseSuppressionEngine:
      type: object
      description: A noise suppression engine available to the authenticated user.
      properties:
        value:
          type: string
          description: >-
            Machine-readable identifier of the engine, used when configuring
            noise suppression.
          example: denoiser
        label:
          type: string
          description: Human-readable name of the engine.
          example: Denoiser
        default_attenuation_level:
          type: integer
          description: >-
            Default attenuation level of the engine (0-100, in multiples of
            ten).
          minimum: 0
          maximum: 100
          multipleOf: 10
          example: 0
      required:
        - value
        - label
        - default_attenuation_level
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````