# Lusha Knowledge Hub: API Docs V3 > Access documentation, use cases, and technical guides for Lusha. One destination for data docs, developer APIs, and user guides across the Lusha platform. ## V3 ### Overview - [API overview](https://docs.lusha.com/api-reference/overview.md): Programmatic access to Lusha's B2B contact and company dataset. ### Resources - [API playground](https://docs.lusha.com/playground.md): Test Lusha API endpoints directly in your browser, or import the Postman workspace for a standalone client. - [Changelog](https://docs.lusha.com/changelog/overview.md): All notable changes to the Lusha API and MCP. We follow semantic versioning. #### Getting Started - [Get started with the Lusha API](https://docs.lusha.com/introduction.md): Learn what the Lusha API offers, make your first request to the base URL, and understand how the credit-based billing model works before you build. ##### Overview - [Authenticate with the Lusha API](https://docs.lusha.com/authentication.md): Get your Lusha API key from the API dashboard and pass it in the api_key header on every request. Learn what to expect when authentication fails. - [Rate limits for the Lusha API](https://docs.lusha.com/rate-limiting.md): Understand the request limits for each Lusha API endpoint group and learn how to implement retry logic for 429 Too Many Requests responses. - [Lusha API error codes and responses](https://docs.lusha.com/error-codes.md): Understand the Lusha API's standard error response format, every HTTP status code returned, and practical steps for debugging failed or rejected requests. ##### Credits & Plans - [Unified Credits plan](https://docs.lusha.com/credits/unified-credits.md): What the Unified Credits pricing plan unlocks and how to use plan-exclusive parameters. ##### Search & Enrich - [Enrich contacts and companies with Lusha](https://docs.lusha.com/enrichment/overview.md): Find contacts and companies by identifier, then reveal their full data - or do both in a single call with Search and Enrich. - [Search contacts](https://docs.lusha.com/enrichment/search-contacts.md): Find up to 100 contacts per call by ID, LinkedIn URL, email, or name and company, and see what you can reveal about each match. - [Enrich contacts](https://docs.lusha.com/enrichment/enrich-contacts.md): Reveal emails and phone numbers for up to 100 contacts you've already found via Search Contacts. - [Search and enrich contacts](https://docs.lusha.com/enrichment/search-and-enrich-contacts.md): Find up to 100 contacts by identifier and reveal their emails and phone numbers in a single call. - [Search companies](https://docs.lusha.com/enrichment/search-companies.md): Find up to 100 companies per call by ID, name, or domain, and see what you can reveal about each match. - [Enrich companies](https://docs.lusha.com/enrichment/enrich-companies.md): Reveal firmographics, employee breakdowns, competitors, and buyer intent for up to 100 companies you've already found via Search Companies. - [Search and enrich companies](https://docs.lusha.com/enrichment/search-and-enrich-companies.md): Find up to 100 companies by identifier and reveal their full firmographic data in a single call. ##### Prospecting - [Prospect and build ICP lists with Lusha](https://docs.lusha.com/prospecting/overview.md): Search Lusha's B2B database by ICP filters, then enrich the matching previews to generate net-new contact and company records for your CRM. - [Search prospecting contacts by ICP filters](https://docs.lusha.com/prospecting/search-contacts.md): Query Lusha's contact database by ICP filters - job title, seniority, department, location, and company attributes - to get a paginated list of contact previews. - [Search prospecting companies by firmographic filters](https://docs.lusha.com/prospecting/search-companies.md): Query Lusha's company database using firmographic filters - industry, size, revenue, location, technologies, and more - to get a paginated list of company previews. ##### Signals - [Detect contact and company signals with Lusha](https://docs.lusha.com/signals/overview.md): Use Lusha Signals to detect job changes, promotions, and company events. Integrate signals into your CRM or automation to engage prospects at the right time. - [Retrieve contact signals for job changes and promotions](https://docs.lusha.com/signals/contact-signals.md): Fetch job-change and promotion signals for up to 100 contacts per request using their Lusha contact IDs. - [Retrieve company signals for business events and growth](https://docs.lusha.com/signals/company-signals.md): Fetch hiring surges, headcount changes, website traffic shifts, news events, and intent changes for up to 100 companies per request by Lusha company ID. - [Score contacts and companies by signal activity](https://docs.lusha.com/signals/signal-score.md): Turn active buying signals into a single [0, 1] score per contact or company, with the signal breakdown behind it - up to 100 records per call. ##### ICP Fit Score - [Score contacts and companies against your ICPs](https://docs.lusha.com/icp-fit-score/overview.md): Score how well any list of contacts or companies fits 1-3 of your Target Profiles, from 0 to 1 - up to 100 records per call. ##### Buying Group - [Map the buying committee at target companies](https://docs.lusha.com/buying-group/overview.md): Supply up to 25 companies by domain or ID and get back contacts labelled as decision makers, potential champions, or end users - free to preview and revealed separately via Enrich Contacts. ##### Conversations - [Search sales conversations and fetch transcripts](https://docs.lusha.com/conversations/overview.md): Search the calls recorded by Lusha Conversations for your account - metadata, AI summaries, action items, risks, and coaching analysis - then fetch speaker-attributed transcripts one conversation at a time. ##### Website Visits - [See which companies are visiting your website](https://docs.lusha.com/website-visits/overview.md): Identify companies visiting your tracked domains, ranked by engagement score, sessions, unique visitors, and other behavioral metrics. ##### Webhooks - [Receive real-time signal notifications via webhooks](https://docs.lusha.com/webhooks/overview.md): Push HTTP notifications to your endpoints when contacts or companies trigger signals - promotions, job changes, company events, and more. - [Create and manage Lusha webhook subscriptions](https://docs.lusha.com/webhooks/manage-subscriptions.md): Create, list, update, test, and delete webhook subscriptions to receive real-time signal notifications for contacts and companies. - [Verify Lusha webhook signatures with HMAC-SHA256](https://docs.lusha.com/webhooks/security.md): Authenticate every incoming webhook delivery using HMAC-SHA256 signature verification to prevent spoofed requests reaching your endpoint. - [Monitor webhook delivery with Lusha audit logs](https://docs.lusha.com/webhooks/audit-logs.md): Query webhook delivery logs and stats to track success rates, diagnose failures, investigate retry behavior, and reactivate disabled subscriptions. ##### Lookalikes - [Discover lookalike contacts and companies with AI](https://docs.lusha.com/lookalikes/overview.md): Use AI-powered similarity search to find new prospects that match your best contacts and accounts based on seed data you already own. - [Find similar contacts with POST /v3/contacts/lookalike](https://docs.lusha.com/lookalikes/contact-lookalikes.md): Discover new contacts who match your best prospects by submitting seed contact identifiers, LinkedIn URLs, or emails to the Lusha contact lookalikes endpoint. - [Find similar companies with POST /v3/companies/lookalike](https://docs.lusha.com/lookalikes/company-lookalikes.md): Identify new target accounts that share firmographics with your best customers by submitting seed company domains or LinkedIn URLs to the lookalikes endpoint. ##### Filters Reference - [Available contact filters for prospecting searches](https://docs.lusha.com/filters/contact-filters.md): Discover contact filter types and retrieve their valid values with two generic endpoints, then use them in a Prospecting Contacts search. - [Available company filters for prospecting searches](https://docs.lusha.com/filters/company-filters.md): Discover company filter types and retrieve their valid values with two generic endpoints, then use them in a Prospecting Companies search. ##### Account - [Monitor account usage with GET /v3/account/usage](https://docs.lusha.com/account/usage.md): Get a full snapshot of your account: credit balance, rate limits, plan details, and per-action credit pricing - all in a single call. #### Tutorials - [Tutorials](https://docs.lusha.com/tutorials/index.md): Step-by-step guides for integrating the Lusha API with CRMs, spreadsheets, and automation platforms. ##### Getting Started - [API Fundamentals](https://docs.lusha.com/tutorials/api_fundamentals.md): Lusha provides a RESTful API that allows you to query a comprehensive dataset of business profiles and company information. - [Postman Environment Guide](https://docs.lusha.com/tutorials/postman-environment-guide.md): How to set up Lusha's Postman workspace, configure environment variables, and use the API collection to test Person, Company, and Prospecting endpoints. - [Lusha API V3: Transition and Migration Guide](https://docs.lusha.com/tutorials/v3-migration-guide.md): Lusha API V3 is the most flexible and modular version of the API to date. Built on a composable "building block" architecture, V3 gives you better credit control, stable entity IDs, and cleaner endpoint structure - while keeping the same credit model you already know. ##### CRM Tutorials - [HubSpot Contact Data Enrichment](https://docs.lusha.com/tutorials/hubspot.md): Enrich HubSpot Contact Data with Lusha's API key based on Full Name and Domain parameters without requiring any additional applications or special JSON codes. - [HubSpot + Lusha Prospecting API](https://docs.lusha.com/tutorials/hubspot-prospecting.md): Automated contact enrichment workflow that searches Lusha for target contacts and creates them directly in HubSpot on a recurring schedule. - [Salesforce Lead Enrichment](https://docs.lusha.com/tutorials/salesforce-contact.md): Build a record-triggered Salesforce Flow that automatically enriches every newly created Lead using the Lusha v3 Search & Enrich API. No Apex required. - [Salesforce Company Enrichment](https://docs.lusha.com/tutorials/salesforce-company.md): The integration between Salesforce and Lusha's Company API is a powerful feature designed to enrich account data with accurate, up-to-date company information directly within Salesforce. - [Zoho Contact Data Enrichment](https://docs.lusha.com/tutorials/zoho.md): This guide walks through the process of setting up the automation from Zoho to Lusha's API and ensures contact enrichment happens seamlessly. ##### Spreadsheet Tutorials - [Automate Contact Data Enrichment](https://docs.lusha.com/tutorials/sheets-contact.md): This guide walks you through automating contact enrichment in Google Sheets using the Lusha API. You'll be able to send contact data in bulk, retrieve detailed information, and track the status of each enrichment request in real-time. - [Automate Company Data Enrichment](https://docs.lusha.com/tutorials/sheets-company.md): This guide will help you enrich your company data directly in Google Sheets using the Lusha Company Enrichment API. You'll be able to send requests to Lusha to retrieve detailed company information, automatically update your sheet, and track which companies have been enriched or failed. - [Automate Contact Search and Enrich](https://docs.lusha.com/tutorials/sheets-prospecting-contacts.md): This guide walks you through automating your prospecting process by searching and enriching contact data directly in Google Sheets using the Lusha V3 API. - [Automate Company Search and Enrich](https://docs.lusha.com/tutorials/sheets-prospecting-company.md): This guide will walk you through automating your prospecting process by searching and enriching company data directly in Google Sheets using the Lusha's Prospecting API. ##### Automation Platforms - [Lusha connector on Albato](https://docs.lusha.com/tutorials/albato.md): How to connect Lusha to Albato and build automated workflows for contact and company enrichment. - [Lusha Connect on Make](https://docs.lusha.com/tutorials/make.md): The Lusha Make Connector enables seamless integration of Lusha's enriched contact and company data into your workflows, helping you automate prospecting, lead enrichment, and customer insights. - [Build an Automated Prospecting Workflow with Lusha and Make](https://docs.lusha.com/tutorials/make-prospecting-workflow.md): Find contacts that match your ICP, enrich them with verified emails and phone numbers, and send them straight to Google Sheets automatically. - [Lusha Connector on n8n: Data Enrichment](https://docs.lusha.com/tutorials/n8n.md): Connect Lusha to n8n to automate contact and company enrichment in self-hosted or cloud workflows. - [Lusha Connect on Pipedream](https://docs.lusha.com/tutorials/pipedream.md): The Lusha Pipedream Connector enables seamless integration of Lusha's enriched contact and company data into your workflows, helping you automate prospecting, lead enrichment, and account insights. - [Lusha Workato Connector Guide](https://docs.lusha.com/tutorials/workato1.md): The Lusha Workato Connector enables seamless integration of Lusha's enriched contact and company data into your workflows, helping you automate prospecting, lead enrichment, and customer insights. - [Lusha Connect Prospecting Workflow Guide](https://docs.lusha.com/tutorials/workato2.md): The Lusha Connect connector enables users to access Lusha's Prospecting API directly from within Workato. This article will guide you through the two key actions in the Prospecting workflow: - [Lusha Zapier Connector Guide](https://docs.lusha.com/tutorials/zapier.md): The Lusha Zapier connector enables seamless integration of Lusha's enriched contact and company data into your workflows, helping you automate prospecting, lead enrichment, and customer insights. - [Lusha connector on Clay: Data enrichment](https://docs.lusha.com/tutorials/clay-data.md): How to add Lusha contact, company, and signal enrichments to your Clay tables to automate prospecting workflows. - [Find company and people lookalikes in Clay](https://docs.lusha.com/tutorials/clay-lookalikes.md): How to use Lusha's lookalike feature in Clay to generate lists of companies or people that match your best-fit customers. - [Lusha signals in Clay: identify and prioritise high-intent accounts](https://docs.lusha.com/tutorials/clay-signals.md): How Lusha intent signals work in Clay, what signal types are available, and how to use them to prioritise high-intent accounts. - [Clay: suggested workflow combinations](https://docs.lusha.com/tutorials/clay-workflow.md): How to layer Lusha enrichments and signals in Clay to build account scoring models and identify the best timing for outreach. ##### Signals & Recommendations - [Signals API](https://docs.lusha.com/tutorials/signals.md): Use the Signals API to turn static CRM data into real-time, actionable insights that plug straight into your GTM workflows. - [Recommendations API](https://docs.lusha.com/tutorials/recommendations.md): Send the API a set of existing contacts or companies and get back recommended contacts/companies that match their profile by role, seniority, company type, and more. ##### Tables - [Tables API](https://docs.lusha.com/tutorials/tables.md): Learn how to create, manage, and automate Workspace tables using the Lusha REST API. #### FAQ - [FAQ](https://docs.lusha.com/faq/overview.md): Frequently asked questions about the Lusha API, organized by topic. ##### API & Integration - [Lusha API - Frequently Asked Questions (Q&A)](https://docs.lusha.com/faq/api.md): Answers to common questions about Lusha's API endpoint groups, versioning, authentication, billing, rate limits, and errors. ##### Data & Coverage - [Data & Coverage FAQ](https://docs.lusha.com/faq/data.md): Common questions about Lusha's data sources, coverage, accuracy, and freshness. ##### Credits & Billing - [Credits & Billing FAQ](https://docs.lusha.com/faq/billing.md): Common questions about Lusha credits, plan limits, and billing. ##### MCP - [MCP FAQ](https://docs.lusha.com/faq/mcp.md): Common questions about using Lusha with the Model Context Protocol. ### Endpoints #### Search - [Search Contacts](https://docs.lusha.com/api-reference/search/search-contacts.md): Look up contacts by identifier. Returns a non-PII preview of each profile - no emails or phone numbers. - [Search Companies](https://docs.lusha.com/api-reference/search/search-companies.md): Look up companies by identifier. Returns a preview of each company profile. #### Enrich - [Enrich Contacts](https://docs.lusha.com/api-reference/enrich/enrich-contacts.md): Reveal full contact data for contacts you've already found via Search Contacts. - [Get Contacts Enrich Job](https://docs.lusha.com/api-reference/enrich/get-contacts-enrich-job.md): Poll the async Data Waterfall job returned in the `job` field of [Enrich Contacts](#operation/enrichContacts). No body and no query parameters. - [Enrich Companies](https://docs.lusha.com/api-reference/enrich/enrich-companies.md): Reveal full company data for companies you've already found via Search Companies. #### Search & Enrich - [Search and Enrich Contacts](https://docs.lusha.com/api-reference/search-&-enrich/search-and-enrich-contacts.md): Find contacts and reveal their full data in a single call. Combines Search and Enrich into one request. - [Search and Enrich Companies](https://docs.lusha.com/api-reference/search-&-enrich/search-and-enrich-companies.md): Find companies and reveal their full data in a single call. Combines Search and Enrich into one request. #### Prospecting - [Prospecting Contacts](https://docs.lusha.com/api-reference/prospecting/prospecting-contacts.md): Search for contacts that match your Ideal Customer Profile using rich filter criteria. - [Prospecting Companies](https://docs.lusha.com/api-reference/prospecting/prospecting-companies.md): Search for companies that match your target market using rich filter criteria. #### Tables ##### Contact Tables - [Create Contacts Table](https://docs.lusha.com/api-reference/contacts-tables/create-contacts-table.md): Create a new, empty contacts table, optionally seeded with an initial list of contact IDs. - [List Contacts Tables](https://docs.lusha.com/api-reference/contacts-tables/list-contacts-tables.md): List contacts tables owned by the given user, plus any tables shared with the account. - [Get Contacts Table](https://docs.lusha.com/api-reference/contacts-tables/get-contacts-table.md): Get a table's metadata and current processing status. - [Update Contacts Table](https://docs.lusha.com/api-reference/contacts-tables/update-contacts-table.md): Rename a table, change its visibility, or reassign its owner. All fields except `owner` are optional - send only what changes. - [Delete Contacts Table](https://docs.lusha.com/api-reference/contacts-tables/delete-contacts-table.md): Permanently delete a table and all its data. This cannot be undone. - [Get Contacts Table Entities](https://docs.lusha.com/api-reference/contacts-tables/get-contacts-table-entities.md): Read a page of rows in the table, with all column values and per-cell status. - [Add Entities to Contacts Table](https://docs.lusha.com/api-reference/contacts-tables/add-entities-to-contacts-table.md): Add up to 500 contact IDs to an existing table. `entityIds` accepts either the encrypted Lusha token (`v{N}.…`, as returned by Search/Enrich/Get Entities) or the legacy numeric `personId` - an ID that's neither returns `400`. Already-present IDs are reported as `alreadyPresent` and not re-added; unr… - [Remove Entities from Contacts Table](https://docs.lusha.com/api-reference/contacts-tables/remove-entities-from-contacts-table.md): Remove specific contact IDs from a table. - [Get Contacts Column Catalog](https://docs.lusha.com/api-reference/contacts-tables/get-contacts-column-catalog.md): List every Lusha data column that can be added to a contacts table - 22 columns. - [List Contacts Table Columns](https://docs.lusha.com/api-reference/contacts-tables/list-contacts-table-columns.md): List the columns on a table, with type and aggregated per-cell status counts. - [Add Columns to Contacts Table](https://docs.lusha.com/api-reference/contacts-tables/add-columns-to-contacts-table.md): Add up to 10 Lusha columns to a table in one call. Enrichment starts automatically on **all rows** in the table as soon as the columns are added. - [Remove Column from Contacts Table](https://docs.lusha.com/api-reference/contacts-tables/remove-column-from-contacts-table.md): Remove a column and delete all of its cell data across the table. Default Lusha columns cannot be removed. - [Run Column on Contacts Table](https://docs.lusha.com/api-reference/contacts-tables/run-column-on-contacts-table.md): Populate or refresh a column's data for some or all rows in the table. This is **asynchronous** - the call returns immediately with `status: "processing"`; poll Get Contacts Table for `isProcessing` and per-column row-status counts to know when it's done, then read the values via Get Contacts Table… ##### Company Tables - [Create Companies Table](https://docs.lusha.com/api-reference/companies-tables/create-companies-table.md): Create a new, empty companies table, optionally seeded with an initial list of company IDs. - [List Companies Tables](https://docs.lusha.com/api-reference/companies-tables/list-companies-tables.md): List companies tables owned by the given user, plus any tables shared with the account. - [Get Companies Table](https://docs.lusha.com/api-reference/companies-tables/get-companies-table.md): Get a table's metadata and current processing status. - [Update Companies Table](https://docs.lusha.com/api-reference/companies-tables/update-companies-table.md): Rename a table, change its visibility, or reassign its owner. All fields except `owner` are optional - send only what changes. - [Delete Companies Table](https://docs.lusha.com/api-reference/companies-tables/delete-companies-table.md): Permanently delete a table and all its data. This cannot be undone. - [Get Companies Table Entities](https://docs.lusha.com/api-reference/companies-tables/get-companies-table-entities.md): Read a page of rows in the table, with all column values and per-cell status. - [Add Entities to Companies Table](https://docs.lusha.com/api-reference/companies-tables/add-entities-to-companies-table.md): Add up to 500 company IDs to an existing table. `entityIds` accepts either the encrypted Lusha token (`v{N}.…`, as returned by Search/Enrich/Get Entities) or the legacy numeric `lushaCompanyId` - an ID that's neither returns `400`. Already-present IDs are reported as `alreadyPresent` and not re-adde… - [Remove Entities from Companies Table](https://docs.lusha.com/api-reference/companies-tables/remove-entities-from-companies-table.md): Remove specific company IDs from a table. - [Get Companies Column Catalog](https://docs.lusha.com/api-reference/companies-tables/get-companies-column-catalog.md): List every Lusha data column that can be added to a companies table - 46 columns. - [List Companies Table Columns](https://docs.lusha.com/api-reference/companies-tables/list-companies-table-columns.md): List the columns on a table, with type and aggregated per-cell status counts. - [Add Columns to Companies Table](https://docs.lusha.com/api-reference/companies-tables/add-columns-to-companies-table.md): Add up to 10 Lusha columns to a table in one call. Enrichment starts automatically on **all rows** in the table as soon as the columns are added. - [Remove Column from Companies Table](https://docs.lusha.com/api-reference/companies-tables/remove-column-from-companies-table.md): Remove a column and delete all of its cell data across the table. Default Lusha columns cannot be removed. - [Run Column on Companies Table](https://docs.lusha.com/api-reference/companies-tables/run-column-on-companies-table.md): Populate or refresh a column's data for some or all rows in the table. This is **asynchronous** - the call returns immediately with `status: "processing"`; poll Get Companies Table for `isProcessing` and per-column row-status counts to know when it's done, then read the values via Get Companies Tabl… #### Filters - [Get Contact Filter Types (Discovery)](https://docs.lusha.com/api-reference/filters/get-contact-filter-types-discovery.md): Returns all available filter types for contact prospecting and whether each requires a search query. - [Get Contact Filter Values](https://docs.lusha.com/api-reference/filters/get-contact-filter-values.md): Returns valid values for a single contact filter type. - [Get Company Filter Types (Discovery)](https://docs.lusha.com/api-reference/filters/get-company-filter-types-discovery.md): Returns all available filter types for company prospecting and whether each requires a search query. - [Get Company Filter Values](https://docs.lusha.com/api-reference/filters/get-company-filter-values.md): Returns valid values for a single company filter type. #### Lookalikes - [Contact Lookalikes](https://docs.lusha.com/api-reference/lookalikes/contact-lookalikes.md): Returns contact lookalikes based on seed contacts. - [Company Lookalikes](https://docs.lusha.com/api-reference/lookalikes/company-lookalikes.md): Returns company lookalikes based on seed companies. #### Recommendations - [Contact Recommendations](https://docs.lusha.com/api-reference/recommendations/contact-recommendations.md): Returns the recommended contacts for the calling user, ranked by Lusha against your Target Profiles and recent signals. - [Company Recommendations](https://docs.lusha.com/api-reference/recommendations/company-recommendations.md): Returns the recommended companies for the calling user, ranked by Lusha against your Target Profiles and recent signals. - [Contact Recommendation Filters](https://docs.lusha.com/api-reference/recommendations/contact-recommendation-filters.md): Lists the Target Profiles and signal types that currently appear in your contact recommendations. Pass these values to `filters.targetIcp` and `filters.signals` of [Contact Recommendations](#operation/getContactRecommendations). - [Company Recommendation Filters](https://docs.lusha.com/api-reference/recommendations/company-recommendation-filters.md): Lists the Target Profiles and signal types that currently appear in your company recommendations. Pass these values to `filters.targetIcp` and `filters.signals` of [Company Recommendations](#operation/getCompanyRecommendations). #### Signals - [Contact Signals](https://docs.lusha.com/api-reference/signals/contact-signals.md): Retrieve signal events for a list of contacts - job changes and promotions. - [Get Contact Signal Types](https://docs.lusha.com/api-reference/signals/get-contact-signal-types.md): Returns the full list of supported signal types for contacts. - [Score Contacts by Signal Activity](https://docs.lusha.com/api-reference/signals/score-contacts-by-signal-activity.md): Score contacts by their active buying signals. Returns the aggregate Signal Score - a `[0, 1]` value - plus the active signal breakdown per contact. - [Company Signals](https://docs.lusha.com/api-reference/signals/company-signals.md): Retrieve signal events for a list of companies - hiring activity, headcount changes, web traffic, IT spend, news, and intent. - [Get Company Signal Filters (Discovery)](https://docs.lusha.com/api-reference/signals/get-company-signal-filters-discovery.md): Returns all available filter types for company signals and whether each requires a search query. - [Get Company Signal Filter Values](https://docs.lusha.com/api-reference/signals/get-company-signal-filter-values.md): Returns valid values for a single company signal filter type. - [Get Company Signal Types](https://docs.lusha.com/api-reference/signals/get-company-signal-types.md): Returns the full list of supported signal types for companies. - [Score Companies by Signal Activity](https://docs.lusha.com/api-reference/signals/score-companies-by-signal-activity.md): Score companies by their active buying signals. Returns the aggregate Signal Score - a `[0, 1]` value reflecting the fraction of the company's active signals - plus the active signal breakdown. #### ICP Fit Score - [List Target Profiles](https://docs.lusha.com/api-reference/icp-fit-score/list-target-profiles.md): Returns the Target Profiles (ICPs) you can see: your own, plus any an admin has shared with the account. - [Score Contacts by ICP Fit](https://docs.lusha.com/api-reference/icp-fit-score/score-contacts-by-icp-fit.md): Score how well each contact fits 1-3 of your Target Profiles, from `0` to `1`. - [Score Companies by ICP Fit](https://docs.lusha.com/api-reference/icp-fit-score/score-companies-by-icp-fit.md): Score how well each company fits 1-3 of your Target Profiles, from `0` to `1`. #### Buying Group - [Get Buying Group Contacts](https://docs.lusha.com/api-reference/buying-group/get-buying-group-contacts.md): Identify the buying group within a set of target companies. Supply companies by `domain` or Lusha company `id` - the model scores and labels each returned contact with a persona role. #### Conversations - [Search Conversations](https://docs.lusha.com/api-reference/conversations/search-conversations.md): Search the sales conversations recorded by Lusha Conversations for your account. Returns each conversation's metadata, AI summary, action items, risks, objections, competitor mentions, coaching analysis, and chapters. Transcripts are not included - fetch those from [Get Conversation Transcript](#ope… - [Get Conversation Transcript](https://docs.lusha.com/api-reference/conversations/get-conversation-transcript.md): Returns the speaker-attributed, timestamped transcript of a single conversation. Get the `conversationId` from [Search Conversations](#operation/searchConversations). #### Website Visits - [Get Website Visitors](https://docs.lusha.com/api-reference/website-visits/get-website-visitors.md): Returns companies ranked by website-visit signals for your tracked domains and date range. #### Webhooks - [Create Subscription](https://docs.lusha.com/api-reference/webhooks/create-subscription.md): Creates one or more webhook subscriptions for real-time signal notifications. - [List Subscriptions](https://docs.lusha.com/api-reference/webhooks/list-subscriptions.md): Returns all webhook subscriptions for your account with pagination support. - [Get Subscription by ID](https://docs.lusha.com/api-reference/webhooks/get-subscription-by-id.md): Returns a single webhook subscription by ID. - [Update Subscription](https://docs.lusha.com/api-reference/webhooks/update-subscription.md): Updates an existing webhook subscription. All fields are optional. - [Delete Subscriptions](https://docs.lusha.com/api-reference/webhooks/delete-subscriptions.md): Delete one or more webhook subscriptions. Returns detailed results for each deletion with partial success support. - [Test Subscription](https://docs.lusha.com/api-reference/webhooks/test-subscription.md): Test a webhook subscription by sending a test signal. Supports three test modes. - [Create Opt-Out Subscription](https://docs.lusha.com/api-reference/webhooks/create-opt-out-subscription.md): Subscribe to real-time notifications when a contact opts out of data processing. When a contact requests removal, Lusha sends an `OptOutWebhookPayload` to your endpoint so you can action the removal in your own systems (CRM, outreach tools, etc.). - [Get Audit Logs](https://docs.lusha.com/api-reference/webhooks/get-audit-logs.md): Retrieve webhook delivery logs for your account. - [Get Audit Log Statistics](https://docs.lusha.com/api-reference/webhooks/get-audit-log-statistics.md): Get delivery statistics for your account. - [Get Account Secret](https://docs.lusha.com/api-reference/webhooks/get-account-secret.md): Retrieve the current account webhook secret. - [Regenerate Account Secret](https://docs.lusha.com/api-reference/webhooks/regenerate-account-secret.md): Regenerate the account webhook secret. Affects **all subscriptions** for the account. #### Account - [Get Account Usage](https://docs.lusha.com/api-reference/account/get-account-usage.md): Returns a full snapshot of your account status: - **Credits** - total, used, and remaining for the current billing cycle - **Rate limits** - current usage and reset times for daily, hourly, and per-minute windows - **Plan** - your current plan category and renewal dates - **Pricing** - credit cost p… ## OpenAPI Specs - [openapi](/openapi.json) - [openapi](/v2/openapi.json)