# Overview

Lusha provides a RESTful API that allows you to query a comprehensive dataset of business profiles and company information. The API offers three main endpoints:

1. **Person API** – Retrieve contact data for a business profile.
2. **Company API** – Retrieve company data based on domain or company name.
3. **Prospecting API** – Query Lusha’s extensive database based on specific criteria (industry, seniority, location, etc.) to retrieve detailed contact and company information.


*All API requests must be made over HTTPS (SSL), and responses are delivered in JSON format.*

> 💡 For detailed information on request parameters, response structure, and best practices, please refer to our official API documentation.


## Authentication

To access the Lusha API, include your API key in each request. This key is unique to your account and must be kept private.

1. Visit the **API** page on your Lusha dashboard to retrieve your key.
2. Share it only with trusted individuals—your API key grants full access to your account.


> 💡 Only admins/managers with the API feature on their plan can view the API key page.


## Rate Limiting

To ensure fair usage and protect against excessive load, Lusha enforces the following rate limits:

- **All endpoints**: Up to **50 requests per second** per endpoint.


## Credit Usage

The Credit Usage API lets you monitor your account’s credit consumption:

- Check how many credits have been used and how many remain, by credit type.
- **Rate limit**: 5 requests per minute.


## Person API

Look up detailed information about a person using identifiers such as email, LinkedIn URL, full name + company name, or company domain. You can retrieve:

- Location
- Email
- Phone number
- LinkedIn URL
- …and more


### Bulk Person API

Process up to **100** person objects per request to reduce API calls and integrate seamlessly with large-scale workflows.

> **Credit Usage:** Each successful contact match consumes **1 credit**.


## Company API

Retrieve firmographic data for a company using its domain or name. Data points include:

- Industry
- Employee count
- Location
- Revenue estimates
- …and other key business details


Ideal for CRM enrichment, market research, and lead qualification.

### Bulk Company API

Enrich multiple domains or company names in a single request to streamline high-volume workflows.

## Prospecting API

Generate new leads/contacts for your CRM by applying filters that match your Ideal Customer Profile (ICP). Available filters include:

- Job title
- Seniority
- Location
- Industry
- …and more


### Workflow

1. **Apply filters** – Select the criteria you need.
2. **Search** – Query contacts or companies based on those filters.
3. **Enrich** – Retrieve full details for each result using the Enrich API.


> 💡 A credit is charged **only** in the final “Enrich” step.


For a full list of available filters and detailed stage-by-stage guidance, see our Prospecting API reference.

## Error Handling

Lusha API uses standard HTTP status codes to indicate request outcomes:

- **2xx** – Success
- **4xx** – Client error (e.g., malformed request, authentication issues)
- **5xx** – Server error


Access our API documentation for the complete list of codes and their meanings.

> 💡 Error-handling features are available on **Scale** plans only.