@loopback/docs
Version:
Documentation files rendered at [https://loopback.io](https://loopback.io)
185 lines (84 loc) • 2.68 kB
Markdown
---
lang: en
title: 'API docs: filter.filter'
keywords: LoopBack 4.0, LoopBack 4, Node.js, TypeScript, OpenAPI
sidebar: lb4_sidebar
editurl: https://github.com/loopbackio/loopback-next/tree/master/packages/filter
permalink: /doc/en/lb4/apidocs.filter.filter.html
---
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
[Home](./index.md) > [@loopback/filter](./filter.md) > [Filter](./filter.filter.md)
## Filter interface
Query filter object
**Signature:**
```typescript
export interface Filter<MT extends object = AnyObject>
```
## Properties
<table><thead><tr><th>
Property
</th><th>
Modifiers
</th><th>
Type
</th><th>
Description
</th></tr></thead>
<tbody><tr><td markdown="1">
[fields?](./filter.filter.fields.md)
</td><td markdown="1">
</td><td markdown="1">
[Fields](./filter.fields.md)<!-- --><MT>
</td><td markdown="1">
_(Optional)_ To include/exclude fields
</td></tr>
<tr><td markdown="1">
[include?](./filter.filter.include.md)
</td><td markdown="1">
</td><td markdown="1">
[InclusionFilter](./filter.inclusionfilter.md)<!-- -->\[\]
</td><td markdown="1">
_(Optional)_ To include related objects
</td></tr>
<tr><td markdown="1">
[limit?](./filter.filter.limit.md)
</td><td markdown="1">
</td><td markdown="1">
number
</td><td markdown="1">
_(Optional)_ Maximum number of entities
</td></tr>
<tr><td markdown="1">
[offset?](./filter.filter.offset.md)
</td><td markdown="1">
</td><td markdown="1">
number
</td><td markdown="1">
_(Optional)_ Offset N number of entities. An alias for `skip`
</td></tr>
<tr><td markdown="1">
[order?](./filter.filter.order.md)
</td><td markdown="1">
</td><td markdown="1">
string\[\]
</td><td markdown="1">
_(Optional)_ Sorting order for matched entities. Each item should be formatted as `fieldName ASC` or `fieldName DESC`<!-- -->. For example: `['f1 ASC', 'f2 DESC', 'f3 ASC']`<!-- -->.
We might want to use `Order` in the future. Keep it as `string[]` for now for compatibility with LoopBack 3.x.
</td></tr>
<tr><td markdown="1">
[skip?](./filter.filter.skip.md)
</td><td markdown="1">
</td><td markdown="1">
number
</td><td markdown="1">
_(Optional)_ Skip N number of entities
</td></tr>
<tr><td markdown="1">
[where?](./filter.filter.where.md)
</td><td markdown="1">
</td><td markdown="1">
[Where](./filter.where.md)<!-- --><MT>
</td><td markdown="1">
_(Optional)_ The matching criteria
</td></tr>
</tbody></table>