---
title: "List companies"
method: GET
path: "/v1/companies"
tags: ["LinkedIn"]
---

# List companies

`GET /v1/companies`

## Request

- Base URL: `https://api.talktohumans.app`
- URL: `https://api.talktohumans.app/v1/companies`
- Auth: HTTP bearer

Lists LinkedIn companies.

## Query parameters

- `account_id` string[]
- `view_id` string
- `limit` integer
- `cursor` string

## Response `200`

Companies matching the filters.

- ListCompaniesEnvelope
  - `data` ListCompaniesResponse, required
    - `companies` Company[], required
      - `company_id` string, required
      - `provider_participant_id` string, required
      - `public_identifier` string
      - `name` string, required
      - `headline` string
      - `linkedin_url` string, uri
      - `avatar_url` string, uri
      - `background_cover_url` string, uri
      - `headcount` string
      - `employee_count` integer, nullable
      - `founding_date` string
      - `website_url` string, uri
      - `follower_count` integer, nullable
      - `about` string
      - `notes_json` string: Notes
      - `industries` Industry[], required
        - `name` string
        - `title` string
        - `industry_urn` string
        - `provider_industry_id` string
        - `hierarchy` string
      - `locations` Location[], required
        - `linkedin_text` string
        - `display_text` string
        - `country_code` string
        - `region_code` string
        - `country` string
        - `country_full` string
        - `state` string
        - `city` string
        - `geographic_area` string
        - `is_primary` boolean, required
        - `is_headquarter` boolean, required
      - `tags` APITag[]: Tags
        - `name` string, required
        - `color` 'green' | 'orange' | 'blue' | 'red' | 'purple' | 'yellow' | 'pink' | 'grey', required
    - `pagination` Pagination, required
      - `limit` integer, required
      - `has_more` boolean, required
      - `next_cursor` string: Cursor for the next page. Omitted when there are no more results.

## Other responses

- `400`: Invalid request parameters.
- `401`: Missing, malformed, invalid, or retired local API key.
- `403`: API access is not enabled for the organization, the API key cannot resolve to an active organization user, or the credential cannot access the requested LinkedIn account.
- `404`: Requested resource was not found.
- `429`: Rate limit exceeded. Public routes allow 50 requests per 10 seconds per IP and endpoint.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/talktohumans/apis/talktohumans-public-api.md) · [All operations](https://skmtc.dev/talktohumans/apis/talktohumans-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talktohumans/apis/talktohumans-public-api/revisions/4551ad2f26af?raw)