companies

Get Company Watchlists By Owner

get/watchlists/companies

Query parameters

company_urnsstring[]

Only show those watchlists that contains company urns

Fetch watchlists with specific type. If None is provided, it fetches all

return_company_urnsboolean

Whether the endpoint should return the company ids associated with the watchlist or not.

return_company_countboolean

Whether the endpoint should return the number of companies associated with the watchlist or not.

get_team_shared_listboolean

Fetch public watchlists shared by other users in the team

Response

Successful Response

namestring required

shared_with_teamboolean required

creatorstring nullable

companies_countinteger nullable

named_views_orderstring[]

idstring uuid required

updated_atstring date-time required

created_atstring date-time required

user_relevance_score_influence_typestring nullable

Changes

Changed in 6 of the 11 revisions of this API.1817

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 31, 2026365932b870d521See the full diff
- ●
  added the new IN_PROCESS enum value to the items/companies/anyOf[subschema #1]/items/funding_rounds/items/completion_status/anyOf[subschema #1: FundingCompletionStatus]/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new RUMORED enum value to the items/companies/anyOf[subschema #1]/items/funding_rounds/items/completion_status/anyOf[subschema #1: FundingCompletionStatus]/ response property for the response status 200
  response-property-enum-value-added
- ○
  added the optional property items/companies/anyOf[subschema #1]/items/related_companies/anyOf[subschema #1: CompanyRelationship]/rebrands to the response with the 200 status
  response-optional-property-added
Jul 26, 2026fcf35c98e097128See 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
- ○
  added CompanyRelationship to the items/companies/anyOf[subschema #1]/items/related_companies response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added TractionMetrics to the items/companies/anyOf[subschema #1]/items/traction_metrics response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added ValuationInfo to the items/companies/anyOf[subschema #1]/items/funding_rounds/items/valuation_info response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  removed CompanyRelationship-Output from the items/companies/anyOf[subschema #1]/items/related_companies response property anyOf list for the response status 200
  response-property-any-of-removed
- ○
  removed TractionMetrics-Output from the items/companies/anyOf[subschema #1]/items/traction_metrics response property anyOf list for the response status 200
  response-property-any-of-removed
- ○
  removed ValuationInfo-Output from the items/companies/anyOf[subschema #1]/items/funding_rounds/items/valuation_info response property anyOf list for the response status 200
  response-property-any-of-removed
This revision also has 24 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 13, 2026a089c6611e742See the full diff
- ○
  added the optional property items/companies/anyOf[subschema #1]/items/notable_followers to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/companies/anyOf[subschema #1]/items/num_notable_followers to the response with the 200 status
  response-optional-property-added

Full history