---
title: "Get People Watchlists By Owner"
method: GET
path: "/watchlists/people"
tags: ["people"]
---

# Get People Watchlists By Owner

`GET /watchlists/people`

## Query parameters

- `person_urns` string[] — Only show those watchlists that contains person urns
- `return_people_urns` boolean — Return person urns in the response
- `return_people_count` boolean — Return person count in the response
- `watchlist_types` PeopleWatchlistType[] — Filter watchlists by specific types. If empty, fetches all owner-accessible watchlists.

## Response `200`

Successful Response

- PeopleWatchlistOutput[]
  - `name` string, required
  - `shared_with_team` boolean, required
  - `entity_urn` string, required
  - `creator` string, nullable
  - `owner` union, required
    - string
    - string
  - `people` string[], nullable
  - `people_count` integer, nullable
  - `id` string, uuid, required
  - `user_watchlist_type` 'USER_MANAGED_WATCHLIST' | 'CUSTOMER_MANAGED_WATCHLIST' | 'USER_CONNECTIONS' | 'TEAM_CONNECTIONS' | 'GLOBAL_FIELD_LIST', required
  - `custom_fields` PersonListCustomFieldOutput[]
    - `created_at` string, required
    - `updated_at` string, required
    - `urn` union, required
      - string
      - string
      - string
    - `list_urn` string, required
    - `name` string, required
    - `type` 'TEXT' | 'NUMBER' | 'DATE' | 'SINGLE_SELECT' | 'MULTI_SELECT' | 'PERSON' | 'WEBSITE' | 'CHECKBOX' | 'STATUS' | 'RECORD_REFERENCE', required
    - `metadata` union
      - SelectListCustomFieldMetadata
        - `options` SelectListCustomFieldValueOption[]
          - `urn` string
          - `name` string, required
          - `color` string, required
        - `default` string, nullable
      - NumberListCustomFieldMetadata
        - `format` 'NUMBER' | 'PERCENT' | 'US_DOLLAR'
      - DateListCustomFieldMetadata
        - `format` 'MM_DD_YYYY' | 'DD_MM_YYYY' | 'YYYY_MM_DD'
      - PersonListCustomFieldMetadata
        - `mode` 'SINGLE' | 'MULTIPLE', required
      - RecordReferenceListCustomFieldMetadata
        - `record_type_urn` string, required
        - `allow_multiple` boolean, required
        - `mode` string, nullable
    - `default_value` union
      - CheckboxListCustomFieldValue
        - `value` boolean, nullable
      - NumberListCustomFieldValue
        - `value` number, nullable
      - SingleListSelectCustomFieldValue
        - `value` string, nullable
      - TextListCustomFieldValue
        - `value` string, nullable
      - MultiSelectListCustomFieldValue
        - `value` string[]
      - PersonListCustomFieldDefaultValue
        - `value` string[]
        - `mode` 'FIXED_URN' | 'ADDED_BY_USER', required
      - RecordReferenceListCustomFieldValue
        - `value` string[]
      - DateListCustomFieldDefaultValue
        - `value` string, nullable
        - `mode` 'FIXED_DATE' | 'CREATED_AT', required
      - WebsiteListCustomFieldValue
        - `value` string, nullable
      - StatusListCustomFieldValue
        - `value` string, nullable
  - `named_views` PersonListNamedViewOutput[]
    - `id` integer, nullable, required
    - `entity_urn` string, required
    - `name` string, required
    - `list_urn` string, required
    - `visible_columns` union[], required
      - union
        - string
        - string
        - string
        - string
    - `search_query` ApiSearchQueryOutput
      - `filter_group` FilterGroupOutput, required
        - `join_operator` 'and' | 'or', required
        - `filters` Filter[], nullable
          - `field` string, required
          - `field_urn` string, nullable
          - `comparator` string, required
          - `filter_value` unknown
        - `filter_groups` FilterGroupOutput[], nullable
        - `filter_group_generators` FilterGroupGenerator[], nullable
          - `generator_id` 'company_headcount' | 'search_v2_accelerator' | 'search_v2_company_funding_stage' | 'search_v2_company_funding_stage_simple' | 'search_v2_company_funding_total_range' | 'search_v2_company_funding_last_round_total_range' | 'search_v2_company_funding_undisclosed' | 'search_v2_company_currently_raising' | 'search_v2_company_funding_include_investors' | 'search_v2_company_funding_exclude_investors' | 'search_v2_company_funding_last_round_date' | 'search_v2_company_funding_foundation_date' | 'search_v2_company_funding_investors_deal_search' | 'search_v2_company_team_headcount_range' | 'search_v2_company_team_headcount_percent_growth_range' | 'search_v2_company_latest_web_traffic_range' | 'search_v2_company_web_traffic_percent_growth_range' | 'search_v2_company_headcount_department_percent_growth_range' | 'search_v2_company_socials_growth_range' | 'search_v2_company_team_highlights' | 'search_v2_company_sector_include_keywords' | 'search_v2_company_sector_exclude_keywords' | 'search_v2_company_sector_match_keywords' | 'search_v2_company_sector_include_industry_tags' | 'search_v2_company_sector_exclude_industry_tags' | 'search_v2_company_sector_include_business_tags' | 'search_v2_company_sector_exclude_business_tags' | 'search_v2_company_sector_include_technology_tags' | 'search_v2_company_sector_exclude_technology_tags' | 'search_v2_company_sector_preset' | 'search_v2_company_sector_include_tags' | 'search_v2_company_sector_exclude_tags' | 'search_v2_company_sector_product_categories' | 'search_v2_company_team_founding_experience' | 'search_v2_company_team_member_experience' | 'search_v2_company_team_notable_followers' | 'search_v2_company_team_notable_followers_count' | 'search_v2_company_list_and_more_initialized_date' | 'search_v2_company_list_and_more_updated_date' | 'search_v2_company_list_and_more_include_from_watchlist' | 'search_v2_company_list_and_more_exclude_from_watchlist' | 'search_v2_company_list_and_more_accelerators' | 'search_v2_company_list_and_more_location' | 'search_v2_company_list_and_more_continents' | 'search_v2_company_list_and_more_include_from_people_list' | 'search_v2_company_list_and_more_exclude_from_people_list' | 'search_v2_company_is_not_investor' | 'search_people_employees' | 'search_v2_people_education_experience' | 'search_v2_people_general_highlights' | 'search_v2_people_general_location' | 'search_v2_people_general_connections' | 'search_v2_people_general_linkedin_headlines' | 'search_v2_people_general_people_lists' | 'search_v2_people_current_experience' | 'search_v2_people_past_experience' | 'search_v2_people_general_correspondences' | 'search_v2_person_notable_followers' | 'search_v2_person_notable_followers_count' | 'search_v2_company_team_correspondences' | 'search_v2_semantic_search_filter' | 'search_v2_similar_company_search_filter' | 'search_v2_investor_aum_range' | 'search_v2_investor_check_size_range' | 'search_v2_investor_funded_company_location' | 'search_v2_investor_invested_stage' | 'search_v2_investor_latest_investment_date' | 'search_v2_investor_location' | 'search_v2_investor_num_deals_range' | 'search_v2_investor_team_size_range' | 'search_v2_investor_co_investors' | 'search_v2_investor_average_investment_size_range' | 'search_v2_investor_entry_stage_focus' | 'search_v2_investor_country_focus' | 'search_v2_investor_sector_focus' | 'search_v2_investor_funded_company' | 'search_v2_investor_website_keywords' | 'search_v2_investor_funded_company_sector_tags' | 'search_v2_investor_portfolio_details' | 'search_v2_investor_team_correspondences' | 'search_v2_investor_type' | 'search_v2_investor_primary_type' | 'search_v2_investor_secondary_types', required
          - `arguments` object, required
      - `pagination` Pagination, required
        - `start` integer, nullable
        - `page_size` integer, required
      - `sort` SortOutput[]
        - `sort_field` string, required
        - `descending` boolean, required
        - `sort_context_values` SortContextArguments
          - `saved_search_id` integer, nullable
          - `date_added_after` string, nullable
          - `list_urn` union
            - string
            - string
          - `custom_field_urn` union
            - string
            - string
          - `company_id` integer, nullable — When sorting by `person_position_start_date`, scopes the sort to a single company so a person's unrelated active roles (board seats, prior jobs) don't skew their position in per-company employee lists.
      - `controlled_filter_group` FilterGroupOutput
        - `join_operator` 'and' | 'or', required
        - `filters` Filter[], nullable
          - `field` string, required
          - `field_urn` string, nullable
          - `comparator` string, required
          - `filter_value` unknown
        - `filter_groups` FilterGroupOutput[], nullable
        - `filter_group_generators` FilterGroupGenerator[], nullable
          - `generator_id` 'company_headcount' | 'search_v2_accelerator' | 'search_v2_company_funding_stage' | 'search_v2_company_funding_stage_simple' | 'search_v2_company_funding_total_range' | 'search_v2_company_funding_last_round_total_range' | 'search_v2_company_funding_undisclosed' | 'search_v2_company_currently_raising' | 'search_v2_company_funding_include_investors' | 'search_v2_company_funding_exclude_investors' | 'search_v2_company_funding_last_round_date' | 'search_v2_company_funding_foundation_date' | 'search_v2_company_funding_investors_deal_search' | 'search_v2_company_team_headcount_range' | 'search_v2_company_team_headcount_percent_growth_range' | 'search_v2_company_latest_web_traffic_range' | 'search_v2_company_web_traffic_percent_growth_range' | 'search_v2_company_headcount_department_percent_growth_range' | 'search_v2_company_socials_growth_range' | 'search_v2_company_team_highlights' | 'search_v2_company_sector_include_keywords' | 'search_v2_company_sector_exclude_keywords' | 'search_v2_company_sector_match_keywords' | 'search_v2_company_sector_include_industry_tags' | 'search_v2_company_sector_exclude_industry_tags' | 'search_v2_company_sector_include_business_tags' | 'search_v2_company_sector_exclude_business_tags' | 'search_v2_company_sector_include_technology_tags' | 'search_v2_company_sector_exclude_technology_tags' | 'search_v2_company_sector_preset' | 'search_v2_company_sector_include_tags' | 'search_v2_company_sector_exclude_tags' | 'search_v2_company_sector_product_categories' | 'search_v2_company_team_founding_experience' | 'search_v2_company_team_member_experience' | 'search_v2_company_team_notable_followers' | 'search_v2_company_team_notable_followers_count' | 'search_v2_company_list_and_more_initialized_date' | 'search_v2_company_list_and_more_updated_date' | 'search_v2_company_list_and_more_include_from_watchlist' | 'search_v2_company_list_and_more_exclude_from_watchlist' | 'search_v2_company_list_and_more_accelerators' | 'search_v2_company_list_and_more_location' | 'search_v2_company_list_and_more_continents' | 'search_v2_company_list_and_more_include_from_people_list' | 'search_v2_company_list_and_more_exclude_from_people_list' | 'search_v2_company_is_not_investor' | 'search_people_employees' | 'search_v2_people_education_experience' | 'search_v2_people_general_highlights' | 'search_v2_people_general_location' | 'search_v2_people_general_connections' | 'search_v2_people_general_linkedin_headlines' | 'search_v2_people_general_people_lists' | 'search_v2_people_current_experience' | 'search_v2_people_past_experience' | 'search_v2_people_general_correspondences' | 'search_v2_person_notable_followers' | 'search_v2_person_notable_followers_count' | 'search_v2_company_team_correspondences' | 'search_v2_semantic_search_filter' | 'search_v2_similar_company_search_filter' | 'search_v2_investor_aum_range' | 'search_v2_investor_check_size_range' | 'search_v2_investor_funded_company_location' | 'search_v2_investor_invested_stage' | 'search_v2_investor_latest_investment_date' | 'search_v2_investor_location' | 'search_v2_investor_num_deals_range' | 'search_v2_investor_team_size_range' | 'search_v2_investor_co_investors' | 'search_v2_investor_average_investment_size_range' | 'search_v2_investor_entry_stage_focus' | 'search_v2_investor_country_focus' | 'search_v2_investor_sector_focus' | 'search_v2_investor_funded_company' | 'search_v2_investor_website_keywords' | 'search_v2_investor_funded_company_sector_tags' | 'search_v2_investor_portfolio_details' | 'search_v2_investor_team_correspondences' | 'search_v2_investor_type' | 'search_v2_investor_primary_type' | 'search_v2_investor_secondary_types', required
          - `arguments` object, required
      - `merge_query_for_nested_fields` boolean
    - `display_type` 'GRID' | 'BOARD', required
    - `group_by_field` string, nullable
    - `hide_empty_columns` boolean, required
    - `column_view_settings` PersonListNamedViewColumnViewSettings[], nullable
      - `entity_urn` union, required
        - string
        - string
        - string
        - string
      - `column_width` integer, nullable
  - `named_views_order` string[]
  - `updated_at` string, date-time, required
  - `created_at` string, date-time, required
  - `page_info` PaginationMetadata
    - `next` string, nullable
    - `current` string, nullable
    - `has_next` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/harmonic/apis/harmonic-ai-public-api.md) · [All operations](https://skmtc.net/harmonic/apis/harmonic-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/harmonic/harmonic-ai-public-api/versions/83a88f0a9b1c/schema)