# Search Single Company

Find detailed information about a single company by using different paramaters.
>##### Endpoint:
  
GET https://api.lusha.com/v2/company
  

>##### Notes:
  - At least one of domain, company, or companyId is required.
  - Signal sub-filters (newsEventTypes, hiringByDepartments, hiringByLocations) are not supported on this endpoint. Use POST /bulk/company/v2 with the signalsFilters parameter for filtered signal retrieval.

Endpoint: GET /v2/company
Security: ApiKeyAuth

## Query parameters:

  - `domain` (string)
    The domain name associated with the company
    Example: "example.com"

  - `company` (string)
    The name of the company
    Example: "Lusha"

  - `companyId` (string)
    A unique identifier for a Lusha company.
    Example: "1234567890"

  - `signals` (array)
    Array of signal types to retrieve for the company.
- allSignals: All available signal types

> See the Signal Options endpoint for complete list of available signals and their categories
    Enum: "allSignals", "websiteTrafficIncrease", "websiteTrafficDecrease", "itSpendIncrease", "itSpendDecrease", "headcountIncrease1m", "headcountDecrease1m", "headcountIncrease3m", "headcountDecrease3m", "headcountIncrease6m", "headcountDecrease6m", "headcountIncrease12m", "headcountDecrease12m", "surgeInHiring", "surgeInHiringByDepartment", "surgeInHiringByLocation", "riskNews", "commercialActivityNews", "corporateStrategyNews", "financialEventsNews", "peopleNews", "marketIntelligenceNews", "productActivityNews"

  - `signalsStartDate` (string)
    Start date for signal retrieval in YYYY-MM-DD format. Defaults to 6 months ago if not specified.
    Example: "2025-03-01"

  - `partialCompany` (boolean)
    Expand coverage with partial company profiles

## Response 200 fields (application/json):

  - `data` (object)

  - `data.id` (number, required)
    A unique identifier for the Lusha company.
    Example: 123

  - `data.description` (string)
    A brief description of the company.
    Example: "Lusha is the sales intelligence platform designed to help businesses get their next customers."

  - `data.domain` (string)
    The domain name associated with the company's email addresses.
    Example: "lusha.com"

  - `data.employees` (string)
    The company's employee size range.
    Example: "201 - 500"

  - `data.founded` (string)
    The year the company was founded.
    Example: "August 1, 2011"

  - `data.fqdn` (string)
    The fully qualified domain name of the company.
    Example: "www.lusha.com"

  - `data.logoUrl` (string)
    The URL of the company's logo.
    Example: "https://logo.lusha.co/logo.jpg"

  - `data.name` (string, required)
    The name of the company.
    Example: "Lusha"

  - `data.linkedinFollowers` (integer)
    LinkedIn followers count for the company
    Example: 1950

  - `data.emailDomain` (string)
    Company email domain
    Example: "lusha.com"

  - `data.companyLocations` (array)
    All known company locations (not just HQ).

  - `data.companyLocations.city` (string)
    Example: "Bucharest"

  - `data.companyLocations.continent` (string)
    Example: "Europe"

  - `data.companyLocations.country` (string)
    Example: "Romania"

  - `data.companyLocations.country_iso2` (string)
    Example: "RO"

  - `data.companyLocations.location_coordinates` (array)
    Example: [26.1062603,44.432251]

  - `data.companyLocations.state` (string,null)

  - `data.companyLocations.state_code` (string,null)

  - `data.alternativeName` (string)
    Normalized alternative company name
    Example: "lusha systems"

  - `data.companyType` (string)
    Type of company
    Example: "Private company"

  - `data.lushaPopularityTier` (integer)
    A proprietary ranking used by Lusha to categorize companies based on their popularity in the platform
    Example: 1

  - `data.companySize` (object)
    Company size details.

  - `data.companySize.min` (number)
    Example: 11

  - `data.companySize.max` (number)
    Example: 50

  - `data.companySize.employeesInLinkedin` (number)
    Example: 32

  - `data.revenueRange` (array)
    The company's revenue range.
    Example: [1000000,10000000]

  - `data.mainIndustry` (string)
    The main industry of the company.
    Example: "Technology"

  - `data.subIndustry` (string)
    The specific sub-sector within the primary industry.
    Example: "Software"

  - `data.social` (object)

  - `data.social.crunchbase` (object)

  - `data.social.crunchbase.url` (string, required)
    Example: "https://crunchbase.com/company/lusha"

  - `data.social.linkedin` (object)

  - `data.social.linkedin.url` (string, required)
    Example: "https://linkedin.com/company/lusha"

  - `data.address` (string)
    The full address of the company's location.
    Example: "North America United States Boston  800 Boylston St , Suite 1410 , Boston, Massachusetts 02199, US  Massachusetts US MA -71.05976867675781,42.358428955078125"

  - `data.location` (object)
    HQ location only. For all company site locations, see companyLocations.

  - `data.location.city` (string)
    Example: "Boston"

  - `data.location.country` (string)
    Example: "United States"

  - `data.location.fullLocation` (string)
    Example: "800 Boylston St, Suite 1410, Boston, Massachusetts 02199, US"

  - `data.location.state` (string)
    Example: "Massachusetts"

  - `data.location.stateCode` (string)
    Example: "MA"

  - `data.location.countryIso2` (string)
    Example: "US"

  - `data.location.rawLocation` (string)
    Example: "800 Boylston St; Suite 1410; Boston, Massachusetts 02199, US"

  - `data.categories` (array)
    LinkedIn industry tags for the company.
    Example: ["Technology","Software"]

  - `data.industryPrimaryGroupDetails` (object)

  - `data.industryPrimaryGroupDetails.sicCodes` (array)

  - `data.industryPrimaryGroupDetails.sicCodes.sicCodes` (number)
    Example: 1234

  - `data.industryPrimaryGroupDetails.sicCodes.description` (string, required)
    Example: "Software Publishing"

  - `data.industryPrimaryGroupDetails.naicsCodes` (array)

  - `data.industryPrimaryGroupDetails.naicsCodes.naicsCodes` (number)
    Example: 541511

  - `data.industryPrimaryGroupDetails.naicsCodes.description` (string, required)
    Example: "Custom Computer Programming Services"

  - `data.website` (string)
    The company's website URL.
    Example: "https://lusha.com"

  - `data.specialities` (array)
    LinkedIn specialties tags associated with the company.
    Example: ["data enrichment","sales intelligence","lead generation","prospecting"]

  - `data.funding` (object)

  - `data.funding.rounds` (array)

  - `data.funding.rounds.currency` (string, required)
    Example: "USD"

  - `data.funding.rounds.roundAmount` (number, required)
    Example: 205000000

  - `data.funding.rounds.roundType` (string, required)
    Example: "Private Equity Round"

  - `data.funding.rounds.roundDate` (string, required)
    Example: "Nov 10, 2021"

  - `data.funding.totalRounds` (number, required)
    Example: 2

  - `data.funding.totalRoundsAmount` (number)
    Example: 245000000

  - `data.funding.currency` (string, required)
    Example: "USD"

  - `data.funding.isIpo` (boolean, required)

  - `data.funding.lastRoundType` (string)
    Example: "Private Equity Round"

  - `data.funding.lastRoundAmount` (number)
    Example: 205000000

  - `data.funding.lastRoundDate` (string)
    Example: "Nov 10, 2021"

  - `data.intent` (object)

  - `data.intent.detectedTopics` (array, required)

  - `data.intent.detectedTopics.topicName` (string, required)
    Example: "Remote Sales"

  - `data.intent.detectedTopics.metadata` (object, required)

  - `data.intent.detectedTopics.metadata.topicScore` (number, required)
    Example: 83

  - `data.intent.detectedTopics.metadata.topicTrend` (string, required)
    Example: "-5"

  - `data.intent.topicCount` (number, required)
    Example: 6

  - `data.technologies` (array)
    A list of technologies associated with the company.

  - `data.technologies.name` (string, required)
    Example: "salesforce"

  - `data.riskNews` (array)
    Litigations and security news signals

  - `data.riskNews.companyId` (string)
    Example: "33222678"

  - `data.riskNews.companyName` (string)
    Example: "Lusha"

  - `data.riskNews.domain` (string)
    Example: "lusha.com"

  - `data.riskNews.signalId` (string)
    Example: "1503910"

  - `data.riskNews.eventType` (string)
    Example: "partnership"

  - `data.riskNews.eventSummary` (string)
    Example: "Lusha announced a strategic partnership with Salesforce."

  - `data.riskNews.articlePublishedDate` (string)
    Example: "2025-06-15"

  - `data.riskNews.articleTitle` (string)
    Example: "Lusha Partners with Salesforce"

  - `data.riskNews.articleHighlight` (string)
    Example: "The partnership enables Salesforce users to access Lusha data directly within their CRM."

  - `data.riskNews.eventEffectiveDate` (string)
    Example: "2025-06-10"

  - `data.riskNews.articleUrl` (string)
    Example: "https://example.com/lusha-salesforce-partnership"

  - `data.commercialActivityNews` (array)
    Launches, partnerships, and go-to-market activity signals

  - `data.corporateStrategyNews` (array)
    M&A, restructuring, or strategic direction change signals

  - `data.financialEventsNews` (array)
    Funding, IPOs, and financial performance event signals

  - `data.peopleNews` (array)
    Hiring, layoffs, or leadership change signals

  - `data.marketIntelligenceNews` (array)
    Event participation, recognition, and competitor activity signals

  - `data.productActivityNews` (array)
    Product launch, development, and integration news signals

  - `data.surgeInHiring` (array)
    Overall hiring surge signals

  - `data.surgeInHiring.companyId` (string)
    Example: "3416"

  - `data.surgeInHiring.signalId` (string)
    Example: "1503905"

  - `data.surgeInHiring.signalDate` (string)
    Example: "2025-06-15"

  - `data.surgeInHiring.newJobsPostedLastWeek` (number)
    Example: 25

  - `data.surgeInHiring.historicalAvg` (number)
    Example: 10

  - `data.surgeInHiring.changeRatePercent` (number)
    Example: 150

  - `data.surgeInHiring.companyName` (string)
    Example: "Lusha"

  - `data.surgeInHiring.domain` (string)
    Example: "lusha.com"

  - `data.surgeInHiringByDepartment` (array)
    Department-specific hiring surge signals

  - `data.surgeInHiringByDepartment.signalId` (string)
    Example: "1503906"

  - `data.surgeInHiringByDepartment.companyId` (string)
    Example: "3416"

  - `data.surgeInHiringByDepartment.department` (string)
    Example: "Engineering"

  - `data.surgeInHiringByDepartment.signalDate` (string)
    Example: "2025-06-15"

  - `data.surgeInHiringByDepartment.newJobsPostedLast4Weeks` (number)
    Example: 15

  - `data.surgeInHiringByDepartment.historicalAvg` (number)
    Example: 5

  - `data.surgeInHiringByDepartment.changeRatePercent` (number)
    Example: 200

  - `data.surgeInHiringByDepartment.companyName` (string)
    Example: "Lusha"

  - `data.surgeInHiringByDepartment.domain` (string)
    Example: "lusha.com"

  - `data.surgeInHiringByLocation` (array)
    Location-specific hiring surge signals

  - `data.surgeInHiringByLocation.signalId` (string)
    Example: "1503907"

  - `data.surgeInHiringByLocation.companyId` (string)
    Example: "3416"

  - `data.surgeInHiringByLocation.country` (string)
    Example: "United States"

  - `data.surgeInHiringByLocation.state` (string)
    Example: "California"

  - `data.surgeInHiringByLocation.signalDate` (string)
    Example: "2025-06-15"

  - `data.surgeInHiringByLocation.newJobsPostedLast4Weeks` (number)
    Example: 20

  - `data.surgeInHiringByLocation.historicalAvg` (number)
    Example: 8

  - `data.surgeInHiringByLocation.changeRatePercent` (number)
    Example: 150

  - `data.surgeInHiringByLocation.companyName` (string)
    Example: "Lusha"

  - `data.surgeInHiringByLocation.domain` (string)
    Example: "lusha.com"

  - `data.websiteTrafficIncrease` (array)
    Website traffic increase signals

  - `data.websiteTrafficIncrease.companyId` (string)
    Example: "3416"

  - `data.websiteTrafficIncrease.signalId` (string)
    Example: "1503902"

  - `data.websiteTrafficIncrease.signalDate` (string)
    Example: "2025-06-15"

  - `data.websiteTrafficIncrease.historicalAvg` (number)
    Example: 50000

  - `data.websiteTrafficIncrease.lastMonthVisits` (number)
    Example: 75000

  - `data.websiteTrafficIncrease.changeRatePercent` (number)
    Example: 50

  - `data.websiteTrafficIncrease.companyName` (string)
    Example: "Lusha"

  - `data.websiteTrafficIncrease.domain` (string)
    Example: "lusha.com"

  - `data.websiteTrafficDecrease` (array)
    Website traffic decrease signals

  - `data.itSpendIncrease` (array)
    IT spending increase signals

  - `data.itSpendIncrease.companyId` (string)
    Example: "3416"

  - `data.itSpendIncrease.signalId` (string)
    Example: "1503903"

  - `data.itSpendIncrease.signalDate` (string)
    Example: "2025-06-15"

  - `data.itSpendIncrease.estimatedAnnualItSpend` (number)
    Example: 5000000

  - `data.itSpendIncrease.changeRatePercent` (number)
    Example: 25

  - `data.itSpendIncrease.companyName` (string)
    Example: "Lusha"

  - `data.itSpendIncrease.domain` (string)
    Example: "lusha.com"

  - `data.itSpendDecrease` (array)
    IT spending decrease signals

  - `data.headcountIncrease1m` (array)

  - `data.headcountIncrease1m.companyId` (string)
    Example: "3416"

  - `data.headcountIncrease1m.signalId` (string)
    Example: "1503904"

  - `data.headcountIncrease1m.signalDate` (string)
    Example: "2025-06-15"

  - `data.headcountIncrease1m.baselineEmployeesCount` (number)
    Example: 500

  - `data.headcountIncrease1m.newEmployeesCount` (number)
    Example: 550

  - `data.headcountIncrease1m.changeRatePercent` (number)
    Example: 10

  - `data.headcountIncrease1m.companyName` (string)
    Example: "Lusha"

  - `data.headcountIncrease1m.domain` (string)
    Example: "lusha.com"

  - `data.headcountDecrease1m` (array)

  - `data.headcountIncrease3m` (array)

  - `data.headcountDecrease3m` (array)

  - `data.headcountIncrease6m` (array)

  - `data.headcountDecrease6m` (array)

  - `data.headcountIncrease12m` (array)

  - `data.headcountDecrease12m` (array)

  - `errors` (object)

  - `errors.message` (string, required)
    Example: "Something went wrong"

  - `meta` (object)
    Currently returns an empty value; this field should be deprecated in future releases.
    Example: {}

## Response 400 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]


