---
title: "/:channel"
method: GET
path: "/bot/filters/{channel}"
tags: ["filters"]
---

# /:channel

`GET /bot/filters/{channel}`

## Request

- Base URL: `https://api.streamelements.com/kappa/v2`
- URL: `https://api.streamelements.com/kappa/v2/bot/filters/{channel}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.streamelements.com/oauth2/authorize`
    - Token URL: `https://api.streamelements.com/oauth2/token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/streamelements/apis/se-api-docs/docs/bot/filters/:channel/get.ts> (a function with typed inputs; its response is checked against the schema)

List filters

## Path parameters

- `channel` string, required

## Headers

- `Accept` string, required

## Response `200`

- BotFilters
  - `caps` Caps, required
    - `timeout` Timeout, required
      - `length` integer, required
    - `settings` Settings, required
      - `limit` integer, required
      - `min` integer, required
      - `percent` integer, required
    - `enabled` boolean, required
    - `exclude` integer, required
  - `links` Links, required
    - `timeout` Timeout, required
      - `length` integer, required
    - `enabled` boolean, required
    - `exclude` integer, required
    - `whitelist` string[], required
    - `blacklist` string[], required
  - `banphrases` Banphrases, required
    - `enabled` boolean, required
  - `emotes` Emotes, required
    - `timeout` Timeout, required
      - `length` integer, required
    - `settings` TimeoutSettings, required
      - `limit` integer, required
    - `enabled` boolean, required
    - `exclude` integer, required
  - `symbols` Symbols, required
    - `timeout` Timeout, required
      - `length` integer, required
    - `settings` Settings, required
      - `limit` integer, required
      - `min` integer, required
      - `percent` integer, required
    - `enabled` boolean, required
    - `exclude` integer, required
  - `paragraph` Paragraph, required
    - `timeout` Timeout, required
      - `length` integer, required
    - `settings` TimeoutSettings, required
      - `limit` integer, required
    - `enabled` boolean, required
    - `exclude` integer, required

## Changes

- **2021-02-08** `fb6ec574b6a7`: 7 breaking, 6 info
  - the `banphrases` response's property type changed from `array` to `object` for status `200`
  - removed the required property `_id` from the response with the `200` status
  - removed the required property `activitySettings` from the response with the `200` status
  - removed the required property `botFilters` from the response with the `200` status
  - …9 more
- **2021-02-07** `8c745ed2e9e4`: 12 warning
  - the optional response header `Access-Control-Allow-Credentials` removed for the status `200`
  - the optional response header `Access-Control-Expose-Headers` removed for the status `200`
  - the optional response header `ETag` removed for the status `200`
  - the optional response header `Server` removed for the status `200`
  - …8 more

[Operation history](https://skmtc.dev/streamelements/apis/se-api-docs/changes/bot/filters/:channel/get.md)

---

[API](https://skmtc.dev/streamelements/apis/se-api-docs.md) - [All operations](https://skmtc.dev/streamelements/apis/se-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/streamelements/apis/se-api-docs/revisions/aa13169b9373?raw)