Company Signals

POST

companies

signals

Company Signals

curl --request POST \
  --url https://api.lusha.com/v3/companies/signals \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "ids": [
    "16303253"
  ],
  "signalTypes": [
    "allSignals"
  ],
  "startDate": "2025-01-01",
  "maxResultsPerSignal": 10
}
'

import requests

url = "https://api.lusha.com/v3/companies/signals"

payload = {
    "ids": ["16303253"],
    "signalTypes": ["allSignals"],
    "startDate": "2025-01-01",
    "maxResultsPerSignal": 10
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    ids: ['16303253'],
    signalTypes: ['allSignals'],
    startDate: '2025-01-01',
    maxResultsPerSignal: 10
  })
};

fetch('https://api.lusha.com/v3/companies/signals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

HttpResponse<String> response = Unirest.post("https://api.lusha.com/v3/companies/signals")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ids\": [\n    \"16303253\"\n  ],\n  \"signalTypes\": [\n    \"allSignals\"\n  ],\n  \"startDate\": \"2025-01-01\",\n  \"maxResultsPerSignal\": 10\n}")
  .asString();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lusha.com/v3/companies/signals"

	payload := strings.NewReader("{\n  \"ids\": [\n    \"16303253\"\n  ],\n  \"signalTypes\": [\n    \"allSignals\"\n  ],\n  \"startDate\": \"2025-01-01\",\n  \"maxResultsPerSignal\": 10\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "results": [
    {
      "id": "16303253",
      "companyName": "Lusha",
      "domain": "lusha.com"
    }
  ],
  "startDate": "2025-01-01",
  "endDate": "2025-07-31",
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}

Use this endpoint when you already have Lusha company IDs and want their signal activity - hiring surges, headcount changes, web traffic and IT spend shifts, and categorized news - in one call. Pass up to 100 ids and the signalTypes you want back; there is no separate “search” step in V3 - one call returns all matched signal data for the IDs you send.

Don’t have Lusha company IDs yet? Resolve companies first with Enrich Companies or Search & Enrich Companies, then pass the returned id values here.

Endpoint

POST https://api.lusha.com/v3/companies/signals

Authentication: API key (ApiKeyAuth)

Request body

string[]

required

Lusha company IDs to retrieve signals for. 1–100 items per request.Example: ["16303253"]

string[]

required

Signal types to retrieve.Allowed values: allSignals, websiteTrafficIncrease, websiteTrafficDecrease, itSpendIncrease, itSpendDecrease, surgeInHiring, surgeInHiringByDepartment, surgeInHiringByLocation, headcountIncrease1m, headcountDecrease1m, headcountIncrease3m, headcountDecrease3m, headcountIncrease6m, headcountDecrease6m, headcountIncrease12m, headcountDecrease12m, riskNews, commercialActivityNews, corporateStrategyNews, financialEventsNews, peopleNews, marketIntelligenceNews, productActivityNewsUse allSignals to retrieve every available company signal type in one call.

string

Limit results to signals detected on or after this date, in YYYY-MM-DD format.Example: "2025-01-01"

integer

Maximum number of signal instances to return per signal type per company. Range: 1–100.Example: 10

Example request

curl --request POST \
  --url https://api.lusha.com/v3/companies/signals \
  --header 'api_key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "ids": ["16303253"],
    "signalTypes": ["allSignals"],
    "startDate": "2025-01-01",
    "maxResultsPerSignal": 10
  }'

{
  "ids": ["16303253"],
  "signalTypes": ["allSignals"],
  "startDate": "2025-01-01",
  "maxResultsPerSignal": 10
}

Response

200 - Success

object[]

One entry per requested company ID.

Show properties

string

The Lusha company ID this entry corresponds to. Example: "16303253"

string

Company name. Example: "Lusha"

string

Company domain. Example: "lusha.com"

Beyond id, companyName, and domain, each result also carries one array per signal type that matched - keyed by the signalTypes value you requested (for example surgeInHiring, financialEventsNews), the same keying pattern the contact signals response uses for promotion and companyChange.

string

The start date used for this request.

string

The end date used for this request (the request date, unless you’re querying historical data).

object

Credit usage summary for this request.

Show properties

integer

Credits charged for this request. Example: 3

integer

Number of results returned. Example: 1

Billing: Charged per matched signal per result via the showSignalsCompany action.

{
  "results": [
    {
      "id": "16303253",
      "companyName": "Lusha",
      "domain": "lusha.com"
    }
  ],
  "startDate": "2025-01-01",
  "endDate": "2025-07-31",
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}

Error codes

Status	Meaning
`400`	Bad request - invalid input data.
`401`	Unauthorized - your API key is missing or invalid.
`402`	Payment required - insufficient credits.
`403`	Forbidden - account inactive or V3 access not enabled.
`429`	Too many requests - you have exceeded the rate limit.

Signals overview - the consolidated signals model, credits, and delivery options
Get Company Signal Types - the current list of valid signalTypes values
Get Company Signal Filters - discover which signal filter types are available
Contact Signals - the equivalent endpoint for contacts

Authorizations

api_key

string

header

required

Your Lusha API key. You can find this in your Lusha dashboard under API settings. Include this key in the api_key header for all requests.

Body

application/json

ids

string[]

required

Required array length: 1 - 100 elements

Example:

["16303253"]

signalTypes

enum<string>[]

required

Available options:

allSignals,

linkedinActivityIntent,

websiteTrafficDecrease,

websiteTrafficIncrease,

itSpendIncrease,

itSpendDecrease,

surgeInHiring,

headcountIncrease1m,

headcountIncrease3m,

headcountIncrease6m,

headcountIncrease12m,

headcountDecrease1m,

headcountDecrease3m,

headcountDecrease6m,

headcountDecrease12m,

surgeInHiringByDepartment,

surgeInHiringByLocation,

riskNews,

commercialActivityNews,

corporateStrategyNews,

financialEventsNews,

peopleNews,

marketIntelligenceNews,

productActivityNews

Example:

["allSignals"]

startDate

string<date>

For linkedinActivityIntent, results are limited to a trailing 90-day window regardless of the value passed (legal requirement). Other signal types are unaffected.

Example:

"2025-01-01"

maxResultsPerSignal

integer

For linkedinActivityIntent, results are capped at 50 per company regardless of the value passed. Other signal types use the requested value as-is (1-100).

Required range: 1 <= x <= 100

Example:

10

tableId

string

Optional. If provided, these companies are also added to this table (if not already present) and the Signals column is populated. See the Tables API.

Example:

"583021"

filters

object

Show child attributes

Response

Successful response

results

object[]

Show child attributes

startDate

string

endDate

string

tableWrite

object

Added to a Prospecting, Enrich, Signals, or Lookalike response when tableId is passed on the request. The primary response is unaffected even if the table write fails.

Show child attributes

billing

object

Credit usage summary for a V3 API request

Show child attributes

⌘I

Company Signals

curl --request POST \
  --url https://api.lusha.com/v3/companies/signals \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "ids": [
    "16303253"
  ],
  "signalTypes": [
    "allSignals"
  ],
  "startDate": "2025-01-01",
  "maxResultsPerSignal": 10
}
'

import requests

url = "https://api.lusha.com/v3/companies/signals"

payload = {
    "ids": ["16303253"],
    "signalTypes": ["allSignals"],
    "startDate": "2025-01-01",
    "maxResultsPerSignal": 10
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    ids: ['16303253'],
    signalTypes: ['allSignals'],
    startDate: '2025-01-01',
    maxResultsPerSignal: 10
  })
};

fetch('https://api.lusha.com/v3/companies/signals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

HttpResponse<String> response = Unirest.post("https://api.lusha.com/v3/companies/signals")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ids\": [\n    \"16303253\"\n  ],\n  \"signalTypes\": [\n    \"allSignals\"\n  ],\n  \"startDate\": \"2025-01-01\",\n  \"maxResultsPerSignal\": 10\n}")
  .asString();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lusha.com/v3/companies/signals"

	payload := strings.NewReader("{\n  \"ids\": [\n    \"16303253\"\n  ],\n  \"signalTypes\": [\n    \"allSignals\"\n  ],\n  \"startDate\": \"2025-01-01\",\n  \"maxResultsPerSignal\": 10\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "results": [
    {
      "id": "16303253",
      "companyName": "Lusha",
      "domain": "lusha.com"
    }
  ],
  "startDate": "2025-01-01",
  "endDate": "2025-07-31",
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}

Overview

Resources

Endpoints

Endpoint

Request body

Example request

Response

200 - Success

Error codes

Authorizations

Body

Response

​Endpoint

​Request body

​Example request

​Response

​200 - Success

​Error codes

​Related pages

Authorizations

Body

Response

Endpoint

Request body

Example request

Response

200 - Success

Error codes

Related pages