Company Search

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

POST /api/agent/company

Company Search

cURL

curl --request POST \
  --url https://encrata.com/api/agent/company \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company": "<string>"
}
'

{
  "company": "Tesla",
  "results": [
    {
      "email": "[e-mail]",
      "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
}

Authentication

Requires an API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Request

company · string · required

The company name to search (e.g. Tesla)

Response

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

company · string

The queried company name.

results · array

Array of people found at the company with email, name, role, and social profiles.

profile · object

Unified company profile merged from multiple sources (Companies House, TheCompaniesAPI, SEC). May be null if no enrichment data is available.

Show Profile fields

name · string

Company legal name

domain · string

Company website domain

description · string

Company description

founding_date · string

Founding or incorporation date

industry · string

Industry classification

company_type · string

Legal entity type (e.g. “ltd”, “plc”)

status · string

Company status (e.g. “active”, “dissolved”)

employee_count · integer

Number of employees

revenue · string

Annual revenue estimate

total_funding · string

Total funding raised

address · string

Registered address

country · string

Country of registration

phone · string

Company phone number

website · string

Full website URL

logo · string

Logo image URL

linkedin · string

LinkedIn company URL

twitter · string

Twitter/X URL

ticker · string

Stock ticker symbol

registration_number · string

Company registration number

jurisdiction · string

Jurisdiction of incorporation

sic_codes · array

SIC industry classification codes

officers · array

Company officers (directors, secretaries). Each has: name, role, appointed_on, nationality.

shareholders · array

Persons with significant control (PSC). Each has: name, natures_of_control, nationality, notified_on.

total · integer

Number of people results returned.

credits · integer

Credits consumed for this request.

{
  "company": "Tesla",
  "results": [
    {
      "email": "[e-mail]",
      "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
}

Credits

1 credit per result returned.