Metadata Filtering

Several API endpoints support filtering by metadata using query parameters with bracket notation.

Query Format

Filter resources by metadata using bracket notation in query parameters:

Operator	Description	Example
`eq`	Exact match (default when no operator specified)	`metadata[location][eq]=NYC`
`not_eq`	Not equal (excludes matching resources)	`metadata[status][not_eq]=inactive`
`in`	Value is one of comma-delimited values	`metadata[department][in]=sales,marketing`
`contains`	Array metadata value contains the given value	`metadata[tags][contains]=priority`
`gte`	Greater than or equal (numeric comparison)	`metadata[age][gte]=30`
`lte`	Less than or equal (numeric comparison)	`metadata[score][lte]=100`

Filter by exact match:

GET /v1/providers?metadata[location]=NYC

Filter by numeric range:

GET /v1/providers?metadata[age][gte]=30&metadata[age][lte]=50

Filter by multiple values:

GET /v1/providers?metadata[department][in]=sales,marketing,support

Exclude specific values:

GET /v1/providers?metadata[status][not_eq]=inactive

Filter array metadata:

GET /v1/providers?metadata[skills][contains]=javascript