API & MCP

Companies API.

Find companies, Get company details. For authentication, paging and errors, see the API overview.

Generated from the EQALL API on October 23, 2026 · API version 1.0 · OpenAPI JSON

Find companies

GET/external/companies

MCP tool: findCompany

Search the user's own company and the companies of people in their network, by name or domain.

Parameters

querystring · queryrequired

Company name or domain text, e.g. "acme" or "acme.com". At least 2 characters.

limitnumber · query

Results per page (default 20, max 50)

cursorstring · query

nextCursor from the previous page

Response

companiesarray of objects

companyIdstring

Public company ID

namestring

domainstring, nullable

nextCursorstring, nullable

Pass back as cursor for the next page; null on the last page

Errors

401 · Missing, unknown or revoked API key 422 · Invalid query, limit or cursor 429 · Rate limit exceeded (per key)

Request

curl "https://api.eqall.com/external/companies?query=acme" \
  -H "Authorization: Bearer $EQALL_KEY"

Response · 200

{
  "companies": [
    {
      "companyId": "b3e9d2c1-7a44-4f0e-8d6b-91c5e2f4a830",
      "name": "Acme Corp",
      "domain": "acme.com"
    }
  ],
  "nextCursor": null
}

Get company details

GET/external/companies/{companyId}

MCP tool: getCompanyDetails

Profile, products, partners, leadership, finance (public companies), EQALL insights, news and last meeting recap.

Parameters

companyIdstring · pathrequired

Public company ID from company search or a contact

Response

companyIdstring

Public company ID

namestring

domainstring, nullable

websiteUrlstring, nullable

linkedInIdstring, nullable

linkedInUrlstring, nullable

phonestring, nullable

contactEmailstring, nullable

overviewstring, nullable

descriptionstring, nullable

industryarray of string

specialitiesarray of string

dunsstring, nullable

fiscalYearEndstring, nullable

MMDD

stateOfIncorporationstring, nullable

addressesarray of objects

Show 10 child fields

namestring, nullable

headquartersboolean

line1string, nullable

line2string, nullable

line3string, nullable

line4string, nullable

citystring, nullable

statestring, nullable

postalCodestring, nullable

countryCodestring, nullable

partnershipsarray of objects

partnerstring

typestring, nullable

employeesobject, nullable

numbernumber, nullable

rangeLownumber, nullable

rangeHighnumber, nullable

null when open-ended (e.g. 10,001+)

stocksarray of objects

symbolstring

exchangestring, nullable

servicesarray of objects

namestring

descriptionstring, nullable

executiveTeamarray of objects

namestring

rolestring, nullable

financeobject, nullable

Public (SEC-filing) companies only

financialPerformancestring, nullable

salesStrategystring, nullable

keyRisksarray of string

annualReportLinkstring, nullable

insightsarray of objects

Talking points, tailored to what the user's company sells

titlestring, nullable

insightstring

Plain text; "- " bullets

newsSummarystring, nullable

newsarray of objects

Up to 5

titlestring

descriptionstring

datedate-time

urlstring

lastMeetingRecapstring, nullable

Errors

401 · Missing, unknown or revoked API key 404 · Company doesn't exist or the user can't see it 429 · Rate limit exceeded (per key)

Request

curl "https://api.eqall.com/external/companies/{companyId}" \
  -H "Authorization: Bearer $EQALL_KEY"

Response · 200

{
  "companyId": "b3e9d2c1-7a44-4f0e-8d6b-91c5e2f4a830",
  "name": "Acme Corp",
  "domain": "acme.com",
  "websiteUrl": "https://www.acme.com",
  "linkedInId": "acme-corp",
  "linkedInUrl": "https://www.linkedin.com/company/acme-corp",
  "phone": "+1 415 555 0100",
  "contactEmail": "info@acme.com",
  "overview": "Acme makes industrial automation equipment for mid-size manufacturers.",
  "description": "Founded in 1998, Acme designs and services automation lines across North America.",
  "industry": [
    "Industrial Automation"
  ],
  "specialities": [
    "Robotics",
    "Predictive Maintenance"
  ],
  "duns": "123456789",
  "fiscalYearEnd": "1231",
  "stateOfIncorporation": "DE",
  "addresses": [
    {
      "name": "Headquarters",
      "headquarters": true,
      "line1": "100 Market Street",
      "line2": "Suite 400",
      "line3": null,
      "line4": null,
      "city": "San Francisco",
      "state": "CA",
      "postalCode": "94105",
      "countryCode": "US"
    }
  ],
  "partnerships": [
    {
      "partner": "AWS",
      "type": "Cloud Services Provider"
    }
  ],
  "employees": {
    "number": 2400,
    "rangeLow": 1001,
    "rangeHigh": 5000
  },
  "stocks": [
    {
      "symbol": "ACME",
      "exchange": "NYSE"
    }
  ],
  "services": [
    {
      "name": "Line Automation",
      "description": "Design and install automated assembly lines."
    }
  ],
  "executiveTeam": [
    {
      "name": "Alex Chen",
      "role": "Chief Executive Officer"
    }
  ],
  "finance": {
    "financialPerformance": "Revenue grew 8% year over year with improving margins.",
    "salesStrategy": "Expanding service contracts with existing customers.",
    "keyRisks": [
      "Supply-chain constraints on components"
    ],
    "annualReportLink": "https://www.sec.gov/"
  },
  "insights": [
    {
      "title": "Lead with uptime",
      "insight": "Acme's growth depends on service contracts, so frame your value around reducing customer downtime."
    }
  ],
  "newsSummary": "Acme announced a predictive-maintenance product line and a new Texas plant.",
  "news": [
    {
      "title": "Acme opens Austin plant",
      "description": "The new facility adds 300 jobs.",
      "date": "2026-09-30T00:00:00.000Z",
      "url": "https://news.example.com/acme-austin"
    }
  ],
  "lastMeetingRecap": "Discussed the pilot timeline; Acme wants a proposal by end of quarter."
}