> ## 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](/docs/v1/reference/email-validation) to see exactly what you get before
  using credits.
</Note>

## How Credits Work

<CardGroup cols={3}>
  <Card title="Pay for Success" icon="check">
    Credits are only deducted when enrichment is successful
  </Card>

  <Card title="Flexible Usage" icon="arrows-rotate">
    Use credits across all enrichment services based on your needs
  </Card>

  <Card title="Team Sharing" icon="users">
    Share credits across team members within your organization
  </Card>
</CardGroup>

## Credit Costs by Service

<Tabs>
  <Tab title="Email & Validation" icon="envelope">
    | 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 |

    <Check>
      **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.
    </Check>
  </Tab>

  <Tab title="Mobile & Profiles" icon="phone">
    | 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.
    </Tip>
  </Tab>

  <Tab title="Company Data" icon="building">
    | 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>

  <Tab title="Ads Intelligence" icon="rectangle-ad">
    | 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 |
  </Tab>
</Tabs>

## What's Free?

<CardGroup cols={2}>
  <Card title="Email Validation" icon="gift">
    **Free for inconclusive results**

    * `unknown` — could not determine email validity

    You only pay for definitive results: `valid` and `invalid`.
  </Card>

  <Card title="All Other Endpoints" icon="circle-xmark">
    **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.
  </Card>
</CardGroup>

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

<AccordionGroup>
  <Accordion title="What's Included" icon="check">
    **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>

  <Accordion title="Credit Rollover" icon="rotate">
    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.</Note>
  </Accordion>
</AccordionGroup>

## Managing Your Credits

### Check Your Balance

Use the [Check Credits endpoint](/docs/v1/reference/check-credits) 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:

<Steps>
  <Step title="Go to Settings">
    Navigate to [Settings > Billing](https://app.leadmagic.io/settings/billing) in your dashboard.
  </Step>

  <Step title="Enable Auto Top-Up">
    Set a threshold (e.g., 500 credits) and purchase amount.
  </Step>

  <Step title="Relax">
    Credits are automatically purchased when your balance drops below the threshold.
  </Step>
</Steps>

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

<AccordionGroup>
  <Accordion title="Validate First, Enrich Later" icon="filter">
    **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>

  <Accordion title="Use Conditional Logic" icon="code-branch">
    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>

  <Accordion title="Batch Your Requests" icon="layer-group">
    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>

  <Accordion title="Prioritize by Value" icon="ranking-star">
    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
  </Accordion>
</AccordionGroup>

## Team Credit Management

<Info>Available on Essential plan and above.</Info>

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

<CardGroup cols={5}>
  <Card title="Visa" icon="cc-visa" />

  <Card title="Mastercard" icon="cc-mastercard" />

  <Card title="AMEX" icon="cc-amex" />

  <Card title="Discover" icon="cc-discover" />

  <Card title="Bank ACH" icon="building-columns" />
</CardGroup>

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

<CardGroup cols={2}>
  <Card title="Try the API Playground" icon="play" href="/docs/v1/reference/email-validation" color="#22c55e">
    Test any endpoint - see exactly what you get before using credits.
  </Card>

  <Card title="View Plans" icon="credit-card" href="https://leadmagic.io/pricing">
    Choose the right plan for your needs.
  </Card>
</CardGroup>