> For the complete documentation index, see [llms.txt](https://docs.ncteam.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ncteam.io/nocodb/prosmotr-dannykh-get/filtraciya-zapisei-where.md).

# Фильтрация записей (where)

В предыдущей статье мы рассмотрели, как получить данные из таблицы NocoDB через GET-запрос. В этой статье разберём, **как фильтровать данные с помощью параметра `where`**.

Параметр `where` позволяет возвращать только те записи, которые соответствуют заданным условиям.

### Пример базы данных

В нашем примере используется таблица со **списком пользователей из разных городов**.

Она содержит следующие поля:

* First\_name
* Last\_name
* Phone\_number
* City
* Gender

<figure><img src="https://1945201336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FadGXspCXfuLDmMvBstfI%2Fuploads%2FprsnSzHVkbUinfPpVc4B%2Fimage.png?alt=media&amp;token=090f3d0e-aaf4-4a49-9e6f-3c4db18f4d7f" alt=""><figcaption></figcaption></figure>

### Проверка фильтра через Swagger

1. Откройте "**Swagger REST API"** вашего NocoDB.
2. Нажмите "**Authorize"** и добавьте API-токен.

<figure><img src="https://1945201336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FadGXspCXfuLDmMvBstfI%2Fuploads%2FdCAbfIRLb29Ipio78qIq%2Fimage.png?alt=media&amp;token=b68a6cf3-b7c2-47e6-b076-eb034b86ab92" alt=""><figcaption></figcaption></figure>

3. Найдите метод получения записей (`GET /records`).
4. Нажмите "**Try it out"**.

   <figure><img src="https://1945201336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FadGXspCXfuLDmMvBstfI%2Fuploads%2FFS51X2OOfcPTft910L16%2Fimage.png?alt=media&amp;token=421f970e-5948-46be-b78f-3f3dd0a9e695" alt=""><figcaption></figcaption></figure>

### Использование параметра `where`

В поле **where** указывается условие фильтрации.

Формат фильтра:

```
(поле,оператор,значение)
```

<figure><img src="https://1945201336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FadGXspCXfuLDmMvBstfI%2Fuploads%2FnqKzKAIt7ovuhw0pv79p%2Fimage.png?alt=media&amp;token=39ae448d-567f-45bf-bc29-74aa46b61e2d" alt=""><figcaption></figcaption></figure>

### Пример фильтра

Получим **пользователей женского пола из города Москва**.

Для этого используем выражение:

```json
(Gender,eq,Female)~and(City,eq,Москва)
```

Где:

* `Gender` — поле таблицы
* `eq` — оператор равенства
* `Female` — значение поля

Оператор `~and` объединяет несколько условий.

{% hint style="info" %}
Более подробно об операторах в [официальной документации ](https://nocodb.com/docs/product-docs/developer-resources/rest-apis#query-params)[NococDB](https://nocodb.com/docs/product-docs/developer-resources/rest-apis#query-params).
{% endhint %}

Введите данный фильтр в поле `where`.

<figure><img src="https://1945201336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FadGXspCXfuLDmMvBstfI%2Fuploads%2FKXt88DwY1cci2couA8TF%2Fimage.png?alt=media&amp;token=855a35d7-3edc-42c2-a2d5-93f05c9c692e" alt=""><figcaption></figcaption></figure>

Нажмите **Execute**.

<figure><img src="https://1945201336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FadGXspCXfuLDmMvBstfI%2Fuploads%2FNramZxa43MVfYtAXyAFR%2Fimage.png?alt=media&amp;token=20ee9af4-5297-4127-bfb7-5e18ab4ad66e" alt=""><figcaption></figcaption></figure>

В ответе вы получите список записей, соответствующих фильтру.

В нашем примере это будут **все пользователи женского пола из города Москва**.

Ответ возвращается в формате **JSON**.

<figure><img src="https://1945201336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FadGXspCXfuLDmMvBstfI%2Fuploads%2FQpScschLjwFugcXPnAxJ%2Fimage.png?alt=media&amp;token=d8df9350-ecf3-48f6-ab91-762ee5bb7510" alt=""><figcaption></figcaption></figure>

### Использование фильтра в Smartbot

Данный фильтр можно использовать в запросе из Smartbot.

Для этого достаточно записать выражение фильтра в переменную `%where%`.

<figure><img src="https://1945201336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FadGXspCXfuLDmMvBstfI%2Fuploads%2FsyUQyt8Gmci9hZDBCYxa%2Fimage.png?alt=media&amp;token=390426fc-ca5f-4ccf-98a6-b16e3b192306" alt=""><figcaption></figcaption></figure>

Например:

```
%where% = "(Gender,eq,Female)~and(City,eq,Москва)"
```

После этого фильтр автоматически добавится в URL запроса, который формируется в блоке "**SmartQuery"**.

{% hint style="info" %}
О том, как формировать GET-запросы к NocoDB, читайте в статье ["**Просмотр данных (GET)"**](https://docs.ncteam.io/nocodb/prosmotr-dannykh-get)
{% endhint %}
