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

# Filtering

Filtering is a powerful way to reduce the amount of data returned by an API call.
The endpoints will document the available filtering options.

## Basic Filtering

Simple key-value query parameters for common use cases.

### Example

```
GET /plugs?phase=AC
GET /orders?min_price=200
```

### Characteristics

* Easy to use and efficient.
* Parameter names may represent logical filters, not necessarily direct object fields.
* Best suited for equality or numeric comparisons (`=, <, >`).

***

## Advanced filtering

For more expressive queries, advanced filtering is available via the filter\[...] syntax.

### Example

```
GET /users?filter[email]=@chargecloud&filter[status]=active
```

### Rules

* Filter keys must correspond to actual fields on the resource.
* Interpretation of operators (=, LIKE, etc.) is documented per API.
* Designed for flexible matching and multi-field queries.

***

## Combining filters

Both approaches can be used together.

### Example

```
GET /orders?filter[status]=active&min_gross=200
```

This means:

* Status matches active
* AND gross amount is greater than 200