---
title: "Get bot lists"
method: GET
path: "/firewall/apps/{app_id}/bot-lists"
---

# Get bot lists

`GET /firewall/apps/{app_id}/bot-lists`

## Request

- Base URL: `https://app.aikido.dev/api/public/v1`
- URL: `https://app.aikido.dev/api/public/v1/firewall/apps/{app_id}/bot-lists`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://app.aikido.io/api/oauth/token` scopes: `firewall:read`

Get the bot lists configuration for an app

## Path parameters

- `app_id` integer, required

## Response `200`

The bot lists configuration has been successfully fetched

- object[]
  - `code` string
  - `name` string
  - `mode` 'ignore' | 'monitor' | 'block': ignore: Not subscribed, monitor: Subscribed but monitoring only, block: Subscribed and blocking

## Other responses

- `404`: App not found

---

[API](https://skmtc.dev/aikido/apis/aikido-security-api-documentation.md) - [All operations](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/revisions/da8691338133?raw)