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

# Support & Policies

> Get help, understand our policies, and contact the LeadMagic team

At LeadMagic, we're committed to helping you succeed with our API. Whether you have a question, encounter an issue, or need guidance, our support team is here to help.

## Contact Options

<CardGroup cols={2}>
  <Card title="Email Support" icon="envelope" href="mailto:support@leadmagic.io">
    **[support@leadmagic.io](mailto:support@leadmagic.io)**

    Available 9 AM - 5 PM EST. Response within 24 hours.
  </Card>

  <Card title="Live Chat" icon="comments">
    **In-App Chat**

    Click the chat icon in the bottom right of your dashboard for immediate assistance.
  </Card>

  <Card title="Help Center" icon="circle-question" href="https://help.leadmagic.io/en">
    **Self-Service Help**

    Browse articles, tutorials, and FAQs.
  </Card>

  <Card title="Sales Inquiries" icon="handshake" href="mailto:support@leadmagic.io">
    **Enterprise & Custom Plans**

    Contact our team for custom solutions.
  </Card>
</CardGroup>

## Help Center Resources

<AccordionGroup>
  <Accordion title="Getting Started" icon="rocket" defaultOpen>
    * [Welcome to LeadMagic](https://help.leadmagic.io/en) - Platform overview
    * [Creating Your Account](https://help.leadmagic.io/en) - Account setup guide
    * [The LeadMagic Credit System](/docs/v1/credits) - Understanding credits
    * [Subscription Plans](/docs/v1/credits#subscription-plans) - Plan comparison
  </Accordion>

  <Accordion title="List Data Enrichment" icon="list">
    * [Uploading a List for Enrichment](https://help.leadmagic.io/en) - Bulk processing
    * [Email Validation](/docs/v1/reference/email-validation) - Verify email addresses
    * [Email Finder](/docs/v1/reference/email-finder) - Find work emails
    * [Mobile Finder](/docs/v1/reference/mobile-finder) - Find mobile numbers
    * [Profile Search](/docs/v1/reference/profile-search) - Enrich LinkedIn profiles
    * [Company Search](/docs/v1/reference/company-search) - Company data enrichment
  </Accordion>

  <Accordion title="API Usage" icon="code">
    * [Authentication](/docs/v1/authentication) - API key setup
    * [Making API Calls](/docs/v1/making-api-calls) - Request & response formats
    * [Check Credits](/docs/v1/reference/check-credits) - Monitor your balance
    * [Integrations](/docs/v1/integrations) - Third-party platform guides
  </Accordion>

  <Accordion title="Account Management" icon="user-gear">
    * [Team Management](/docs/v1/credits#team-credit-management) - Share credits with team
    * [Billing & Invoices](/docs/v1/credits#billing--payments) - Payment management
    * [API Keys](https://app.leadmagic.io/settings/api) - Key management
  </Accordion>
</AccordionGroup>

## Before Contacting Support

<Info>
  Check these resources first - your answer might already be available!
</Info>

<AccordionGroup>
  <Accordion title="Search the Documentation" icon="book">
    Use the search bar at the top of this page to find answers to common questions.
  </Accordion>

  <Accordion title="Check Your API Response" icon="code">
    Error messages often contain helpful information about what went wrong.
    Check the `errors` array and `meta.request_id` in your API response.
  </Accordion>

  <Accordion title="Verify Your API Key" icon="key">
    Ensure your API key is correct and hasn't expired. You can regenerate it in
    your [account settings](https://app.leadmagic.io/settings/api).
  </Accordion>

  <Accordion title="Check Your Credit Balance" icon="wallet">
    Use the [Check Credits endpoint](/docs/v1/reference/check-credits) to verify you
    have sufficient credits.
  </Accordion>
</AccordionGroup>

## How to Report an Issue

When contacting support, please include:

<Steps>
  <Step title="Describe the issue">
    Explain what you're trying to do and what's not working as expected.
  </Step>

  <Step title="Include your API key prefix">
    Share the **first 8 characters** of your API key for identification.

    <Warning>
      Never share your full API key. Only the first 8 characters.
    </Warning>
  </Step>

  <Step title="Provide the request details">
    Include the endpoint URL, request body (with sensitive data redacted), and
    any error messages.
  </Step>

  <Step title="Share the response">
    Include the full API response, including status code and error details.
  </Step>
</Steps>

### Example Support Request

<Accordion title="Good support request example">
  ```markdown theme={"theme":{"light":"github-light","dark":"github-dark"}}
  **Issue:** Email validation returning "unknown" for valid emails

  **API Key Prefix:** abc12345...

  **Endpoint:** POST /v1/people/email-validation

  **Request Body:**
  {
    "email": "alex.rivera@example.com"
  }

  **Response:**
  {
    "status": "unknown",
    "email": "alex.rivera@example.com"
  }

  **Expected:** Status should be "valid" as the email exists.

  **Environment:** Node.js 20, using fetch API
  ```
</Accordion>

## Common Issues

<AccordionGroup>
  <Accordion title="401 Unauthorized" icon="lock">
    **Cause:** Invalid or missing API key.

    **Solution:**

    * Verify your API key in the dashboard
    * Check the header name is exactly `X-API-Key`
    * Ensure there are no extra spaces in the key
  </Accordion>

  <Accordion title="402 Payment Required" icon="credit-card">
    **Cause:** Insufficient credits in your account.

    **Solution:**

    * Check your balance in the dashboard
    * Purchase additional credits
    * Use the [Check Credits endpoint](/docs/v1/reference/check-credits)
  </Accordion>

  <Accordion title="429 Too Many Requests" icon="gauge-high">
    **Cause:** Rate limit exceeded.

    **Solution:**

    * Reduce your request frequency
    * Implement exponential backoff
    * Contact us for higher limits
  </Accordion>

  <Accordion title="Unknown email results" icon="envelope-open-text">
    **Cause:** The mail server didn't respond or the domain is unverifiable.

    **Solution:**

    * `unknown` results are free — you are not charged
    * Retry validation later, or use Email Finder to verify the address
    * See [Email Validation docs](/docs/v1/reference/email-validation) for details
  </Accordion>
</AccordionGroup>

## Policies

* **Cancellation:** Cancel anytime under Settings > Billing. Access continues until end of billing cycle.
* **Refunds:** LeadMagic does not provide refunds. Contact [support@leadmagic.io](mailto:support@leadmagic.io) with billing concerns.
* **Data:** We don't store enriched data. All API traffic is encrypted via TLS 1.3.

<Tip>
  See our [Privacy Policy](https://leadmagic.io/legal/privacy) and [Terms of Service](https://leadmagic.io/legal/terms) for full details.
</Tip>

## Enterprise Support

<Note>
  Enterprise customers receive priority support with dedicated account management.
</Note>

<CardGroup cols={2}>
  <Card title="Priority Response" icon="bolt">
    Get responses within 2 hours during business hours.
  </Card>

  <Card title="Dedicated Slack Channel" icon="slack">
    Direct communication with our engineering team.
  </Card>

  <Card title="Custom Rate Limits" icon="gauge">
    Higher rate limits tailored to your needs.
  </Card>

  <Card title="Onboarding Support" icon="handshake">
    Personalized setup and integration assistance.
  </Card>
</CardGroup>

<Tip>
  Interested in enterprise support? [Contact us](mailto:support@leadmagic.io) to learn more.
</Tip>

## Feedback

We continuously improve our API and documentation based on your feedback.

<CardGroup cols={2}>
  <Card title="Feature Requests" icon="lightbulb" href="mailto:feedback@leadmagic.io">
    Have an idea for a new feature? We'd love to hear it.
  </Card>

  <Card title="Report a Bug" icon="bug" href="mailto:support@leadmagic.io">
    Found an issue? Let us know and we'll fix it ASAP.
  </Card>
</CardGroup>