---
title: FilterCondition
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/recommendationfiltercondition
---

# FilterCondition

A single filter condition used in a recommendation query request to narrow results.

## Declaration

```data
object RecommendationFilterCondition
```

## Properties

field: The name of the field to filter on. Must match a field name on the recommendation object being queried, for example state, promotedObjectId, campaignId. operator: The comparison operator to apply. See FilterOperator. value: An array of one or more filter values. Always supplied as an array, even when filtering with a single value, for example value: [AVAILABLE]. ignoreCase: When true, string matching is case-insensitive. Defaults to false.

## Discussion

Discussion The FilterCondition object is the building block of query filters in the Recommendations API. The API combines multiple conditions in the filters array with AND logic. All conditions must match for a recommendation to appear in results. Every query request requires two filters:  |  |   |  |   |  |  Which operators are valid for a given field depends on that field’s underlying type.  |   |   |   |   |   |  Always pass value as an array. Example {   "field": "state",   "operator": "EQUALS",   "value": [     "AVAILABLE"   ],   "ignoreCase": false }

## See Also

- [RecommendationQueryRequest](apple-ads-platform-api/recommendationqueryrequest.md)
- [QueryRequestPagination](apple-ads-platform-api/recommendationqueryrequestpagination.md)
- [Sorting](apple-ads-platform-api/recommendationsorting.md)
- [SortingOrder](apple-ads-platform-api/recommendationsortingorder.md)
- [FilterOperator](apple-ads-platform-api/recommendationfilteroperator.md)
- [RecommendationState](apple-ads-platform-api/recommendationstate.md)
- [RecommendationStatus](apple-ads-platform-api/recommendationstatus.md)
- [RecommendationCategory](apple-ads-platform-api/recommendationcategory.md)