# Lusha

> Enrich B2B people and companies, run prospecting searches, and check credits with the Lusha API.

Lets an agent pull B2B contact and company data from Lusha: enrich a person (by email, LinkedIn URL, or name + company), enrich a company (by domain or name), run prospecting searches for contacts and companies, and check how many credits are left.

## What it can do

| Method | What it does |
| --- | --- |
| `lusha_person_enrich` | Enrich a single person by email, linkedinUrl, or name + company. Returns job title, emails, phones (consumes credits). |
| `lusha_company_enrich` | Enrich a single company by domain or name. Returns firmographics: size, industry, location, socials. |
| `lusha_contact_search` | Prospecting search for contacts (filters + pages). Returns matches and a requestId. |
| `lusha_company_search` | Prospecting search for companies (filters + pages). Returns matches and a requestId. |
| `lusha_prospecting_enrich` | Enrich search results using a requestId plus contactIds / companyIds. Returns full records (consumes credits). |
| `lusha_usage` | Get account usage and remaining credits. |
| `lusha_request` | Generic passthrough to any Lusha endpoint for full API coverage. |

## How to get your key

Lusha authenticates with a single API key sent in the `api_key` header.

1. Sign in to the [Lusha dashboard](https://dashboard.lusha.com).
2. Open the **API** section ([dashboard.lusha.com/enrich/api](https://dashboard.lusha.com/enrich/api)).
3. Generate or copy your API key. API access depends on your Lusha plan.
4. Paste it into FlyMyAI.

## Fields to fill

| FlyMyAI field | Where it comes from |
| --- | --- |
| `LUSHA_API_KEY` | Lusha Dashboard -> API |

## Troubleshooting

- **`401 Unauthorized`** - the key is wrong or rotated. Re-copy it from the Lusha Dashboard -> API page.
- **`403 Forbidden` / API not available** - API access is gated by plan. Check that your Lusha subscription includes API usage.
- **Empty enrichment result** - Lusha could not find a match. Provide more identifiers (email plus name plus company domain) to improve the hit rate.
- **Out of credits** - enrichment consumes credits. Call `lusha_usage` to check the balance before bulk pulls.

## Links

- [Lusha API key page](https://dashboard.lusha.com/enrich/api)
- [Lusha API documentation](https://docs.lusha.com)