<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/RecommendationFilterCondition",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:RecommendationFilterCondition"
  },
  "title" : "FilterCondition"
}
-->

# FilterCondition

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

```
object RecommendationFilterCondition
```

## 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:

|Field               |Operator|Description                                                                         |
|--------------------|--------|------------------------------------------------------------------------------------|
|`promotedObjectId`  |`EQUALS`|The ID of the promoted object. Interpreted in combination with `promotedObjectType`.|
|`promotedObjectType`|`EQUALS`|The type of promoted object, for example `APPSTORE_APP`.                            |

Which operators are valid for a given `field` depends on that field’s underlying type.

|Field Type|Supported Operators                                                                                                      |
|----------|-------------------------------------------------------------------------------------------------------------------------|
|String    |`EQUALS`, `NOT_EQUALS`, `IN`, `STARTS_WITH`, `ENDS_WITH`, `LIKE`                                                         |
|Numeric   |`EQUALS`, `NOT_EQUALS`, `IN`, `GREATER_THAN`, `GREATER_THAN_OR_EQUAL_TO`, `LESS_THAN`, `LESS_THAN_OR_EQUAL_TO`, `BETWEEN`|
|Date      |`EQUALS`, `NOT_EQUALS`, `GREATER_THAN`, `GREATER_THAN_OR_EQUAL_TO`, `LESS_THAN`, `LESS_THAN_OR_EQUAL_TO`                 |
|Enum      |`EQUALS`, `NOT_EQUALS`, `IN`                                                                                             |
|List      |`CONTAINS_ANY`, `CONTAINS_ALL`                                                                                           |

Always pass `value` as an array.

### Example

```json
{
  "field": "state",
  "operator": "EQUALS",
  "value": [
    "AVAILABLE"
  ],
  "ignoreCase": false
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)