people

Get People Watchlists By Owner

get/watchlists/people

Query parameters

person_urnsstring[]

Only show those watchlists that contains person urns

return_people_urnsboolean

Return person urns in the response

return_people_countboolean

Return person count in the response

watchlist_typesPeopleWatchlistType[]

Filter watchlists by specific types. If empty, fetches all owner-accessible watchlists.

Response

Successful Response

namestring required

shared_with_teamboolean required

entity_urnstring required

creatorstring nullable

peoplestring[] nullable

people_countinteger nullable

idstring uuid required

user_watchlist_type'USER_MANAGED_WATCHLIST' | 'CUSTOMER_MANAGED_WATCHLIST' | 'USER_CONNECTIONS' | 'TEAM_CONNECTIONS' | 'GLOBAL_FIELD_LIST' required

named_views_orderstring[]

updated_atstring date-time required

created_atstring date-time required

Changes

Changed in 4 of the 11 revisions of this API.168

Aug 19, 2026fbef1ba78f964See the full diff
- ○
  removed EmailListCustomFieldValue from the items/custom_fields/items/default_value response property anyOf list for the response status 200
  response-property-any-of-removed
- ○
  removed OwnerListCustomFieldMetadata from the items/custom_fields/items/metadata response property anyOf list for the response status 200
  response-property-any-of-removed
- ○
  removed the EMAIL enum value from the items/custom_fields/items/type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the OWNER enum value from the items/custom_fields/items/type response property for the response status 200
  response-property-enum-value-removed
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 19, 20262100d53a667622See the full diff
- ●
  added the new EMAIL enum value to the items/custom_fields/items/type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new OWNER enum value to the items/custom_fields/items/type response property for the response status 200
  response-property-enum-value-added
- ○
  added EmailListCustomFieldValue to the items/custom_fields/items/default_value response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added OwnerListCustomFieldMetadata to the items/custom_fields/items/metadata response property anyOf list for the response status 200
  response-property-any-of-added
Aug 14, 20260edae4154f8f2See the full diff
- ●
  added the new search_v2_investor_lists enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/controlled_filter_group/anyOf[subschema #1: FilterGroup]/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new search_v2_investor_lists enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/filter_group/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
Jul 26, 2026fcf35c98e097122See the full diff
- ●
  added the new search_v2_company_headcount_department_percent_growth_range enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/controlled_filter_group/anyOf[subschema #1: FilterGroup]/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new search_v2_company_headcount_department_percent_growth_range enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/filter_group/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new search_v2_company_socials_growth_range enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/controlled_filter_group/anyOf[subschema #1: FilterGroup]/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new search_v2_company_socials_growth_range enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/filter_group/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new search_v2_company_team_notable_followers enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/controlled_filter_group/anyOf[subschema #1: FilterGroup]/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new search_v2_company_team_notable_followers enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/filter_group/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new search_v2_company_team_notable_followers_count enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/controlled_filter_group/anyOf[subschema #1: FilterGroup]/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new search_v2_company_team_notable_followers_count enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/filter_group/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new search_v2_person_notable_followers enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/controlled_filter_group/anyOf[subschema #1: FilterGroup]/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new search_v2_person_notable_followers enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/filter_group/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new search_v2_person_notable_followers_count enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/controlled_filter_group/anyOf[subschema #1: FilterGroup]/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new search_v2_person_notable_followers_count enum value to the items/named_views/items/search_query/anyOf[subschema #1: ApiSearchQuery]/filter_group/filter_group_generators/anyOf[subschema #1]/items/generator_id response property for the response status 200
  response-property-enum-value-added
- ○
  added the optional property detail/items/ctx to the response with the 422 status
  response-optional-property-added
- ○
  added the optional property detail/items/input to the response with the 422 status
  response-optional-property-added
This revision also has 24 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history