> ## Documentation Index
> Fetch the complete documentation index at: https://leadmagic.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Make your first API call in under 5 minutes

Get started with LeadMagic in minutes. This guide walks you through making your first API call and exploring our interactive playground.

> [!NOTE]
>
> **Fastest way to start**: Skip the code and use our [API
> Playground](https://leadmagic.io/docs/v1/reference/email-validation.md) - test any endpoint directly in
> your browser!

## Step 1: Get Your API Key

**1. Create an account**

[Sign up for free](https://app.leadmagic.io/sign-up) or [log in](https://app.leadmagic.io) if you already have an account.

**2. Navigate to API Settings**

Go to [Settings > API](https://app.leadmagic.io/settings/api) in your dashboard.

**3. Copy your API key**

Click the copy button to copy your API key to clipboard.

> [!WARNING]
>
> Keep your API key secret. Never expose it in client-side code or public repositories.

## Step 2: Try the API Playground

The fastest way to test LeadMagic is our interactive API Playground. No code required!

> [card] [Email Validation](https://leadmagic.io/docs/v1/reference/email-validation.md)
>
> Verify an email address instantly.

> [card] [Email Finder](https://leadmagic.io/docs/v1/reference/email-finder.md)
>
> Find an email from name + company.

### How to Use the Playground

**1. Go to any API Reference page**

Click any endpoint in the sidebar or the cards above.

**2. Enter your API key**

Paste your API key in the authentication section.

**3. Fill in the parameters**

Enter test data (e.g., an email to validate).

**4. Click 'Send'**

See the live response immediately!

> [!TIP]
>
> The playground shows you exactly what your code will return - perfect for
> testing before integration.

## Step 3: Make Your First API Call

Ready to integrate? Here's how to call the API from your code:

> [tab] cURL
>
> ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST 'https://api.leadmagic.io/v1/people/email-validation' \
>   -H 'Content-Type: application/json' \
>   -H 'X-API-Key: YOUR_API_KEY' \
>   -d '{"email": "test@leadmagic.io"}'
> ```

> [tab] JavaScript
>
> ```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
> const response = await fetch('https://api.leadmagic.io/v1/people/email-validation', {
>   method: 'POST',
>   headers: {
>     'Content-Type': 'application/json',
>     'X-API-Key': process.env.LEADMAGIC_API_KEY
>   },
>   body: JSON.stringify({ email: 'test@leadmagic.io' })
> });
>
> const data = await response.json();
> console.log(data.email_status); // "valid", "invalid", or "unknown"
> ```

> [tab] Python
>
> ```python theme={"theme":{"light":"github-light","dark":"github-dark"}}
> import requests
> import os
>
> response = requests.post(
>     'https://api.leadmagic.io/v1/people/email-validation',
>     headers={
>         'Content-Type': 'application/json',
>         'X-API-Key': os.environ['LEADMAGIC_API_KEY']
>     },
>     json={'email': 'test@leadmagic.io'}
> )
>
> data = response.json()
> print(data['email_status'])  # "valid", "invalid", or "unknown"
> ```

### Example Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "email_status": "valid",
  "email": "test@leadmagic.io",
  "domain": "leadmagic.io",
  "credits_consumed": 0.25,
  "company": {
    "name": "LeadMagic",
    "domain": "leadmagic.io",
    "linkedin_url": "https://linkedin.com/company/leadmagichq"
  }
}
```

> [!TIP]
>
> **Bonus**: Every email validation includes free company enrichment data!

## Step 4: Explore More Endpoints

Now that you've made your first call, explore other powerful endpoints:

> [card] [Find Emails](https://leadmagic.io/docs/v1/reference/email-finder.md)
>
> Get professional emails from name + company domain.

> [card] [Find Mobile Numbers](https://leadmagic.io/docs/v1/reference/mobile-finder.md)
>
> Discover direct mobile numbers for outreach.

> [card] [Enrich Profiles](https://leadmagic.io/docs/v1/reference/profile-search.md)
>
> Get complete professional profiles with work history.

> [card] [Search Companies](https://leadmagic.io/docs/v1/reference/company-search.md)
>
> Enrich company data by domain or name.

> [!TIP]
>
> These are our most popular endpoints. See [Use Cases](https://leadmagic.io/docs/v1/use-cases.md) for workflow ideas, or the full [API Reference](https://leadmagic.io/docs/v1/reference/introduction.md) for all endpoints across email, contact, people, company, jobs, and ads data.

## Common Use Cases

> [accordion] Clean Your Email List
>
> **Goal**: Remove invalid emails before a campaign
>
> 1. Loop through your email list
> 2. Call [Email Validation](https://leadmagic.io/docs/v1/reference/email-validation.md) for each
> 3. Keep only `valid` emails
> 4. Remove `invalid`, skip `unknown` (free, retry later)
>
> **Result**: Higher deliverability, protected sender reputation

> [accordion] Build a Prospect List
>
> **Goal**: Get contact info for target accounts
>
> 1. Start with company domains
> 2. Use [Role Finder](https://leadmagic.io/docs/v1/reference/role-finder.md) to find decision-makers
> 3. Use [Email Finder](https://leadmagic.io/docs/v1/reference/email-finder.md) for work emails
> 4. Use [Mobile Finder](https://leadmagic.io/docs/v1/reference/mobile-finder.md) for phone numbers
>
> **Result**: Complete contact list for outreach

> [accordion] Enrich CRM Data
>
> **Goal**: Fill in missing CRM fields
>
> 1. Export contacts with LinkedIn URLs
> 2. Use [Profile Search](https://leadmagic.io/docs/v1/reference/profile-search.md) for full profiles
> 3. Use [Company Search](https://leadmagic.io/docs/v1/reference/company-search.md) for company data
> 4. Import enriched data back to CRM
>
> **Result**: Rich CRM data for better personalization

> [card] [More Use Cases](https://leadmagic.io/docs/v1/use-cases.md)
>
> Browse outbound, inbound, CRM cleanup, hiring intent, market research, MCP, and bulk enrichment workflows.

## What's Next?

> [card] [Making API Calls](https://leadmagic.io/docs/v1/making-api-calls.md)
>
> Production request patterns, status codes, and retries.

> [card] [Authentication Guide](https://leadmagic.io/docs/v1/authentication.md)
>
> Secure API key usage and key rotation best practices.

> [card] [Developer Experience](https://leadmagic.io/docs/v1/developer-experience.md)
>
> Headers, observability, error handling, and analytics endpoints.

> [card] [API Playground](https://leadmagic.io/docs/v1/reference/email-validation.md)
>
> Test any endpoint interactively.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.