Filtering and search

The list resources endpoint supports advanced filtering and full-text search to narrow down results.

Filtering

Use the filter query parameter to apply conditions on resource fields. Filters are passed as nested query parameters:

GET /v2/resources/posts?filter[field][operator]=value

GET /v2/resources/posts?filter[status]=published

Operator	Description	Example
`eq`	Equals	`filter[title][eq]=Hello`
`ne`	Not equals	`filter[status][ne]=draft`
`gt`	Greater than	`filter[price][gt]=100`
`gte`	Greater than or equal	`filter[price][gte]=100`
`lt`	Less than	`filter[price][lt]=50`
`lte`	Less than or equal	`filter[price][lte]=50`
`in`	In list	`filter[category][in]=news,blog`
`not_in`	Not in list	`filter[category][not_in]=archive`
`contains`	Contains substring	`filter[title][contains]=hello`
`not_contains`	Does not contain	`filter[title][not_contains]=draft`
`starts_with`	Starts with	`filter[slug][starts_with]=post-`
`ends_with`	Ends with	`filter[slug][ends_with]=-2026`
`between`	Between two values	`filter[price][between]=10,100`
`null`	Is null / is not null	`filter[image][null]=true`

Filter by publication status using the published filter:

GET /v2/resources/posts?filter[published]=true
GET /v2/resources/posts?filter[published]=false

The created_at and updated_at fields support the same operators:

GET /v2/resources/posts?filter[created_at][gte]=2026-01-01
GET /v2/resources/posts?filter[updated_at][between]=2026-01-01,2026-02-01

Multiple filters can be combined. All conditions are applied with AND logic:

GET /v2/resources/posts?filter[published]=true&filter[category][eq]=news&filter[created_at][gte]=2026-01-01

Use the search query parameter for full-text search across text and rich text fields:

GET /v2/resources/posts?search=hello+world

The search is case-insensitive and matches partial content. It searches across all text and rich-text fields defined in the blueprint.

Search can be combined with filters:

GET /v2/resources/posts?search=hello&filter[published]=true