> ## 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.

# Credits & Pricing

> Understand how LeadMagic credits work and optimize your usage

LeadMagic uses a flexible credit-based system that gives you control over how you use our data enrichment services. Credits function as a flexible currency that can be used across all our enrichment services.

> [!NOTE]
>
> **Try before you buy** - Test any endpoint in our [API
> Playground](https://leadmagic.io/docs/v1/reference/email-validation.md) to see exactly what you get before
> using credits.

## How Credits Work

> [card] Pay for Success
>
> Credits are only deducted when enrichment is successful

> [card] Flexible Usage
>
> Use credits across all enrichment services based on your needs

> [card] Team Sharing
>
> Share credits across team members within your organization

## Credit Costs by Service

> [tab] Email & Validation
>
> | Service | Credits | What You Get |
> | - | - | - |
> | **Email Validation** | 1 | **4 validations** |
> | Email Finder | 1 | 1 email found |
> | Personal Email Finder | 2 | 1 personal email |
> | Profile to Email | 5 | 1 email from profile URL |
>
> > [!TIP]
> >
> > **Best Value**: Email Validation uses 0.25 credits per email (4 validations per credit). On higher tiers, per-validation cost drops to about **half a cent** or less.

> [tab] Mobile & Profiles
>
> | Service | Credits | What You Get |
> | - | - | - |
> | Profile Search | 1 | 1 full profile |
> | **People Search** | 1+ | Search employees and decision-makers |
> | Role Finder | 2 | 1 role at company |
> | **Mobile Finder** | 5 | 1 mobile number |
> | Email to Profile | 10 | 1 complete profile |
> | Job Change Detector | 3 | 1 job change check |
>
> > [!TIP]
> >
> > Mobile numbers are premium data - verify your contact list first with
> > Email Validation to maximize ROI.

> [tab] Company Data
>
> | Service | Credits | What You Get |
> | - | - | - |
> | Company Search | 1 | 1 returned company |
> | Technographics | 1 | Tech stack data |
> | Company Funding | 4 | Funding history |
> | Company Lookalike | 5 | Similar company list |

> [tab] Ads Intelligence
>
> | Service | Credits | What You Get |
> | - | - | - |
> | Google Ads Search | 1 | **5 ad lookups** |
> | Meta Ads Search | 1 | **5 ad lookups** |
> | B2B Ads Search | 1 | **5 ad lookups** |
> | B2B Ad Details | 2 | Full ad breakdown |

## What's Free?

> [card] Email Validation
>
> **Free for inconclusive results**
>
> * `unknown` — could not determine email validity
>
> You only pay for definitive results: `valid` and `invalid`.

> [card] All Other Endpoints
>
> **No Charge when nothing found**
>
> Email Finder only charges 1 credit when a `valid` email is returned. `null` results are free. Other endpoints follow the same pattern — `not_found` results are always free.

## Subscription Plans

| Plan | Credits/mo | Price | Per Credit | Best For |
| - | - | - | - | - |
| **Trial** | 100 | Free | — | Try the API |
| **Basic** | 2,000 | \$49 | \$0.0245 | Individuals |
| **Essential** | 5,000 | \$99 | \$0.0198 | Small teams |
| **Growth** | 20,000 | \$249 | \$0.01245 | Growing companies |
| **Professional** | 50,000 | \$499 | \$0.00998 | Agencies |
| **Ultimate** | 100,000 | \$849 | \$0.00849 | High volume |

> [accordion] What's Included
>
> **All plans include:**
>
> * Access to all API endpoints
> * API Playground access
> * Priority support
> * Usage analytics
>
> **Essential plan and above:**
>
> * Credit rollover (unused credits carry forward)
> * Team organization (5 members)
> * Shared credit pools

> [accordion] Credit Rollover
>
> On **Essential plan and above**, unused credits roll over to the next month.
>
> * Credits accumulate month-over-month
>
> * No "use it or lose it" pressure
>
> * Plan with confidence
>
> > [!NOTE]
> >
> > Basic plan credits expire at the end of each billing cycle.

## Managing Your Credits

### Check Your Balance

Use the [Check Credits endpoint](https://leadmagic.io/docs/v1/reference/check-credits.md) to monitor your balance programmatically:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X GET 'https://api.leadmagic.io/v1/credits' \
  -H 'X-API-Key: YOUR_API_KEY'
```

### Dashboard View

Your current usage statistics are displayed on the main dashboard in the top left of the display. For detailed reports:

1. Go to **Settings > Credit History**
2. View detailed reports on credits consumed and API usage

### Auto Top-Up

Never run out mid-enrichment:

**1. Go to Settings**

Navigate to [Settings > Billing](https://app.leadmagic.io/settings/billing) in your dashboard.

**2. Enable Auto Top-Up**

Set a threshold (e.g., 500 credits) and purchase amount.

**3. Relax**

Credits are automatically purchased when your balance drops below the threshold.

### Manual Top-Up

Need credits immediately?

1. Go to [Settings > Billing](https://app.leadmagic.io/settings/billing)
2. Click "Purchase Credits"
3. Select a credit package
4. Complete payment - credits are added instantly

## Optimize Your Credit Usage

> [accordion] Validate First, Enrich Later
>
> **Save 80%+ on wasted credits**
>
> Before running expensive enrichments (mobile finder, full profiles), validate your email list:
>
> 1. Run Email Validation (4 per credit)
> 2. Filter for `valid` results only
> 3. Then run premium enrichments on verified contacts
>
> This prevents spending credits on invalid contacts.

> [accordion] Use Conditional Logic
>
> In your code or Clay workflows, only enrich when conditions are met:
>
> ```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
> // Only find mobile for VPs and above
> if (contact.title.includes('VP') || contact.title.includes('Director')) {
>   await findMobile(contact.linkedin_url);
> }
> ```

> [accordion] Batch Your Requests
>
> Process records in batches rather than one-by-one:
>
> * Reduce API overhead
> * Handle errors gracefully
> * Monitor credit consumption per batch
> * Stop early if results are poor

> [accordion] Prioritize by Value
>
> Focus expensive enrichments on high-value prospects:
>
> 1. Score leads by ICP fit
> 2. Enrich top-tier leads first
> 3. Use cheaper validation for lower tiers
> 4. Re-evaluate before scaling

## Team Credit Management

> [!NOTE]
>
> Available on Essential plan and above.

### Share Credits Across Your Team

1. Click your name in the top left
2. Switch from "Personal Account" to your organization
3. Go to Settings > Team
4. Use the three dots next to each member to allocate credits

### Track Team Usage

Monitor which team members consume the most credits:

1. Go to Settings > Usage & Billing
2. Review the Credit Usage Report
3. Identify high-consumption activities
4. Adjust allocations as needed

## Billing & Payments

### Payment Methods

LeadMagic accepts:

> [card] Visa

> [card] Mastercard

> [card] AMEX

> [card] Discover

> [card] Bank ACH

### Upgrading Your Plan

* You can upgrade your plan at any time
* Existing credits transfer as you upgrade
* Your current subscription will end immediately, and the new subscription date will begin at that time

### Downgrading Your Plan

* You can downgrade your plan at any time
* It will go into effect at the end of your current billing cycle
* An Essential plan is required for credits to rollover each month

### Invoices

We deliver the invoice upon charging you for your subscription. You can access past invoices and/or setup invoice forwarding in the platform under **Settings > Billing**.

## Ready to Start?

> [card] [Try the API Playground](https://leadmagic.io/docs/v1/reference/email-validation.md)
>
> Test any endpoint - see exactly what you get before using credits.

> [card] [View Plans](https://leadmagic.io/pricing)
>
> Choose the right plan for your needs.


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