> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devmob.app.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Filtragem

> Query DSL para filtragem nas APIs do DEVMOB

As APIs do DEVMOB utilizam uma query DSL padronizada para filtragem de resultados via query string.

## Text Search

Busca textual genérica em múltiplos campos. Os campos pesquisáveis estão documentados em cada endpoint.

```
GET /orders?filter=João Silva
```

## List

Valores separados por vírgula para filtrar por múltiplos itens. Valores duplicados são removidos automaticamente.

```
GET /trips?status=SCHEDULED,IN_PROGRESS
GET /payments?method=PIX,CREDIT_CARD
```

## Date Range

Filtragem por intervalo de datas usando operadores separados por ponto e vírgula. Suporta formato ISO 8601.

### Operadores

| Operador | Descrição      |
| -------- | -------------- |
| `=`      | Igual          |
| `>`      | Maior que      |
| `>=`     | Maior ou igual |
| `<`      | Menor que      |
| `<=`     | Menor ou igual |

### Exemplos

```
GET /orders?createdAt=>=2026-01-01;<=2026-12-31
GET /trips?departureAt=>=2026-04-10T08:00:00Z
```

## Number Range

Filtragem por intervalo numérico. Mesma sintaxe de operadores do date range.

```
GET /payments?amount=>=1000;<=50000
GET /receivables?amount=>=500
```

## Boolean

Parâmetros booleanos aceitam `true` ou `false` como string e são convertidos automaticamente.

```
GET /drivers?active=true
```