> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encrata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Search

> Find people and email addresses at a company by name. Returns employees with roles, emails, and social profiles.

## Authentication

Requires an API key in the `Authorization` header.

```bash theme={"dark"}
Authorization: Bearer YOUR_API_KEY
```

## Request

<ParamField body="query" type="string" required>
  The company name to search (e.g. `Tesla`)
</ParamField>

## Response

Returns an array of people found at the company, plus a unified `profile` object with enriched company data including officers and shareholders.

<ResponseField name="company" type="string">
  The queried company name.
</ResponseField>

<ResponseField name="results" type="array">
  Array of people found at the company with email, name, role, and social profiles.
</ResponseField>

<ResponseField name="profile" type="object">
  Unified company profile merged from multiple sources (Companies House, TheCompaniesAPI, SEC). May be `null` if no enrichment data is available.

  <Expandable title="Profile fields">
    <ResponseField name="name" type="string">Company legal name</ResponseField>
    <ResponseField name="domain" type="string">Company website domain</ResponseField>
    <ResponseField name="description" type="string">Company description</ResponseField>
    <ResponseField name="founding_date" type="string">Founding or incorporation date</ResponseField>
    <ResponseField name="industry" type="string">Industry classification</ResponseField>
    <ResponseField name="company_type" type="string">Legal entity type (e.g. "ltd", "plc")</ResponseField>
    <ResponseField name="status" type="string">Company status (e.g. "active", "dissolved")</ResponseField>
    <ResponseField name="employee_count" type="integer">Number of employees</ResponseField>
    <ResponseField name="revenue" type="string">Annual revenue estimate</ResponseField>
    <ResponseField name="total_funding" type="string">Total funding raised</ResponseField>
    <ResponseField name="address" type="string">Registered address</ResponseField>
    <ResponseField name="country" type="string">Country of registration</ResponseField>
    <ResponseField name="phone" type="string">Company phone number</ResponseField>
    <ResponseField name="website" type="string">Full website URL</ResponseField>
    <ResponseField name="logo" type="string">Logo image URL</ResponseField>
    <ResponseField name="linkedin" type="string">LinkedIn company URL</ResponseField>
    <ResponseField name="twitter" type="string">Twitter/X URL</ResponseField>
    <ResponseField name="ticker" type="string">Stock ticker symbol</ResponseField>
    <ResponseField name="registration_number" type="string">Company registration number</ResponseField>
    <ResponseField name="jurisdiction" type="string">Jurisdiction of incorporation</ResponseField>
    <ResponseField name="sic_codes" type="array">SIC industry classification codes</ResponseField>

    <ResponseField name="officers" type="array">
      Company officers (directors, secretaries).
      Each has: `name`, `role`, `appointed_on`, `nationality`.
    </ResponseField>

    <ResponseField name="shareholders" type="array">
      Persons with significant control (PSC).
      Each has: `name`, `natures_of_control`, `nationality`, `notified_on`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="integer">
  Number of people results returned.
</ResponseField>

<ResponseField name="credits" type="integer">
  Credits consumed for this request.
</ResponseField>

<ResponseExample>
  ```json theme={"dark"}
  {
    "company": "Tesla",
    "results": [
      {
        "email": "elon@tesla.com",
        "name": "Elon Musk",
        "role": "CEO",
        "linkedin": "https://linkedin.com/in/elonmusk"
      }
    ],
    "profile": {
      "name": "Tesla, Inc.",
      "domain": "tesla.com",
      "description": "Electric vehicle and clean energy company.",
      "industry": "Automotive",
      "status": "active",
      "employee_count": 140000,
      "revenue": "$96.8B",
      "country": "United States",
      "website": "https://tesla.com",
      "ticker": "TSLA",
      "linkedin": "https://linkedin.com/company/tesla-motors",
      "officers": [
        {
          "name": "Elon Musk",
          "role": "chief-executive-officer"
        }
      ],
      "shareholders": []
    },
    "total": 1,
    "credits": 1
  }
  ```
</ResponseExample>

## Credits

1 credit per result returned.