{"templateId":"../@theme/Templates/BlogWithAuthors","sharedDataIds":{"sidebar":"sidebar-blog/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"What you will learn","description":"Developer documentation for the Caraer platform. REST API reference, Bearer authentication, tutorials, and guides for records, forms, webpages, webhooks, and automations.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide explains how to fetch records from Caraer and how to build filter"," ","payloads that behave exactly as expected."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It is written for external developers integrating with the Records API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-will-learn","__idx":0},"children":["What you will learn"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which endpoint to use for record fetching"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["What ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mainObject"]}," should be"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How filter payloads are structured"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["show"]}," works (including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort"]}," works"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AND"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OR"]}," logic works in filter groups"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How to filter on related records"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How to combine filters with search, sorting, and pagination"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"primary-endpoint-for-fetching-records","__idx":1},"children":["Primary endpoint for fetching records"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v2/records/index"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With optional query params:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parse=true|false"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["archived=true|false"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["relatedRecordUuid=RECORD_UUID"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Basic example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://your-company.caraer.com/api/v2/records/index?parse=true\" \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"page\": 1,\n    \"limit\": 25,\n    \"mainObject\": \"candidate\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"mainobject--what-to-use-and-why-it-matters","__idx":2},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mainObject"]},": what to use and why it matters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mainObject"]}," is required context for record fetching."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["object name"]}," of the record type you want to list, for example:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["candidate"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vacancy"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contact"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mainObject\": \"candidate\",\n  \"page\": 1,\n  \"limit\": 25\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Why it matters:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["It defines which node type is the base of the query."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["It controls how ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filter"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["show"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort"]}," are resolved."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["It is also used for permission checks on property access."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mainObject"]}," does not match a valid object name in your environment, request"," ","building and/or query execution will fail."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"filter-payload-structure","__idx":3},"children":["Filter payload structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Filtering is sent inside the request body as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filter"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["High-level shape:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"page\": 1,\n  \"limit\": 25,\n  \"mainObject\": \"candidate\",\n  \"query\": null,\n  \"filter\": {\n    \"groups\": [\n      {\n        \"items\": [\n          {\n            \"object\": null,\n            \"relation\": null,\n            \"property\": \"status_candidate\",\n            \"operator\": \"equals_exactly\",\n            \"value\": \"new\"\n          }\n        ]\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"meaning-of-each-filter-item-field","__idx":4},"children":["Meaning of each filter item field"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object"]},": object context used by the filter item"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["relation"]},": relation name if the filter traverses a relation (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]}," is allowed for any relation in relation-existence checks)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["property"]},": property name to filter on; if omitted, item becomes a relation existence check"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operator"]},": filter operator name"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]},": value used by the operator"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["relationIncluded"]}," (optional, default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"): for relation existence checks (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["property=null"]},"), controls include/exclude relation matches"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-object--relation-are-interpreted-in-filters","__idx":5},"children":["How ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["relation"]}," are interpreted in filters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Important behavior:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you are filtering properties on the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mainObject"]},", you usually leave"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object"]}," as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object"]}," to the same value as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mainObject"]},", the filter is treated"," ","as filtering through a related node of that same object (self-related records),"," ","not as a plain main-object property shortcut."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object"]}," is set and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["relation"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},", filtering targets related records"," ","of that object type regardless of relation name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object"]}," is set and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["relation"]}," is also set, filtering targets related"," ","records through that specific relation only."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Practical recommendation: for normal ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mainObject"]}," property filtering, keep"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["relation"]}," as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," in filter items."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"show-items--show--and-how--works","__idx":6},"children":["Show items (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["show"]},") and how ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]}," works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["show"]}," controls which fields are returned for each record."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Basic shape:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"show\": [\n    { \"object\": \"candidate\", \"relation\": null, \"property\": \"firstname\" },\n    { \"object\": \"candidate\", \"relation\": null, \"property\": \"email\" }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"using--in-show","__idx":7},"children":["Using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["show"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can request all readable properties of the main object with:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"show\": [{ \"object\": \"candidate\", \"relation\": null, \"property\": \"*\" }]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Important behavior:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]}," expansion is applied for the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["main object wildcard pattern"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Backend resolves it to all readable properties for that main object."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access rules still apply: only properties the caller can read are returned."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you need a stable API response contract, explicitly list the properties"," ","instead of relying on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sort-items--sort-","__idx":8},"children":["Sort items (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort"]}," controls ordering of result rows."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Basic shape:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"sort\": [\n    {\n      \"object\": \"candidate\",\n      \"relation\": null,\n      \"property\": \"updatedAt\",\n      \"direction\": \"DESC\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Rules:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["direction"]}," supports ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ASC"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DESC"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can provide multiple sort items to create secondary/tertiary ordering."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use properties that exist and are readable in the requested context."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example with fallback ordering:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"sort\": [\n    {\n      \"object\": \"candidate\",\n      \"relation\": null,\n      \"property\": \"status_candidate\",\n      \"direction\": \"ASC\"\n    },\n    {\n      \"object\": \"candidate\",\n      \"relation\": null,\n      \"property\": \"updatedAt\",\n      \"direction\": \"DESC\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-filter-logic-works--and--or-","__idx":9},"children":["How filter logic works (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AND"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OR"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Filter logic is:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Items ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["inside one group"]}," are combined with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AND"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Groups ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["inside one filter"]}," are combined with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OR"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["So ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groups"]}," let you create ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(A AND B) OR (C AND D)"]}," patterns."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example with two groups:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"filter\": {\n    \"groups\": [\n      {\n        \"items\": [\n          {\n            \"property\": \"status_candidate\",\n            \"operator\": \"equals_exactly\",\n            \"value\": \"new\"\n          },\n          {\n            \"property\": \"source\",\n            \"operator\": \"equals_exactly\",\n            \"value\": \"linkedin\"\n          }\n        ]\n      },\n      {\n        \"items\": [\n          {\n            \"property\": \"status_candidate\",\n            \"operator\": \"equals_exactly\",\n            \"value\": \"in_progress\"\n          },\n          {\n            \"property\": \"source\",\n            \"operator\": \"equals_exactly\",\n            \"value\": \"referral\"\n          }\n        ]\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This means:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["(status=new AND source=linkedin) OR (status=in_progress AND source=referral)"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"all-operators","__idx":10},"children":["All 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":"Typical meaning"},"children":["Typical meaning"]}]}]},{"$$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_exactly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Exact equality"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["equals_flexibly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Case-insensitive equality"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_equals_exactly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Exact inequality"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_equals_flexibly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Case-insensitive inequality"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bigger_than"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Greater than"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smaller_than"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Less than"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bigger_than_or_equal_to"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Greater than or equal"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smaller_than_or_equal_to"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Less than or equal"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contains_exactly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains (case-sensitive)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contains_flexibly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains (case-insensitive)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_contains_exactly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Does not contain (case-sensitive)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_contains_flexibly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Does not contain (case-insensitive)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["starts_with_exactly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Starts with (case-sensitive)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["starts_with_flexibly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Starts with (case-insensitive)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ends_with_exactly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ends with (case-sensitive)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ends_with_flexibly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ends with (case-insensitive)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_null"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Empty / null"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_not_null"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not empty / not null"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["any"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Any of provided values"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["all_flexibly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains all provided values"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["all_exactly"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Matches all provided values exactly"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["distance_between"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Distance-based comparison"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["range"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["In between min/max"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"which-operators-are-usable-per-property-typeformat","__idx":11},"children":["Which operators are usable per property type/format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In default Caraer property configuration, operator availability is primarily"," ","driven by property ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["type"]},", and formats of"," ","that type follow the same list."]},{"$$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":"Property type"},"children":["Property type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Formats"},"children":["Formats"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Supported operators"},"children":["Supported operators"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["multi-line"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["single-line"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_not_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["equals_exactly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_equals_exactly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contains_flexibly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_contains_flexibly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["starts_with_flexibly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ends_with_flexibly"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_not_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["equals_exactly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_equals_exactly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bigger_than"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smaller_than"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bigger_than_or_equal_to"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smaller_than_or_equal_to"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["range"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_not_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["equals_exactly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_equals_exactly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bigger_than"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smaller_than"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bigger_than_or_equal_to"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smaller_than_or_equal_to"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["range"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkbox"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["single-checkbox"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_not_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["equals_exactly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_equals_exactly"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["single-select"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["single-select"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["any"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_not_null"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["multi-select"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["multi-select"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["any"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["all_flexibly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["all_exactly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_not_null"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tag"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tag"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_not_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["equals_exactly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_equals_exactly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["any"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["all_flexibly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["all_exactly"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["range"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number-range"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency-range"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["range"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["structure"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["structure"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contains_flexibly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_not_null"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_null"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_not_null"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["linked-property"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["linked-property"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Based on the property it's linked to"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"relation-only-filtering-note","__idx":12},"children":["Relation-only filtering note"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["property"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},", filter items behave as relation existence checks"," ","(",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["relationIncluded=true/false"]},"). In that case, property-type operator tables do"," ","not apply because the filter is relation-based, not property-value-based."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"relation-filters","__idx":13},"children":["Relation filters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can filter by relation presence even without specifying a property."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Relation existence example (candidate has any relation to vacancy):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"filter\": {\n    \"groups\": [\n      {\n        \"items\": [\n          {\n            \"object\": \"vacancy\",\n            \"relation\": \"*\",\n            \"property\": null,\n            \"relationIncluded\": true\n          }\n        ]\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Relation non-existence example (candidate has no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applied_for"]}," relation to vacancy):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"filter\": {\n    \"groups\": [\n      {\n        \"items\": [\n          {\n            \"object\": \"vacancy\",\n            \"relation\": \"applied_for\",\n            \"property\": null,\n            \"relationIncluded\": false\n          }\n        ]\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"relatedrecorduuid-shortcut-relation-aware-filtering","__idx":14},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["relatedRecordUuid"]}," shortcut (relation-aware filtering)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["relatedRecordUuid"]}," as a query parameter, Caraer can help shape"," ","relation-aware filtering:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If no filter is provided, it defaults to records related to that record"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If filter values contain smarten placeholders, they are resolved against that"," ","related record context"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://your-company.caraer.com/api/v2/records/index?relatedRecordUuid=RELATED_UUID\" \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"page\": 1,\n    \"limit\": 20,\n    \"mainObject\": \"candidate\",\n    \"filter\": { \"groups\": [] }\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"combining-filter--search--sort--pagination","__idx":15},"children":["Combining filter + search + sort + pagination"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can combine all of these in one request:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"page\": 1,\n  \"limit\": 20,\n  \"mainObject\": \"candidate\",\n  \"query\": \"jane\",\n  \"filter\": {\n    \"groups\": [\n      {\n        \"items\": [\n          {\n            \"property\": \"status_candidate\",\n            \"operator\": \"equals_exactly\",\n            \"value\": \"in_progress\"\n          }\n        ]\n      }\n    ]\n  },\n  \"sort\": [\n    {\n      \"object\": \"candidate\",\n      \"relation\": null,\n      \"property\": \"updatedAt\",\n      \"direction\": \"DESC\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"practical-checklist","__idx":16},"children":["Practical checklist"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Always set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mainObject"]}," to the object you are fetching."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mainObject"]}," aligned with the object name used in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["show"]},"/",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort"]}," where possible."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use exact property names from your Caraer schema."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Start with one simple group, then add complexity."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate operator spelling (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["equals_exactly"]},", not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EQUALS"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use explicit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["show"]}," fields for stable integrations; use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]}," mainly for exploration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parse=true"]}," only if you need human-readable values in response."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-reading","__idx":17},"children":["Related reading"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/blog/2026-03-25-save-records"},"children":["Save records"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/blog/2026-03-25-submit-forms-and-embed-on-your-website"},"children":["Submit forms and embed forms on your website"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/get-started"},"children":["API introduction"]}]}]}]},"headings":[{"value":"What you will learn","id":"what-you-will-learn","depth":2},{"value":"Primary endpoint for fetching records","id":"primary-endpoint-for-fetching-records","depth":2},{"value":"mainObject : what to use and why it matters","id":"mainobject--what-to-use-and-why-it-matters","depth":2},{"value":"Filter payload structure","id":"filter-payload-structure","depth":2},{"value":"Meaning of each filter item field","id":"meaning-of-each-filter-item-field","depth":3},{"value":"How object + relation are interpreted in filters","id":"how-object--relation-are-interpreted-in-filters","depth":3},{"value":"Show items ( show ) and how * works","id":"show-items--show--and-how--works","depth":2},{"value":"Using * in show","id":"using--in-show","depth":3},{"value":"Sort items ( sort )","id":"sort-items--sort-","depth":2},{"value":"How filter logic works ( AND / OR )","id":"how-filter-logic-works--and--or-","depth":2},{"value":"All operators","id":"all-operators","depth":3},{"value":"Which operators are usable per property type/format","id":"which-operators-are-usable-per-property-typeformat","depth":3},{"value":"Relation-only filtering note","id":"relation-only-filtering-note","depth":3},{"value":"Relation filters","id":"relation-filters","depth":2},{"value":"relatedRecordUuid shortcut (relation-aware filtering)","id":"relatedrecorduuid-shortcut-relation-aware-filtering","depth":2},{"value":"Combining filter + search + sort + pagination","id":"combining-filter--search--sort--pagination","depth":2},{"value":"Practical checklist","id":"practical-checklist","depth":2},{"value":"Related reading","id":"related-reading","depth":2}],"frontmatter":{"title":"Fetch records and use filters effectively","authors":["sem_tadema"],"tags":["documentation","api"],"template":"../@theme/Templates/BlogWithAuthors","seo":{"title":"What you will learn"}},"lastModified":"2026-03-25T14:42:46.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/blog/2026-03-25-fetch-records-and-filtering-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}