---
title: "Get company"
method: GET
path: "/api/v1/company"
---

# Get company

`GET /api/v1/company`

## Request

- Base URL: `https://api.fetchin.io`
- URL: `https://api.fetchin.io/api/v1/company`
- Auth: API key in header `X-API-Key`

Get detailed information about a company / organization. Consumes 1 credit.

## Query parameters

- `companyUrlOrUrn` string, required

## Response `200`

Successfully fetched company

- object
  - `id` string: Company URN (unique identifier)
  - `companyId` string: Numeric company id as a string
  - `name` string
  - `publicIdentifier` string: Public identifier (slug)
  - `url` string: Canonical company page URL
  - `websiteUrl` string: The company's own website
  - `domain` string: Website domain, minus a leading www.
  - `industry` string: Primary industry in the current taxonomy, matching the label shown on the company's public page
  - `industryV1` string: The same company's industry in the legacy taxonomy, for integrations that pinned the older labels. Not a renaming of `industry`: a company can sit under two unrelated entries in the two taxonomies, so this must not be used as a translation table. Prefer `industry`.
  - `employeeCount` number: Number of employees on the platform
  - `employeeCountRange` object
    - `start` number
    - `end` number: Absent for open-ended brackets
  - `foundedOn` object
    - `year` number
    - `month` number
    - `day` number
  - `headquarter` object
    - `line1` string
    - `line2` string
    - `city` string
    - `geographicArea` string: State / region
    - `postalCode` string
    - `country` string: ISO country code
    - `description` string: Office label, e.g. "Headquarters"
    - `headquarter` boolean: true for the headquarters entry
  - `locations` object[]
    - `line1` string
    - `line2` string
    - `city` string
    - `geographicArea` string: State / region
    - `postalCode` string
    - `country` string: ISO country code
    - `description` string: Office label, e.g. "Headquarters"
    - `headquarter` boolean: true for the headquarters entry
  - `followerCount` number
  - `logoUrl` string
  - `coverImageUrl` string: Cover/background image URL
  - `description` string
  - `specialities` string[]
  - `phone` string
  - `tagline` string
  - `companyType` string: The company's legal type as an English label, e.g. "Public Company", "Privately Held", "Self-Employed", "Sole Proprietorship", "Partnership", "Government Agency", "Nonprofit", "Educational".
  - `companyTypeCode` string: The same type as a stable code, e.g. "PUBLIC_COMPANY", "PRIVATELY_HELD". Branch on this rather than on the label.
  - `hashtags` string[]: Hashtags the page lists on its profile, in its order, without the `#`.

## Other responses

- `400`: Bad request - a required parameter is missing or a value is invalid.
- `401`: Unauthorized - the X-API-Key header is missing or invalid.
- `402`: Payment required - you are out of credits (QUOTA_EXHAUSTED): the plan allowance for the current period is spent AND no pay-as-you-go credits are left. Buy pay-as-you-go credits (self-serve, https://fetchin.io/credits), upgrade your plan, or wait for renewal; retrying will not help and no Retry-After is sent. Distinct from the per-second rate limit, which is a 429 (RATE_LIMITED).
- `404`: Not found - the request was served successfully but the requested professional entity does not exist.
- `429`: Too many requests - your per-second rate limit (RATE_LIMITED) was exceeded. Back off and retry, honoring the Retry-After header. (Running out of credits is a separate 402 PaymentRequired / QUOTA_EXHAUSTED, and buying credits never raises this per-second limit.)
- `500`: Internal server error - an unexpected error occurred in our API. Safe to retry; contact support if it persists.
- `503`: Service unavailable - our API is temporarily unable to serve this request (capacity exhausted or overloaded). This is on our side, not yours and not an upstream service outage. Retry with backoff, honoring the Retry-After header.

---

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