# Lusha API

Lusha provides a RESTful API that allows you to query a comprehensive dataset of business profiles and company information. 

## Getting Started
To use the Lusha API, you'll need an API key. Include it in the `api_key` header with each request.

## Main Features
- **Person Search**: Find contact information for individuals
- **Company Search**: Get detailed company information  
- **Account Usage**: Monitor your API credit usage


Version: 2.0.0
License: Lusha API License

## Servers

Production server
```
https://api.lusha.com
```

Staging server
```
https://api-staging.lusha.com
```

## Security

### ApiKeyAuth

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.


Type: apiKey
In: header
Name: api_key

## Download OpenAPI description

[Lusha API](https://docs.lusha.com/_bundle/apis/index2.yaml)

## Person

Search for individual contacts and their information

### Search Multiple Contacts

 - [POST /v2/person](https://docs.lusha.com/apis/index2/person/personcontroller_searchbulkcontacts.md): Enrich multiple contacts in a single request. This endpoint allows you to submit a list of contacts 
and receive enriched data for each one, including company information.

Rate Limits: Please check your account limits for bulk operations.

### Search Single Contact

 - [GET /v2/person](https://docs.lusha.com/apis/index2/person/personcontroller_searchsinglecontact.md): Find and enrich a single contact using various search criteria. You can search by name, email, 
LinkedIn URL, or company information.

Search Tips:
- Provide as much information as possible for better results
- Use refreshJobInfo=true to get the latest employment data
- Use filterBy parameter to specify what contact details you need

## Company

Search for company information and details

### Search Multiple Companies

 - [POST /v2/company](https://docs.lusha.com/apis/index2/company/companycontroller_searchbulkcompanies.md): Search for multiple companies in a single request. Provide a list of companies with 
identifiers like domain names or company IDs.

### Search Single Company

 - [GET /v2/company](https://docs.lusha.com/apis/index2/company/companycontroller_searchsinglecompany.md): Find detailed information about a single company using domain name, company name, or company ID.

Note: At least one of domain, company, or companyId is required.

## Account

Manage your account and monitor usage

### Get Account Usage Statistics

 - [GET /account/usage](https://docs.lusha.com/apis/index2/account/accountcontroller_getaccountusagestats.md): Retrieve your current API credit usage statistics including used, remaining, and total credits.

Rate Limits: This endpoint has a rate limit of 5 requests per minute.