---
title: "Overview"
method: GET
path: "/companies/{company_id}"
tags: ["Companies"]
---

# Overview

`GET /companies/{company_id}`

## Request

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

Summary information about a company.

The company_financials option is available only on <a href="#tag/companies/GET/companies/match">company matching</a>.

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

## Path parameters

- `company_id` integer, required

## Response `200`

Successful response.

- 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.

## Other responses

- `400`: Missing or invalid required parameter.
- `403`: Invalid key or insufficient endpoint permissions.
- `404`: No matching company.
- `408`: Lookup 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)