# Data Catalog

This catalog provides a comprehensive overview of the available data fields in the Lusha API. Each section represents a specific capability, with detailed information about data fields, their purpose, structure, and accessibility.

For each field, you'll find:

- **Field Name** – the user-friendly label
- **API Path** – the exact path in the API response
- **Description** – explanation of the field's meaning and context
- **Data Type** – the data format (String, Integer, Boolean, Array, Object)


## Enrichment

Add missing contact and company data

| CAPABILITY | PERSON ENRICHMENT | BULK PERSON ENRICHMENT | COMPANY ENRICHMENT | BULK COMPANY ENRICHMENT |
|  --- | --- | --- | --- | --- |
| **Endpoint** | `GET /v2/person` | `POST /v2/person` | `GET /v2/company` | `POST /v2/company` |
| **Description** | Enrich individual contacts with verified data | Enrich up to 100 contacts in one request | Enrich individual companies with firmographic data | Enrich up to 100 companies in one request |
| **Inputs** | Email, LinkedIn URL, or Name + Company | Array of contact objects | Domain, Company name, or Company ID | Array of company objects (domain, name, or ID) |
| **Outputs** | Contact profile, verified email/phone, job details, social profiles | Batch contact data, company info per contact, structured profiles | Company profile, firmographics, technographics, employee counts | Batch company data, firmographics per company, technology stack, industry data |
| **Best for** | Form enrichment, real-time lookups, CRM completion, webhook enrichment | Bulk CRM enrichment, data cleanup, backfills | ABM, single account enrichment, real-time lookups | Bulk account enrichment, territory planning, market analysis |


Rate limit: 25 req/sec per endpoint

## Prospecting

Search for new contacts and companies matching your ICP

| CAPABILITY | CONTACT SEARCH | CONTACT ENRICH | COMPANY SEARCH | COMPANY ENRICH |
|  --- | --- | --- | --- | --- |
| **Endpoint** | `POST /prospecting/contact/search` | `POST /prospecting/contact/enrich` | `POST /prospecting/company/search` | `POST /prospecting/company/enrich` |
| **Description** | Find contacts matching your ICP criteria | Get full details from contact search results | Find companies matching your criteria | Get full details from search results |
| **Inputs** | Filters (title, seniority, location, signals), company filters, signal filters | Contact IDs + requestId from search, optional revealEmails/revealPhones | Filters (industry, size, location, signals), intent topics, technologies | Company IDs + requestId from search |
| **Outputs** | Contact IDs, preview data, match count, requestId | Full profiles, verified data points, company details, credit charged | Company IDs, preview data, match count, requestId | Full company profiles, firmographics, tech stack, credit charged |
| **Best for** | Prospect lists, ICP-based workflows, lead gen | Selective enrichment, credit optimization | Market analysis, account discovery, TAM expansion | Firmographics after search, account list building |


**Typical workflow:** Search → Review preview data → Enrich selected results

## Signals

Track professional changes and business events

| CAPABILITY | CONTACT SIGNALS BY ID | CONTACT SIGNALS SEARCH | COMPANY SIGNALS BY ID | COMPANY SIGNALS SEARCH |
|  --- | --- | --- | --- | --- |
| **Endpoint** | `POST /api/signals/contacts` | `POST /api/signals/contacts/search` | `POST /api/signals/companies` | `POST /api/signals/companies/search` |
| **Description** | Track professional changes for known contacts | Find and enrich contacts with change signals | Monitor company growth and hiring signals | Find and enrich companies with business signals |
| **Inputs** | Contact IDs, signal types, start date | Email/LinkedIn/Name + Company, signal types, date range | Company IDs, signal types, start date | Domain/Company name, signal types, date range |
| **Outputs** | Promotions, job changes, company moves, timestamps | Contact data + signals, transitions, credit charged | Headcount growth, job postings, new hires, velocity | Company data + signals, growth indicators, credit charged |
| **Best for** | Champion tracking, renewal risk alerts, monitoring | Trigger-based outreach, warm intros | Expansion signals, hiring intent tracking | Finding high-intent accounts, timed campaigns |


**Default behavior:** If no `startDate` is specified, signals return the last 6 months.

## Lookalikes

Find similar contacts and companies based on your best customers

| CAPABILITY | CONTACT LOOKALIKE | COMPANY LOOKALIKE |
|  --- | --- | --- |
| **Endpoint** | `POST /api/recommendations/contacts` | `POST /api/recommendations/companies` |
| **Description** | Find contacts similar to your best performers | Find companies similar to your best accounts |
| **Inputs** | Reference contact IDs or profile attributes | Reference company IDs or firmographic criteria |
| **Outputs** | Similar contacts with similarity scores, matched attributes | Similar companies with similarity scores, matched attributes |
| **Best for** | Expanding into new personas, finding more champions | TAM expansion, new market entry, account-based targeting |


# Data Points Reference

Complete field-by-field breakdown of API responses organized by endpoint.

style

.details-box {
  background-color: transparent;
  border: none;
  margin: 12px 0;
}

.details-box > details > summary {
  list-style: none;
  cursor: pointer;
  display: flex;
  align-items: center;
  gap: 8px;
  font-weight: bold;
  padding: 12px;
  background-color: transparent;
  border: 1px solid #e0e0e0;
  border-radius: 8px 8px 0 0;
}

.details-box > details > summary::-webkit-details-marker {
  display: none;
}

.details-box > details > summary::before {
  content: "▶";
  display: inline-block;
  transition: transform 0.2s;
  font-size: 12px;
}

.details-box > details[open] > summary::before {
  transform: rotate(90deg);
}

.details-box > details[open] > summary {
  border-radius: 8px 8px 0 0;
  border-bottom: 1px solid #e0e0e0;
}


.details-box > details[open] {
  background-color: transparent;
  border: 1px solid #e0e0e0;
  border-top: none;
  border-radius: 0 0 8px 8px;
  padding: 12px;
  margin: 0;
  display: block;
}

.details-box > details > .inner-box {
  background-color: transparent;
  border: 1px solid #e0e0e0;
  border-radius: 4px;
  padding: 0;
  margin: 0;
  display: block;
}

.details-box > details > .inner-box > details[open] {
  padding: 16px 20px;
}

.details-box > details > .inner-box > details {
  border-bottom: 1px solid #e0e0e0;
  margin: 0;
  background-color: transparent;
}

.details-box > details > .inner-box > details:last-child {
  border-bottom: none;
}

.details-box > details > .inner-box > details > summary {
  background-color: transparent;
  border: none;
  border-bottom: 1px solid #e0e0e0;
  padding: 12px;
  margin: 0;
  display: flex;
  align-items: center;
  gap: 8px;
  font-weight: normal;
  border-radius: 0;
  list-style: none;
}

.details-box > details > .inner-box > details > summary::-webkit-details-marker {
  display: none;
}

.details-box > details > .inner-box > details > summary::before {
  content: "▶";
  display: inline-block;
  font-size: 12px;
  transition: transform 0.2s;
}

.details-box > details > .inner-box > details[open] > summary::before {
  transform: rotate(90deg);
}


div
details
summary
strong
Contacts
div
details
summary
Enrichment
Returns comprehensive contact and company data for a single person lookup.

**Enrichment Metadata**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Error | `contact.error` | Returns error details if the request failed; null if successful | Object |
| Credit Charged | `contact.isCreditCharged` | Boolean indicating if a Lusha credit was consumed | Boolean |


**Contact Personal Identity**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Person ID | `data.personId` | Lusha's unique internal identifier for the individual | Integer |
| First Name | `data.firstName` | The contact's first name | String |
| Last Name | `data.lastName` | The contact's last name | String |
| Full Name | `data.fullName` | The concatenated first and last name | String |
| Contact Tags | `data.contactTags[]` | Custom labels (e.g., "Decision maker", "Opportunity") with id, name, color | Array [Object] |
| LinkedIn | `data.socialLinks.linkedin` | Validated URL for the contact's LinkedIn profile | URL |


**Contact Information**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Email | `data.emailAddresses[].email` | The verified email address | String |
| Email Type | `data.emailAddresses[].emailType` | Classification (e.g., work, personal) | String |
| Email Update Date | `data.emailAddresses[].updateDate` | The date this specific email was last verified | Date |
| Email Confidence | `data.emailAddresses[].emailConfidence` | Confidence score for deliverability (e.g., A+) | String |
| Phone Number | `data.phoneNumbers[].number` | Phone number in international format | String |
| Phone Type | `data.phoneNumbers[].phoneType` | Classification (e.g., mobile, direct, office) | String |
| Do Not Call | `data.phoneNumbers[].doNotCall` | Boolean flag for DNC (Do Not Call) registry status | Boolean |
| Phone Update Date | `data.phoneNumbers[].updateDate` | The date this specific phone was last verified | Date |


**Contact Location**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Continent | `data.location.continent` | Continent name of the contact | String |
| Country | `data.location.country` | Country name of the contact | String |
| Country ISO2 | `data.location.country_iso2` | Two-letter ISO country code | String |
| City | `data.location.city` | City name | String |
| City ID | `data.location.city_id` | Lusha internal city identifier | Integer |
| EU Contact | `data.location.is_eu_contact` | Boolean indicating if the contact is in the European Union | Boolean |
| Coordinates | `data.location.location_coordinates` | Array [Longitude, Latitude] for the contact | Array [Float] |


**Current Professional Data**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Job Title | `data.jobTitle.title` | The full, raw job title string | String |
| Seniority | `data.jobTitle.seniority` | Standardized seniority (e.g., Vice President, Manager) | String |
| Departments | `data.jobTitle.departments` | Array of functional business units (e.g., General Management) | Array |
| Job Start Date | `data.jobStartDate` | The date the contact started their current role | Date |
| Update Date | `data.updateDate` | The last time the contact record was updated | Date |


**Career History**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Previous Company | `previousJob.company.name` | Name of the previous employer organization | String |
| Previous Domain | `previousJob.company.domain` | The web domain of the previous employer | String |
| Previous Title | `previousJob.jobTitle.title` | The title held at the previous company | String |
| Previous Seniority | `previousJob.jobTitle.seniority` | The seniority level of the previous role | String |


**Company Firmographics**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Company ID | `company.companyId` | Lusha's unique global identifier for the account | Integer |
| Company Name | `company.name` | The full legal or trade name of the company | String |
| Description | `company.description` | A summary of the company's business and value prop | String |
| Homepage URL | `company.homepageUrl` | Primary website URL | URL |
| FQDN | `company.fqdn` | Fully Qualified Domain Name | String |
| Homepage Domain | `company.domains.homepage` | Root domain for the website | String |
| Email Domain | `company.domains.email` | Root domain for email server | String |
| Company Size | `company.companySize` | Array [Min, Max] of employee count | Array [Integer] |
| Revenue Range | `company.revenueRange` | Array [Min, Max] of annual revenue (e.g., [1B, 10B]) | Array [Integer] |
| Logo URL | `company.logoUrl` | URL for the organization's logo image | URL |
| Main Industry | `company.mainIndustry` | The primary industry vertical | String |
| Sub Industry | `company.subIndustry` | Granular industry niche | String |


**Company Industry Codes**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| SIC Codes | `company.industryPrimaryGroupDetails.sics[]` | Standardized SIC codes and their descriptions | Array [Object] |
| NAICS Codes | `company.industryPrimaryGroupDetails.naics[]` | Standardized NAICS codes and their descriptions | Array [Object] |


**Company Location**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Continent | `company.location.continent` | Continent of the company HQ | String |
| Country | `company.location.country` | Country of the company HQ | String |
| State | `company.location.state` | State name for the HQ | String |
| State Code | `company.location.stateCode` | Two-letter state code | String |
| City | `company.location.city` | HQ City | String |
| Raw Location | `company.location.rawLocation` | Full unformatted address string | String |
| Coordinates | `company.location.locationCoordinates` | Array [Longitude, Latitude] for the company HQ | Array [Float] |


**Company Socials**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| LinkedIn | `company.social.linkedin` | Company LinkedIn profile URL | URL |
| Crunchbase | `company.social.crunchbase` | Company Crunchbase profile URL | URL |


**Company Funding**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Total Rounds | `company.funding.totalRounds` | Total number of funding events | Integer |
| Total Amount | `company.funding.totalRoundsAmount` | Total capital raised (Sum of all rounds) | Integer |
| Currency | `company.funding.currency` | Currency code used for funding (e.g., USD) | String |
| Last Round Type | `company.funding.lastRoundType` | E.g., Private Equity Round, Series C | String |
| Last Round Amount | `company.funding.lastRoundAmount` | Capital raised in the most recent round | Integer |
| Last Round Date | `company.funding.lastRoundDate` | Date of the most recent funding event | String |
| Is IPO | `company.funding.isIpo` | Boolean: True if the company is public | Boolean |
| Funding Rounds | `company.funding.rounds[]` | Detailed historical funding round data (roundAmount, roundType, roundDate) | Array [Object] |


**Technographics & Intent**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Technologies | `company.technologies[].name` | Software/tools detected in the company's stack | Array [Object] |
| Intent Topic Count | `company.intent.topicCount` | Total number of active intent topics | Integer |
| Detected Topics | `company.intent.detectedTopics[]` | Specific topics of research interest and their scores/trends (topicName, metadata) | Array [Object] |


details
summary
Prospecting Search
Returns a list of contacts matching your search criteria with preview data and availability indicators.

**Search Metadata**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Request ID | `requestId` | Unique ID assigned to the specific search query session | String |
| Current Page | `currentPage` | The current page index of the results set | Integer |
| Page Length | `pageLength` | Number of results returned per page (e.g., 50) | Integer |
| Total Results | `totalResults` | Total number of contacts found matching the search criteria | Integer |


**Contact Identity**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Name | `data[].name` | The full name of the contact | String |
| Contact ID | `data[].contactId` | Lusha's unique internal UUID for the contact record | String (UUID) |
| Person ID | `data[].personId` | Numerical identifier for the contact | Integer |


**Contact Job Data**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Job Title | `data[].jobTitle` | The raw professional title of the contact | String |


**Company Information**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Company ID | `data[].companyId` | Lusha's unique global identifier for the company | Integer |
| Company Name | `data[].companyName` | Legal or trade name of the employer | String |
| FQDN | `data[].fqdn` | Fully Qualified Domain Name of the company website | String |
| Description | `data[].companyDescription` | Brief textual bio of the organization | String |
| Logo URL | `data[].logoUrl` | CDN link to the company's brand logo | URL |


**Data Availability Indicators**

Use these boolean flags to understand what data is available before enrichment.

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Is Shown | `data[].isShown` | Boolean indicating if this record is currently visible/accessible | Boolean |
| Has Department | `data[].hasDepartment` | True if department classification is available | Boolean |
| Has Seniority | `data[].hasSeniority` | True if seniority level data is available | Boolean |
| Has Contact Location | `data[].hasContactLocation` | True if the contact's location is known | Boolean |
| Has Social Link | `data[].hasSocialLink` | True if a LinkedIn or social profile is available | Boolean |


**Email Availability**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Has Emails | `data[].hasEmails` | True if Lusha has at least one email for this contact | Boolean |
| Has Work Email | `data[].hasWorkEmail` | True if a verified corporate email is available | Boolean |
| Has Private Email | `data[].hasPrivateEmail` | True if a personal email address is available | Boolean |


**Phone Availability**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Has Phones | `data[].hasPhones` | True if Lusha has at least one phone number | Boolean |
| Has Mobile Phone | `data[].hasMobilePhone` | True if a direct mobile number is available | Boolean |
| Has Direct Phone | `data[].hasDirectPhone` | True if a direct office/desk line is available | Boolean |


**Company Data Availability**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Has Employees Count | `data[].hasCompanyEmployeesCount` | True if company size data is available | Boolean |
| Has Revenue | `data[].hasCompanyRevenue` | True if estimated revenue data is available | Boolean |
| Has Main Industry | `data[].hasCompanyMainIndustry` | True if high-level industry data is available | Boolean |
| Has Sub Industry | `data[].hasCompanySubIndustry` | True if granular industry data is available | Boolean |
| Has Funding | `data[].hasCompanyFunding` | True if the company has recorded funding rounds | Boolean |
| Has Intent | `data[].hasCompanyIntent` | True if active intent signals are being tracked | Boolean |
| Has Technologies | `data[].hasCompanyTechnologies` | True if tech stack data is available | Boolean |
| Has City | `data[].hasCompanyCity` | True if the HQ city is known | Boolean |
| Has Country | `data[].hasCompanyCountry` | True if the HQ country is known | Boolean |


**Billing Metadata**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Credits Charged | `billing.creditsCharged` | Number of credits deducted for the search request | Integer |
| Results Returned | `billing.resultsReturned` | Number of data objects included in the current response | Integer |


details
summary
Prospecting Enrich
Returns full contact details for selected contacts from search results.

**Request Metadata**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Request ID | `requestId` | Unique ID for the enrichment session | String |
| Credits Charged | `creditsCharged` | Number of credits consumed for this specific enrichment | Integer |


**Status Flags**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Contact ID | `contacts[].id` | The Contact UUID (links back to search results) | String (UUID) |
| Is Success | `contacts[].isSuccess` | Boolean: Indicates if the enrichment was successful | Boolean |
| Error | `contacts[].error` | Error details if isSuccess is false | Object/Null |


**Contact Identity**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Person ID | `data.personId` | Lusha's numerical unique ID for the person | Integer |
| First Name | `data.firstName` | Individual's given name | String |
| Last Name | `data.lastName` | Individual's family name | String |
| Full Name | `data.fullName` | Concatenated name | String |
| Is Shown | `data.isShown` | Boolean indicating if the contact is visible in the UI | Boolean |


**Contact Job Data**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Job Title | `data.jobTitle` | The full raw professional title | String |
| Departments | `data.departments[]` | Array of functional business units (e.g., Engineering) | Array [String] |
| Seniority | `data.seniority[]` | Array of seniority objects containing id and value | Array [Object] |


**Contact Location**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Country | `data.location.country` | Country name for the contact | String |
| Continent | `data.location.continent` | Continent name for the contact | String |


**Contact Information**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Email | `data.emailAddresses[].email` | The revealed email address | String |
| Email Type | `data.emailAddresses[].emailType` | Classification (work/personal) | String |
| Email Confidence | `data.emailAddresses[].emailConfidence` | Deliverability grade | String |
| Email Update Date | `data.emailAddresses[].updateDate` | ISO Timestamp of the last email verification | DateTime |
| Phone Number | `data.phoneNumbers[].number` | Revealed phone string | String |
| Phone Type | `data.phoneNumbers[].phoneType` | Phone classification | String |
| LinkedIn | `data.socialLinks.linkedin` | The contact's LinkedIn profile URL | URL |


**Company Information**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Company ID | `data.companyId` | Global ID of the organization | Integer |
| Company Name | `data.companyName` | Legal name of the organization | String |
| FQDN | `data.company.fqdn` | Fully Qualified Domain Name | String |
| Description | `data.company.description` | Company bio | String |
| Logo URL | `data.company.logoUrl` | Brand logo URL | URL |
| Employees | `data.company.employees` | String representation of headcount (e.g., "100-500") | String |
| Revenue Range | `data.company.revenueRange` | Array [Min, Max] of estimated annual revenue | Array [Integer] |
| Main Industry | `data.company.mainIndustry` | High-level industry sector | String |
| Sub Industry | `data.company.subIndustry` | Granular industry vertical | String |


**Company Location**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| City | `data.company.location.city` | HQ City | String |
| State | `data.company.location.state` | HQ State name | String |
| State Code | `data.company.location.state_code` | 2-letter state code | String |
| Country | `data.company.location.country` | HQ Country name | String |
| Country ISO2 | `data.company.location.country_iso2` | ISO country code | String |
| Raw Location | `data.company.location.raw_location` | Full unformatted HQ address string | String |
| Coordinates | `data.company.location.location_coordinates` | HQ [Longitude, Latitude] array | Array [Float] |


**Company Socials**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| LinkedIn | `data.company.linkedin` | Official company LinkedIn page | URL |
| Crunchbase | `data.company.crunchbase` | Company Crunchbase profile | URL |


details
summary
Signals
Returns professional change signals (promotions, job changes) for tracked contacts.

**Usage Metadata**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Start Date | `startDate` | The beginning of the signal tracking window | Date (YYYY-MM-DD) |
| End Date | `endDate` | The end of the signal tracking window | Date (YYYY-MM-DD) |
| Credit Charged | `creditCharged` | Total credits consumed for this batch retrieval | Integer |


**Contact ID Key**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Person ID | `contacts.{id}.personId` | The unique Lusha identifier for the contact | Integer/String |


**Company Change Signal**

Triggered when a contact moves to a new organization.

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Person ID | `contacts.{id}.companyChange[].personId` | Person identifier within the signal object | Integer/String |
| Current Company ID | `contacts.{id}.companyChange[].currentCompanyId` | Lusha ID of the new organization | Integer |
| Current Company Name | `contacts.{id}.companyChange[].currentCompanyName` | Name of the organization the person joined | String |
| Current Domain | `contacts.{id}.companyChange[].currentDomain` | Web domain of the new organization | String |
| Current Title | `contacts.{id}.companyChange[].currentTitle` | The person's new job title | String |
| Current Seniority | `contacts.{id}.companyChange[].currentSeniorityLabel` | Standardized seniority level (e.g., "c-suite", "director") | String |
| Current Departments | `contacts.{id}.companyChange[].currentDepartments` | Functional business unit(s) for the new role | Array [Object/String] |
| Previous Company Name | `contacts.{id}.companyChange[].previousCompanyName` | Name of the employer the person recently left | String |
| Previous Domain | `contacts.{id}.companyChange[].previousDomain` | Web domain of the previous employer | String |
| Signal Date | `contacts.{id}.companyChange[].signalDate` | Date the change was detected or became effective | Date (YYYY-MM-DD) |


**Promotion Signal**

Triggered when a contact is promoted within their organization.

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Current Company ID | `contacts.{id}.promotion[].currentCompanyId` | Lusha ID of the organization where the promotion occurred | Integer |
| Current Company Name | `contacts.{id}.promotion[].currentCompanyName` | Name of the organization where the promotion occurred | String |
| Current Domain | `contacts.{id}.promotion[].currentDomain` | Web domain of the organization | String |
| Current Title | `contacts.{id}.promotion[].currentTitle` | The contact's new, higher-level title | String |
| Current Seniority | `contacts.{id}.promotion[].currentSeniorityLabel` | Updated standardized seniority level | String |
| Current Departments | `contacts.{id}.promotion[].currentDepartments` | Functional business unit(s) for the promoted role | Array [Object/String] |
| Signal Date | `contacts.{id}.promotion[].signalDate` | Date the promotion was detected | Date (YYYY-MM-DD) |


details
summary
Lookalikes
Returns contacts similar to your reference contacts based on professional attributes.

**Search Metadata**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Request ID | `requestId` | Unique session identifier for the lookalike query | String |
| Count | `count` | Total number of lookalike contacts returned in the response | Integer |
| Credits Charged | `creditsCharged` | Number of credits consumed to generate the lookalike list | Integer |


**Contact Details**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Person ID | `contacts[].personId` | Lusha's numerical unique identifier for the lookalike contact | String/Integer |
| Name | `contacts[].name` | Full name of the lookalike contact | String |
| Job Title | `contacts[].jobTitle` | The raw professional title of the lookalike contact | String |
| Company ID | `contacts[].companyId` | Lusha's unique global identifier for the lookalike's organization | String/Integer |
| Company Name | `contacts[].companyName` | The full name of the organization where the lookalike works | String |


div
details
summary
strong
Companies
div
details
summary
Enrichment
Returns comprehensive company data including firmographics, funding, and intent signals.

**Platform IDs**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| LinkedIn Company ID | `id` | Permanent unique identifier for the company on LinkedIn | Integer |
| Lusha Company ID | `lushaCompanyId` | Lusha's unique internal global identifier for the organization | String |


**Firmographics**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Name | `name` | Legal or common trade name of the company | String |
| FQDN | `fqdn` | Fully Qualified Domain Name (e.g., www.citigroup.com) | String |
| Founded | `founded` | The year the organization was established | String |
| Description | `description` | Comprehensive textual bio or mission statement | String |
| Logo URL | `logoUrl` | CDN link to the company's brand logo image | URL |


**Size & Revenue**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Company Size | `companySize` | Array containing [Min, Max] employee count range | Array [Integer] |
| Revenue Range | `revenueRange` | Array containing [Min, Max] annual revenue range | Array [Integer] |


**Industry & Focus**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Main Industry | `mainIndustry` | High-level industry sector (e.g., Finance, Technology) | String |
| Sub Industry | `subIndustry` | Granular industry niche (e.g., Software Development) | String |
| Specialities | `specialities` | Array of keywords defining core business activities | Array [String] |


**Industry Codes**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| SIC Code | `industryPrimaryGroupDetails.sics[].sic` | SIC code | Integer |
| SIC Description | `industryPrimaryGroupDetails.sics[].description` | Human-readable SIC description | String |
| NAICS Code | `industryPrimaryGroupDetails.naics[].naics` | NAICS code | Integer |
| NAICS Description | `industryPrimaryGroupDetails.naics[].description` | Human-readable NAICS description | String |


**Location**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| City | `city` | HQ City | String |
| State | `state` | HQ State/Province name | String |
| Country | `country` | Full country name | String |
| Country ISO2 | `countryIso2` | Two-letter ISO country code | String |
| Continent | `continent` | Continent of the organization's HQ | String |
| Raw Location | `rawLocation` | Full unformatted address string | String |


**Social Links**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| LinkedIn | `linkedin` | URL for the company's official LinkedIn page | URL |
| Crunchbase | `crunchbase` | URL for the company's Crunchbase profile | URL |


**Funding**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Total Rounds | `funding.totalRounds` | Count of unique funding events | Integer |
| Total Amount | `funding.totalRoundsAmount` | Cumulative capital raised across all historical rounds | Integer |
| Currency | `funding.currency` | Normalized currency for totals (usually USD) | String |
| Is IPO | `funding.isIpo` | Boolean: True if the company is publicly traded | Boolean |
| Last Round Type | `funding.lastRoundType` | Type of most recent event (e.g., Post-IPO Debt) | String |
| Last Round Amount | `funding.lastRoundAmount` | Capital raised in the most recent event | Integer |
| Last Round Date | `funding.lastRoundDate` | Date of the most recent funding event | String |
| Round Currency | `funding.rounds[].currency` | Specific currency for a historical round | String |
| Round Amount | `funding.rounds[].roundAmount` | Amount for a historical round | Integer |
| Round Type | `funding.rounds[].roundType` | Classification for a historical round | String |
| Round Date | `funding.rounds[].roundDate` | Date for a historical round | String |


**Intent Data**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Topic Count | `intent.topicCount` | Number of topics showing active research interest | Integer |
| Topic Name | `intent.detectedTopics[].topicName` | Specific topic name (e.g., Sales Intelligence) | String |
| Topic Score | `intent.detectedTopics[].topicScore` | Strength of the intent signal (0-100) | Integer |
| Topic Trend | `intent.detectedTopics[].topicTrend` | Trend velocity (e.g., "+17", "New", "-8") | String |


details
summary
Prospecting Search
Returns a list of companies matching your search criteria with preview data.

**Search Metadata**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Request ID | `requestId` | Unique session identifier for the specific query | String |
| Current Page | `currentPage` | The current page number in the paginated results | Integer |
| Page Length | `pageLength` | The number of results returned per page | Integer |
| Total Results | `totalResults` | Total number of companies matching the search criteria | Integer |


**Company Identity**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| ID | `data[].id` | LinkedIn Company ID, permanent unique identifier | String/Integer |
| Name | `data[].name` | The full legal or common name of the company | String |
| FQDN | `data[].fqdn` | Fully Qualified Domain Name, e.g. www.oatey.com | String |
| Description | `data[].description` | A textual overview of the company's business and mission | String |
| Logo URL | `data[].logoUrl` | Public URL for the company's logo asset | URL |


**Data Availability Flags**

Use these boolean flags to understand what data is available before enrichment.

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Has Employees Count | `data[].hasCompanyEmployeesCount` | True if headcount range data is available | Boolean |
| Has Revenue | `data[].hasCompanyRevenue` | True if annual revenue data is available | Boolean |
| Has Main Industry | `data[].hasCompanyMainIndustry` | True if the primary industry sector is identified | Boolean |
| Has Sub Industry | `data[].hasCompanySubIndustry` | True if the granular industry niche is identified | Boolean |
| Has Funding | `data[].hasCompanyFunding` | True if the company has recorded funding rounds | Boolean |
| Has Intent | `data[].hasCompanyIntent` | True if active intent topics are being tracked | Boolean |
| Has Technologies | `data[].hasCompanyTechnologies` | True if tech stack or technography data is available | Boolean |
| Has City | `data[].hasCompanyCity` | True if the HQ city location is available | Boolean |
| Has Country | `data[].hasCompanyCountry` | True if the HQ country location is available | Boolean |


details
summary
Prospecting Enrich
Returns full company details for selected companies from search results.

**Search Metadata**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Request ID | `requestId` | Unique ID for the enrichment session | String |


**Company Identity**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| ID | `companies[].id` | LinkedIn Company ID, unique identifier on the LinkedIn platform | Integer |
| Name | `companies[].name` | The full legal or common name of the company | String |
| FQDN | `companies[].fqdn` | Fully Qualified Domain Name, e.g. www.jameshardie.com | String |
| Description | `companies[].description` | Comprehensive textual bio or mission statement | String |
| Founded | `companies[].founded` | The year the organization was established | Integer |
| Logo URL | `companies[].logoUrl` | CDN link to the company's brand logo image | URL |


**Web Domains**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Homepage Domain | `companies[].domains.homepage` | Root domain for the corporate website | String |
| Email Domain | `companies[].domains.email` | Primary domain used for corporate email addresses | String |


**Size & Revenue**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Size Min | `companies[].companySize.min` | Lower bound of employee headcount | Integer |
| Size Max | `companies[].companySize.max` | Upper bound of employee headcount | Integer |
| LinkedIn Employees | `companies[].companySize.employees_in_linkedin` | Actual count of employees identified on LinkedIn | Integer |
| Employees | `companies[].employees` | Formatted string of the headcount range, e.g. "5001 - 10000" | String |
| Revenue Range | `companies[].revenueRange` | Estimated annual revenue range as [Min, Max] | Array [Integer] |


**Industry & Focus**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Main Industry | `companies[].mainIndustry` | High-level industry sector | String |
| Sub Industry | `companies[].subIndustry` | Granular industry niche | String |
| Specialities | `companies[].specialities` | Keywords defining core business activities | Array [String] |


**Industry Codes**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| SIC Code | `industryPrimaryGroupDetails.sics[].sic` | SIC code | Integer |
| SIC Description | `industryPrimaryGroupDetails.sics[].description` | Human-readable SIC description | String |
| NAICS Code | `industryPrimaryGroupDetails.naics[].naics` | NAICS code | Integer |
| NAICS Description | `industryPrimaryGroupDetails.naics[].description` | Human-readable NAICS description | String |


**HQ Location**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| City | `companies[].city` | HQ city | String |
| State | `companies[].state` | HQ state name | String |
| State Code | `companies[].stateCode` | Two-letter state or province code, e.g. IL | String |
| Country | `companies[].country` | Full country name | String |
| Country ISO2 | `companies[].countryIso2` | Two-letter ISO code | String |
| Continent | `companies[].continent` | Continent of the organization's HQ | String |
| Raw Location | `companies[].rawLocation` | Full unformatted address string | String |
| Coordinates | `companies[].coordinates` | HQ coordinates as [Longitude, Latitude] | Array [Float] |


**Social Links**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| LinkedIn | `companies[].social.linkedin` | URL for the company's official LinkedIn page | URL |
| Crunchbase | `companies[].social.crunchbase` | URL for the company's Crunchbase profile | URL |


**Intent Data**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Topic Count | `intent.topicCount` | Number of topics currently showing research interest | Integer |
| Topic Name | `intent.detectedTopics[].topicName` | Specific topic name, e.g. Sales Intelligence Platform | String |
| Topic Score | `intent.detectedTopics[].metadata.topicScore` | Strength of the intent signal from 0 to 100 | Integer |
| Topic Trend | `intent.detectedTopics[].metadata.topicTrend` | Trend velocity, e.g. "New", "-13" | String |


details
summary
Signals
Returns business change signals (headcount growth, job postings, news events) for tracked companies.

**Usage Metadata**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Start Date | `startDate` | The start of the timeframe tracked for these signals | Date |
| End Date | `endDate` | The end of the timeframe tracked for these signals | Date |
| Credit Charged | `creditCharged` | Total credits consumed for this request | Integer |


**Base Company Data**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Company ID | `companies.{id}.companyId` | Lusha's unique numerical ID for the organization | String |
| Company Name | `companies.{id}.companyName` | The full legal or common name of the company | String |
| Domain | `companies.{id}.domain` | The primary web domain of the organization | String |


**Job Posting Signal**

Triggered when there's significant change in hiring activity.

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Signal Type | `newJobsOpen[].signalType` | Always "new_jobs_count" | String |
| Score | `newJobsOpen[].score` | Intensity of hiring activity (low, medium, high) | String |
| Signal Date | `newJobsOpen[].signalDate` | The date the job count change was recorded | Date |
| New Value | `newJobsOpen[].newValue` | Current number of active job openings | Integer |
| Old Value | `newJobsOpen[].oldValue` | Previous number of active job openings | Integer |
| Historical Avg | `newJobsOpen[].historicalAvg` | The baseline average job count for this company | Float |


**Headcount Growth Signal**

Triggered when a company's employee count changes significantly.

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Signal Type | `headcountGrowth[].signalType` | The type of growth detected (e.g., size_increase) | String |
| New Bucket | `headcountGrowth[].newBucket` | The updated employee size range (e.g., "201-500") | String |
| Old Bucket | `headcountGrowth[].oldBucket` | The previous employee size range (e.g., "1-10") | String |


**News Event Signal**

Triggered when significant company news is detected.

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Event Type | `newsEvent[].eventType` | Granular event type (e.g., product launch, partnership) | String |
| Event Category | `newsEvent[].eventCategory` | Broad business grouping (e.g., Business Milestones) | String |
| Event Summary | `newsEvent[].eventSummary` | A short, AI-generated summary of the event | String |
| Event Effective Date | `newsEvent[].eventEffectiveDate` | The actual date the event took place (if known) | Date/Null |
| Article Title | `newsEvent[].articleTitle` | The headline of the news source | String |
| Article Sentence | `newsEvent[].articleSentence` | A specific quote/snippet from the news article | String |
| Article URL | `newsEvent[].articleUrl` | Direct link to the source news article | URL |
| Article Published Date | `newsEvent[].articlePublishedDate` | The date the article was published | Date |


details
summary
Lookalikes
Returns companies similar to your reference companies based on firmographic attributes.

**Search Metadata**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Request ID | `requestId` | Unique session identifier for the lookalike request | String |
| Count | `count` | Total number of similar companies returned, typically 25 | Integer |
| Credits Charged | `creditsCharged` | Number of credits consumed for this search operation | Integer |


**Company Details**

| Field Name | API Path | Description | Data Type |
|  --- | --- | --- | --- |
| Company ID | `companies[].companyId` | Lusha's unique global identifier for the organization | String |
| Name | `companies[].name` | The full legal or common name of the organization | String |
| FQDN | `companies[].fqdn` | Fully Qualified Domain Name, e.g. www.newsday.com | String |
| Description | `companies[].description` | Textual overview of the company's business model and mission | String |


## Need help?

- [**Full API Reference**](/apis/openapi) – Complete endpoint documentation with examples
- [**Getting Started Guide**](/guides) – Learn how to authenticate and make your first request
- [**Changelog**](/changelog) – Track new endpoints, parameter changes, deprecations
- [**Q&A**](/qa) – FAQs and clarifications