{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Querying and Filtering Records","projectTitle":"Frontline Documentation","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"querying-and-filtering-records","__idx":0},"children":["Querying and Filtering Records"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Frontline provides a powerful JSON-based Query DSL to filter, search, and sort records (both CRM Objects and custom Tables). You can use this syntax in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["query"]}," field of the request bodies of list and export endpoints."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"structure-of-a-query","__idx":1},"children":["Structure of a Query"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A query is represented as a JSON object. It can be a single condition or a nested logical group that joins multiple conditions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"single-condition","__idx":2},"children":["Single Condition"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A single condition performs a comparison on a specific field path:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"path\": \"[Status]\",\n    \"operator\": \"equals\",\n    \"value\": \"Active\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["path"]}]},": The path to the field formatted in bracket notation: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"[Field Name]\""]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operator"]}]},": The comparison operator (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["equals"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contains"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gte"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}]},": The comparison value. Certain operators (like ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNull"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNotNull"]},") do not require a value."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"logical-group","__idx":3},"children":["Logical Group"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can combine multiple conditions using logical operators:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"operator\": \"and\",\n    \"conditions\": [\n        { \"path\": \"[Age]\", \"operator\": \"gte\", \"value\": 18 },\n        { \"path\": \"[Status]\", \"operator\": \"equals\", \"value\": \"Active\" }\n    ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operator"]}]},": Either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"and\""]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"or\""]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conditions"]}]},": An array of condition objects or nested logical groups."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"operators-by-field-type","__idx":4},"children":["Operators by Field Type"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each field type supports a specific set of operators."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"string-fields","__idx":5},"children":["String Fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operator"},"children":["Operator"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value Type"},"children":["Value Type"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["equals"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Exact match"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"string\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ne"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not equal"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"string\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contains"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Substring match"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"string\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["startsWith"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Starts with"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"string\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["endsWith"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ends with"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"string\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNull"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field is empty"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["None"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNotNull"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field has value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["None"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"number-fields","__idx":6},"children":["Number Fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operator"},"children":["Operator"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value Type"},"children":["Value Type"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["equals"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Equal to"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ne"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not equal"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Less than"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lte"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Less than or equal"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Greater than"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gte"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Greater than or equal"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNull"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNotNull"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Null checks"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["None"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"date--dateonly-fields","__idx":7},"children":["Date / DateOnly Fields"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["[!NOTE]"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date"]}]}," fields, values must be ISO-8601 Date-Time strings (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"2026-04-17T00:00:00Z\""]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dateOnly"]}]}," fields, values must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD"]}," Date strings (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"2026-04-17\""]},")."]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operator"},"children":["Operator"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value Type (Date)"},"children":["Value Type (Date)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value Type (DateOnly)"},"children":["Value Type (DateOnly)"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["equals"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Exact date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"2026-04-17T00:00:00Z\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"2026-04-17\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["before"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Before date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"2026-04-17T00:00:00Z\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"2026-04-17\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["after"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["After date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"2026-04-17T00:00:00Z\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"2026-04-17\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onOrBefore"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["On or before"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"2026-04-17T00:00:00Z\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"2026-04-17\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onOrAfter"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["On or after"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"2026-04-17T00:00:00Z\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"2026-04-17\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["between"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Date range"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ from: \"2026-01-01T00:00:00Z\", to: \"2026-12-31T23:59:59Z\" }"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ from: \"2026-01-01\", to: \"2026-12-31\" }"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNull"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNotNull"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Null checks"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["None"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["None"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tags-selectmulti-select-fields","__idx":8},"children":["Tags (Select/Multi-select) Fields"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["[!NOTE]"," ","Tag values must be numeric ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tag IDs"]},", not names. Use the field metadata (retrieved via the fields API) to list option IDs."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operator"},"children":["Operator"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value Type"},"children":["Value Type"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["containsAny"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Has any of these tags"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[1, 2]"]}," (tag IDs)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["containsAll"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Has all of these tags"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[3, 5]"]}," (tag IDs)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notIn"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Does not have any of"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[4]"]}," (tag IDs)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNull"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNotNull"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Null checks"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["None"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"relation-fields","__idx":9},"children":["Relation Fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operator"},"children":["Operator"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value Type"},"children":["Value Type"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["containsAny"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Linked to any of"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[\"id1\", \"id2\"]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notIn"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not linked to any of"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[\"id1\"]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNull"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No linked records"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["None"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNotNull"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Has linked records"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["None"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"boolean-fields","__idx":10},"children":["Boolean Fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operator"},"children":["Operator"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value Type"},"children":["Value Type"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isTrue"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Value is true"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["None"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isFalse"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Value is false"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["None"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNull"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isNotNull"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Null checks"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["None"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"formula-fields","__idx":11},"children":["Formula Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Formula fields evaluate to one of the primitive types (number, string, boolean, date, tags) and support all of their respective operators. In addition, they support calculation status operators:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operator"},"children":["Operator"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value Type"},"children":["Value Type"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isValid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Formula was evaluated successfully"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["None"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isInvalid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Formula evaluation failed with an error"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["None"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"advanced-query-examples","__idx":12},"children":["Advanced Query Examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-complex-nested-logic-and--or","__idx":13},"children":["1. Complex Nested Logic (AND + OR)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To query records matching ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(Status is Open AND Amount >= 10,000) OR (Priority is High)"]},", combine logical groups recursively:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"operator\": \"or\",\n    \"conditions\": [\n        {\n            \"operator\": \"and\",\n            \"conditions\": [\n                { \"path\": \"[Status]\", \"operator\": \"containsAny\", \"value\": [1] },\n                { \"path\": \"[Amount]\", \"operator\": \"gte\", \"value\": 10000 }\n            ]\n        },\n        {\n            \"path\": \"[Priority]\",\n            \"operator\": \"containsAny\",\n            \"value\": [5]\n        }\n    ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-date-range-queries","__idx":14},"children":["2. Date Range Queries"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To query records created during the year 2026, use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["between"]}," operator with an object specifying ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to"]}," date strings:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"path\": \"[Created At]\",\n    \"operator\": \"between\",\n    \"value\": {\n        \"from\": \"2026-01-01T00:00:00Z\",\n        \"to\": \"2026-12-31T23:59:59Z\"\n    }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-tag-filtering-select--multi-select","__idx":15},"children":["3. Tag Filtering (Select / Multi-select)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To find rows tagged with both Tag ID ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3"]}," (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Premium\""]},") and Tag ID ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["5"]}," (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"High Value\""]},"):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"path\": \"[Customer Category]\",\n    \"operator\": \"containsAll\",\n    \"value\": [3, 5]\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Querying and Filtering Records","id":"querying-and-filtering-records","depth":1},{"value":"Structure of a Query","id":"structure-of-a-query","depth":2},{"value":"Single Condition","id":"single-condition","depth":3},{"value":"Logical Group","id":"logical-group","depth":3},{"value":"Operators by Field Type","id":"operators-by-field-type","depth":2},{"value":"String Fields","id":"string-fields","depth":3},{"value":"Number Fields","id":"number-fields","depth":3},{"value":"Date / DateOnly Fields","id":"date--dateonly-fields","depth":3},{"value":"Tags (Select/Multi-select) Fields","id":"tags-selectmulti-select-fields","depth":3},{"value":"Relation Fields","id":"relation-fields","depth":3},{"value":"Boolean Fields","id":"boolean-fields","depth":3},{"value":"Formula Fields","id":"formula-fields","depth":3},{"value":"Advanced Query Examples","id":"advanced-query-examples","depth":2},{"value":"1. Complex Nested Logic (AND + OR)","id":"1-complex-nested-logic-and--or","depth":3},{"value":"2. Date Range Queries","id":"2-date-range-queries","depth":3},{"value":"3. Tag Filtering (Select / Multi-select)","id":"3-tag-filtering-select--multi-select","depth":3}],"frontmatter":{"seo":{"title":"Querying and Filtering Records"}},"lastModified":"2026-06-30T16:41:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/concepts/querying","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}