--- title: "Get Companies In A List" method: GET path: "/v0/company_lists/{list_id}/companies" tags: ["Company Lists"] --- # Get Companies In A List `GET /v0/company_lists/{list_id}/companies` ## Request - Base URL: `https://api.theirstack.com` - URL: `https://api.theirstack.com/v0/company_lists/{list_id}/companies` - Auth: HTTP bearer List the companies in one of the team's company lists, each with its company profile and the dates it was added and revealed. Paginated; sort by reveal date or name, or filter by part of the company name. ## Path parameters - `list_id` integer, required ## Query parameters - `order_by` 'revealed_at' | 'name': Order by field - `order_direction` 'asc' | 'desc': Order direction - `company_name_partial` string: Pass a partial company name to filter the list of companies - `limit` integer: Number of results per page - `page` integer: Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination). - `offset` integer: Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination). ## Response `200` Successful Response - CompanyListItem[] - `company_name` string, required - `added_at` string, date-time, required: Date when the company was added to the list. - `revealed_at` string, date-time, required: Date when the company was revealed. - `company_object` CompanyWithTechnologySlugs, required - `id` string, required: Company ID - `name` string, required: Company name - `domain` string, nullable: Company domain - `industry` string, nullable: Industry of the company - `country` string, nullable: Country of the company's HQ - `country_code` string, nullable: ISO2 country code. E.g. "US" - `employee_count` integer, nullable: Number of employees of the company - `logo` string, nullable: Stable CDN-hosted company logo URL suitable for display in applications - `num_jobs` integer: Number of jobs from this company in our database - `num_technologies` integer: Number of technologies mentioned in the jobs of this company - `num_keywords` integer: Number of distinct keywords (technologies + buying intent topics) found in this company's jobs - `num_buying_intent_topics` integer: Number of distinct buying intent topic keywords found in this company's jobs - `possible_domains` string[]: List of possible domains for the company - `url` string, nullable: Company domain. Same as the "domain" field. Will be deprecated in the future. - `industry_id` integer, nullable: Code of the industry. One of LinkedIn's Industry Codes V2 from https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2 - `linkedin_url` string, nullable - `num_jobs_last_30_days` integer: Number of jobs from this company in our database posted in the last 30 days - `num_jobs_found` integer, nullable: When filtering companies by jobs, number of jobs found for this company - `yc_batch` string, nullable: If the company went through YC, this is its batch - `apollo_id` string, nullable: ID of the company in Apollo - `linkedin_id` string, nullable: ID of the company in LinkedIn - `url_source` string, nullable: Source of the company URL - `is_recruiting_agency` boolean, nullable: Is a recruiting agency - `founded_year` integer, nullable: Year the company was founded - `annual_revenue_usd` number, nullable: Annual revenue of the company in USD - `annual_revenue_usd_readable` string, nullable: Annual revenue of the company in USD, formated as an easily readable string - `total_funding_usd` integer, nullable: Funding of the company in USD - `last_funding_round_date` string, date, nullable: Date of the last funding round of the company - `last_funding_round_amount_readable` string, nullable: Amount of the last funding round of the company, formated as an easily readable string - `employee_count_range` string, nullable: Number range of employees at the company - `long_description` string, nullable: Short description of the company - `seo_description` string, nullable: SEO description of the company, extracted from their website - `city` string, nullable: City of the company's HQ - `postal_code` string, nullable: Postal code of the company's HQ - `company_keywords` string[], nullable: Company keywords, related to what the company does. Deprecated: use company_tags instead. - `company_tags` string[]: Company keywords, related to what the company does - `alexa_ranking` integer, nullable: Alexa ranking - `publicly_traded_symbol` string, nullable - `publicly_traded_exchange` string, nullable - `investors` string[], nullable: List of investors in this company - `funding_stage` 'angel' | 'convertible_note' | 'debt_financing' | 'equity_crowdfunding' | 'other' | 'private_equity' | 'seed' | 'series_a' | 'series_b' | 'series_c' | 'series_d' | 'series_e' | 'series_f' | 'series_g' | 'series_h' | 'venture_round_not_specified' | 'series_i' | 'series_j' | 'undisclosed' | 'series_unknown' | 'pre_seed' | 'post_ipo_secondary' | 'post_ipo_equity' | 'post_ipo_debt' | 'non_equity_assistance' | 'late_vc' | 'initial_coin_offering' | 'growth_equity_vc' | 'grant' | 'early_vc' | 'corporate_round' | 'secondary_market' | 'product_crowdfunding' - `has_blurred_data` boolean: Whether the returned object has company identifiable data blurred or not - `keyword_slugs` string[]: Slugs of all keywords (technologies and buying intent topics) found in this company's jobs - `technology_slugs` string[], nullable: Slugs of the technologies found in this company's jobs. This is a subset of keyword_slugs filtered to only technology-type keywords. - `technology_names` string[], nullable: Names of the technologies found to be used by the company ## Other responses - `400`: Bad Request - `402`: Payment Required - `422`: Unprocessable Content - `500`: Internal Server Error ## Changes - **2026-05-10** `1dae359ce2c7`: 5 info - added the optional property `items/company_object/company_tags` to the response with the `200` status - added the optional property `items/company_object/keyword_slugs` to the response with the `200` status - added the optional property `items/company_object/num_buying_intent_topics` to the response with the `200` status - added the optional property `items/company_object/num_keywords` to the response with the `200` status - …1 more - **2026-01-14** `ecd1eb029865`: 1 info - endpoint added [Operation history](https://skmtc.dev/theirstack/apis/theirstack-api-reference/changes/v0/company_lists/:list_id/companies/get.md) --- [API](https://skmtc.dev/theirstack/apis/theirstack-api-reference.md) - [All operations](https://skmtc.dev/theirstack/apis/theirstack-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/theirstack/apis/theirstack-api-reference/revisions/4f3da5ce4026?raw)