Skip to content

Lusha API (2.0.0)

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
Download OpenAPI description
Languages
Servers
Mock server
https://docs.lusha.com/_mock/apis/index2/
Production server
https://api.lusha.com/
Staging server
https://api-staging.lusha.com/

Person

Search for individual contacts and their information

Operations

Company

Search for company information and details

Operations

Account

Manage your account and monitor usage

Operations

Get Account Usage Statistics

Request

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.

Security
ApiKeyAuth
Headers
X-RateLimit-Limitinteger

The Credit Usage API has a rate limit of 5 requests per minute. This header shows the current limit.

Example: 5
curl -i -X GET \
  https://docs.lusha.com/_mock/apis/index2/account/usage \
  -H 'X-RateLimit-Limit: 5' \
  -H 'api_key: YOUR_API_KEY_HERE'

Responses

Account usage statistics retrieved successfully

Bodyapplication/json
usageUsageStats (object)required

The usage stats for the account

UsageStats (object)

The usage stats for the account

Response
application/json
{ "usage": { "used": 150, "total": 1000, "remaining": 850 } }