> For the complete documentation index, see [llms.txt](https://docs.b2core.b2broker.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.b2core.b2broker.com/back-office-guide/security/black-lists.md).

# Black lists

On this page, you can view a list of existing black lists and create new ones.

**Black lists** block specific IP addresses from accessing certain API endpoints. This feature helps quickly block unwanted traffic or potential attackers at the application level.

{% hint style="warning" %}
Blacklisting is an emergency measure and is not as reliable as blocking attackers at the server level. Contact your system administrators.
{% endhint %}

## General information

The following information is provided about each black list:

**ID**

The identifier of the black list.

***

**Route**

The API endpoint to which access is prohibited.

***

**IP**

The blacklisted IP address or subnet mask.

***

**Active**

The status of the black list.

***

**Comment**

The reason for blacklisting.

***

**Created at**

The date and time when the black list was created.

***

**Updated at**

The date and time when the black list was last updated.

## Examples

* **Block access to all API endpoints under a certain path**

To block access to all endpoints under `/api` for a given IP address, specify `/api/*` in the **Route** field.

* **Block access only to specific API endpoints under a certain path**

To block access to specific endpoints under a path while allowing access to others, specify the more detailed path in the **Route** field.

For example, by specifying `/api/v2/accounts/*`, you can block access to the endpoints, such as `/api/v2/accounts/:accountId` and `/api/v2/accounts/:accountId/balance`, but still allow access to `/api/v2/accounts` for a given IP address.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.b2core.b2broker.com/back-office-guide/security/black-lists.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.