---
title: "Look up company"
method: POST
path: "/company/lookup"
---

# Look up company

`POST /company/lookup`

Look up a single company using its identifiers (domain, or professional network URL/ID). Returns the best matching company.

## Request body

- LookUpCompanyRequest — Provide at least one identifier to match a single company. The domain or professional network URL/ID give the most reliable match.
  - `domain` string — Company domain to look up.
  - `professional_network_url` string — Professional network URL of the company.
  - `professional_network_id` integer — Professional network ID of the company.

## Response `200`

OK

- object
  - `companies` Company[] — Array containing the matching company. Returns an empty array if no match is found.
    - `id` string — Unique company identifier
    - `name` string — Company name
    - `domain` string — Company domain
    - `description` string — Company description
    - `year_founded` integer — Year the company was founded. Returns 0 when unknown.
    - `headcount` integer — Exact number of employees. May return 0 even when headcount_range is available.
    - `headcount_range` string — Employee count range (e.g., '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+')
    - `company_type` string — Type of company (e.g., 'Public Company', 'Privately Held', 'Nonprofit', 'Self-Employed', 'Partnership', 'Educational', 'Government Agency')
    - `locations` object — Company location information
      - `headquarters` CompanyAddress — Structured headquarters address with parsed location fields
        - `line1` string — Address line 1 (street address)
        - `line2` string — Address line 2 (full location string including city, region, postal code, and country code)
        - `city` string — City name
        - `region` string — State or region
        - `country` string — Country name
        - `country_code` string — ISO country code
      - `offices` OfficeAddress[], nullable — Additional office locations. Only contains raw address lines (line1, line2) without structured city/region/country fields. Can be null or an empty array.
        - `line1` string — Street address
        - `line2` string — Full location string (city, region, postal code, country code)
    - `social_profiles` CompanySocialProfile
      - `professional_network` object — Professional network profile information
        - `id` integer — Professional network profile ID
        - `url` string — Full professional network profile URL
        - `handle` string — Professional network profile handle/username
        - `connection_count` integer — Number of professional network followers
    - `specialties` string[] — Specialties associated with the company
    - `industry` object — Company industry information
      - `main_industry` string — Primary industry category (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Financial Services', 'Healthcare', 'Retail')
  - `metadata` object
    - `credits` number, double — Total number of credits consumed

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests

---

[API](https://skmtc.dev/fullenrich/apis/fullenrich-api-documentation.md) · [All operations](https://skmtc.dev/fullenrich/apis/fullenrich-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fullenrich/fullenrich-api-documentation/revisions/b6357fb61fc7/schema)