--- title: "Changes to Filter contacts (v2)" method: POST path: "/v2/contacts/filter" --- # Changes to Filter contacts (v2) `POST /v2/contacts/filter` > Every recorded change to this operation, newest first. ## Timeline Changed in 20 of 59 revisions. - **2026-10-22** `657247ddcf7c`: 1 info - **2026-10-22** `62f85fb89e0e`: 7 info - **2026-10-21** `453bed03b3f2`: 4 info - **2026-10-20** `ea4a4df0f33e`: 2 info - **2026-10-16** `293eb41037ab`: 2 info - **2026-10-16** `d049b915e144`: 1 info - **2026-10-15** `51c9adf0f104`: 10 info - **2026-10-13** `4ad34c189dc7`: 1 info - **2026-10-08** `442b12828a68`: 1 breaking, 1 warning, 2 info - **2026-09-30** `1ac3488be176`: 2 info - **2026-09-29** `f951abd9b724`: 8 info - **2026-09-26** `2d33d8c8eae1`: 2 breaking, 97 info - **2026-09-18** `7e2de6306b09`: 1 info - **2026-09-17** `260f2afecc55`: 1 info - **2026-09-07** `01acf4e70493`: 3 info - **2026-09-02** `98e8d517493f`: 3 info - **2026-08-27** `a2f71a243839`: 1 info - **2026-08-19** `553c90fb8959`: 5 info - **2026-08-05** `6f01cd52ac12`: 1 info - **2026-07-26** `07a79f0ff879`: 4 info ## Changes - **2026-10-22** `657247ddcf7c`: 1 info - added the optional property `data/asOf` to the response with the `200` status - **2026-10-22** `62f85fb89e0e`: 7 info - added the new optional request property `include/contacts_custom_fields_contacts` - added the new optional request property `select/contacts_custom_fields_contacts` - added the new `contacts_custom_fields_contacts` enum value to the request property `include/propertyNames/` - added the new `contacts_custom_fields_contacts` enum value to the request property `select/propertyNames/` - request property `where/_or/items/custom_fields/items/value` list-of-types was widened by adding types `boolean and number` to media type `application/json` - request property `where/custom_fields/items/value` list-of-types was widened by adding types `boolean and number` to media type `application/json` - added the optional property `data/contacts/items/contacts_custom_fields_contacts` to the response with the `200` status - **2026-10-21** `453bed03b3f2`: 4 info - added the new optional request property `select/user_edited_fields` - added the new `user_edited_fields` enum value to the request property `select/propertyNames/` - added the optional property `data/contacts/items/team_last_interaction_at` to the response with the `200` status - added the optional property `data/contacts/items/user_edited_fields` to the response with the `200` status - **2026-10-20** `ea4a4df0f33e`: 2 info - added the new optional request property `where/_or/items/has_team_last_interaction` - added the new optional request property `where/has_team_last_interaction` - **2026-10-16** `293eb41037ab`: 2 info - added the new optional request property `where/_or/items/known_by` - added the new optional request property `where/known_by` - **2026-10-16** `d049b915e144`: 1 info - added the optional property `data/nearUnresolved` to the response with the `200` status - **2026-10-15** `51c9adf0f104`: 10 info - added the new optional request property `where/_or/items/has_my_frequency` - added the new optional request property `where/_or/items/has_my_next_due` - added the new optional request property `where/_or/items/has_team_next_due` - added the new optional request property `where/_or/items/is_my_overdue` - added the new optional request property `where/_or/items/is_team_overdue` - added the new optional request property `where/has_my_frequency` - added the new optional request property `where/has_my_next_due` - added the new optional request property `where/has_team_next_due` - added the new optional request property `where/is_my_overdue` - added the new optional request property `where/is_team_overdue` - **2026-10-13** `4ad34c189dc7`: 1 info - added the optional property `data/contacts/items/team_keep_in_touch` to the response with the `200` status - **2026-10-08** `442b12828a68`: 1 breaking, 1 warning, 2 info - the `cursor` request property's minLength was increased from `0` to `1` - the `cursor` request property's maxLength was set to `2048` - removed the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` from the request property `cursor` - the `cursor` request property format was generalized from `uuid` to no format - **2026-09-30** `1ac3488be176`: 2 info - added the new optional request property `where/_or/items/has_groups_only` - added the new optional request property `where/has_groups_only` - **2026-09-29** `f951abd9b724`: 8 info - added the new optional request property `where/_or/items/has_facebook` - added the new optional request property `where/_or/items/has_telegram` - added the new optional request property `where/_or/items/has_tiktok` - added the new optional request property `where/_or/items/has_youtube` - added the new optional request property `where/has_facebook` - added the new optional request property `where/has_telegram` - added the new optional request property `where/has_tiktok` - added the new optional request property `where/has_youtube` - **2026-09-26** `2d33d8c8eae1`: 2 breaking, 97 info - added 'propertyNames' constraint to the request property `include` - added 'propertyNames' constraint to the request property `select` - added the new optional request property `include/contact_birthdays` - added the new optional request property `include/contact_emails` - added the new optional request property `include/contact_locations` - added the new optional request property `include/contact_phone_numbers` - added the new optional request property `include/contact_relations_contact_relations_destinationTocontacts` - added the new optional request property `include/contact_relations_contact_relations_sourceTocontacts` - added the new optional request property `include/contacts_custom_fields` - added the new optional request property `include/feed_items` - added the new optional request property `include/groups_contacts` - added the new optional request property `include/keep_in_touch_reminders` - added the new optional request property `include/legacy_contact_addresses` - added the new optional request property `include/reminders_contacts` - added the new optional request property `include/tags_contacts` - added the new optional request property `include/timeline_items_contacts` - added the new optional request property `select/birthday` - added the new optional request property `select/birthday_year` - added the new optional request property `select/business_card_url` - added the new optional request property `select/company` - added the new optional request property `select/contact_birthdays` - added the new optional request property `select/contact_emails` - added the new optional request property `select/contact_locations` - added the new optional request property `select/contact_phone_numbers` - added the new optional request property `select/contact_relations_contact_relations_destinationTocontacts` - added the new optional request property `select/contact_relations_contact_relations_sourceTocontacts` - added the new optional request property `select/contacts_custom_fields` - added the new optional request property `select/created_at` - added the new optional request property `select/description` - added the new optional request property `select/education` - added the new optional request property `select/facebook` - added the new optional request property `select/feed_items` - added the new optional request property `select/first_interaction_at` - added the new optional request property `select/first_met_at` - added the new optional request property `select/first_name` - added the new optional request property `select/frequency` - added the new optional request property `select/frequency_interval` - added the new optional request property `select/frequency_text` - added the new optional request property `select/full_name` - added the new optional request property `select/gcal_last_interaction_at` - …59 more - **2026-09-18** `7e2de6306b09`: 1 info - added the optional property `data/contacts/items/workspace_id` to the response with the `200` status - **2026-09-17** `260f2afecc55`: 1 info - added the optional property `data/contacts/items/linkedin_headline` to the response with the `200` status - **2026-09-07** `01acf4e70493`: 3 info - added the new optional request property `include/last_note` - added the new optional request property `select/last_note` - added the optional property `data/contacts/items/last_note` to the response with the `200` status - **2026-09-02** `98e8d517493f`: 3 info - added the new optional request property `include/web_search_summary` - added the new optional request property `select/web_search_summary` - added the optional property `data/contacts/items/linkedin_urn` to the response with the `200` status - **2026-08-27** `a2f71a243839`: 1 info - api operation id `filterContactsV2` was added - **2026-08-19** `553c90fb8959`: 5 info - added the new optional request property `where/_or/items/has_grouping_signal` - added the new optional request property `where/_or/items/has_user_created_groups` - added the new optional request property `where/has_grouping_signal` - added the new optional request property `where/has_user_created_groups` - added the optional property `data/contacts/items/first_interaction_at` to the response with the `200` status - **2026-08-05** `6f01cd52ac12`: 1 info - added the optional property `data/contacts/items/first_met_at` to the response with the `200` status - **2026-07-26** `07a79f0ff879`: 4 info - added the new optional request property `near` - added the new optional request property `radiusKm` - added the new optional request property `where/_or/items/has_distance/label` - added the new optional request property `where/has_distance/label` --- [Operation](https://skmtc.dev/getdex/apis/dex-public-api/docs/v2/contacts/filter/post.md) · [API](https://skmtc.dev/getdex/apis/dex-public-api.md) · [Page](https://skmtc.dev/getdex/apis/dex-public-api/changes/v2/contacts/filter/post)