---
title: "Get Company By Domain"
method: GET
path: "/api/corporate/v1/companies"
tags: ["corporate"]
---

# Get Company By Domain

`GET /api/corporate/v1/companies`

## Request

- Base URL: `https://api.echoloc.ai`
- URL: `https://api.echoloc.ai/api/corporate/v1/companies`
- Auth: none declared

Resolve a domain to the single best-matching company.

Matches the primary domain first; if nothing owns it, falls back to known
aliases (regional TLDs, legacy brands, subdomains, redirects). The response
carries the primary domain. When several records match, returns the most
prominent by linkedin_employees then linkedin_followers. Returns 404 if none match.

## Query parameters

- `domain` string, required: Company domain, e.g. 'walgreens.com' or 'https://www.walgreens.com'

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- CorporateCompany: A single company as exposed to corporate API clients.
  - `company_id` string, required
  - `name` string, required
  - `domain` string, nullable
  - `short_description` string, nullable
  - `industry` string, nullable
  - `company_type` string, nullable
  - `founded_year` string, nullable
  - `country` string, nullable
  - `city` string, nullable
  - `employees_range_min` integer, nullable
  - `employees_range_max` integer, nullable
  - `linkedin_url` string, nullable
  - `hiring` HiringStats: Hiring activity for a company, aggregated from active job postings.
    - `total_active_jobs` integer
    - `jobs_last_7d` integer
    - `jobs_last_30d` integer
    - `jobs_last_90d` integer
    - `hiring_velocity` string, nullable
    - `hiring_ratio` number, nullable
    - `leadership_positions_count` integer, nullable
    - `departments` object
    - `seniority` object
    - `notable_roles` string[]
  - `technologies` TechUsage[]
    - `name` string, required
    - `count` integer, required
  - `tech_using` string[]
  - `tech_adopting` string[]
  - `tech_replacing` string[]
  - `tech_evaluating` string[]

## Other responses

- `422`: Validation Error

---

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