---
title: "Directory"
method: GET
path: "/companies"
tags: ["Companies"]
---

# Directory

`GET /companies`

## Request

- Base URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY`
- URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY/companies`
- Auth: none declared

Directory of companies.

Rank and ID sort ascending; employee_count sorts descending.

Required permissions for your API key's user: `corp.companies`.

## Query parameters

- `offset` integer
- `page_size` integer
- `sort_field` 'rank' | 'employee_count' | 'id'
- `search` string

## Response `200`

Successful response.

- union
  - object
    - `total` integer, nullable
    - `offset` integer, nullable
    - `page_size` integer, nullable
    - `results` object[]
      - `id` integer, nullable: Company ID.
      - `name` string, nullable: Company name.
      - `slug` string, nullable: A unique textual identifier for this company.
      - `rank` integer, nullable: MixRank Rank (lower numbers are better and indicate more significant companies).
      - `score` number, nullable: MixRank Authority Score™.
      - `employees` integer, nullable: Number of current employees at this company.
      - `rank_internetretailer` integer, nullable: Internet Retailer Rank.
      - `rank_incmagazine` integer, nullable: Inc. 5000 Rank.
      - `rank_fortune` integer, nullable: Fortune Rank.
      - `address` object, nullable: Primary address for this company.
        - `street_address` string, nullable: Street address of this company.
        - `city` string, nullable: City of this company.
        - `region` string, nullable: State/Province of the company headquarters.
        - `country` string, nullable: Headquarters country of this company.
        - `postal_code` string, nullable: Postal routing code of this company.
      - `linkedin` object, nullable: LinkedIn company profile.
        - `id` integer, nullable: LinkedIn company ID.
        - `website` string, nullable: LinkedIn company website.
        - `url` string, nullable: LinkedIn company URL.
        - `type` string, nullable: Description of the company type (e.g. "Public Company", "Privately Held").
        - `size` string, nullable: Description of the company size in terms of employees (e.g. "1-10 employees", "10,001+ employees").
        - `name` string, nullable: Name.
        - `founded` integer, nullable: Foundation year.
        - `description` string, nullable: Description.
        - `locations` object[], nullable: Locations.
          - `address` string, nullable: Location address.
          - `is_primary` boolean, nullable: Boolean flag to distinguish between the primary location and the rest, "true" when is considered a primary address, otherwise "false".
        - `country` string, nullable: Two letters country code (ISO 3166-1 alpha-2).
        - `specialties` string[], nullable: Company specialties (e.g. "AI", "Cloud Computing").
        - `employee_count` integer, nullable: Employee count.
        - `follower_count` integer, nullable: Followers on LinkedIn.
        - `logo_url` string, nullable: Company logo download URL.
        - `similar_pages` integer[], nullable: List of linkedin_company ids found in "Similar pages" section.
      - `web` object, nullable: Fields related to web platform.
        - `site_count` integer, nullable: Number of websites published by this company.
        - `tag_count` integer, nullable: Number of Web Tags produced by this company.
      - `appstore` object, nullable: Fields related to Apple App Store.
        - `app_count` integer, nullable: Number of iOS apps published by this company.
        - `sdk_count` integer, nullable: Number of iOS SDKs produced by this company.
      - `playstore` object, nullable: Fields related to Google Play Store.
        - `app_count` integer, nullable: Number of Android apps published by this company.
        - `sdk_count` integer, nullable: Number of Android SDKs produced by this company.
      - `industries` object[], nullable: Company industries.
        - `id` integer, nullable: Industry ID
        - `name` string, nullable: Industry name
        - `is_primary` boolean, nullable: Whether or not this is a primary industry that this company is involved in
      - `sic` object[], nullable: Standard Industry Classification codes for this company.
        - `id` string, nullable: Industry ID.
        - `name` string, nullable: Industry name.
      - `naics` object[], nullable: North American Industry Classification System codes for this company.
        - `id` string, nullable: Industry ID
        - `name` string, nullable: Industry name.
  - object
    - `errors` object, required

## Other responses

- `403`: Invalid key or insufficient endpoint permissions.
- `408`: The database query timed out.
- `429`: Concurrent request limit exceeded.
- `500`: Internal API error.

---

[API](https://skmtc.dev/mixrank/apis/mixrank-api.md) - [All operations](https://skmtc.dev/mixrank/apis/mixrank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mixrank/apis/mixrank-api/revisions/786d3fcfe918?raw)