# 02 getting started

\# Getting Started

\> Go from zero to your first enriched contact in under two minutes.

\## 1. Create your account

Sign up at \[app.leadsonar.io]\(<https://app.leadsonar.io>). You get \*\*3,000 free credits\*\* on email verification — enough to test the full platform.

\## 2. Generate an API key

Go to \*\*Settings > API Keys\*\* and click \*\*Create Key\*\*. Copy the key — you will not see it again.

\## 3. Make your first request

Find the work email for a contact:

\`\`\`bash curl -X POST <https://app.leadsonar.io/api/v1/find-email\\>
-H "Authorization: Bearer YOUR\_API\_KEY"\
-H "Content-Type: application/json"\
-d '{ "firstName": "Jane", "lastName": "Smith", "company": "Stripe", "website": "stripe.com" }' \`\`\`

Response:

\`\`\`json { "email": "<jane.smith@stripe.com>", "confidence": "high", "sources": 3, "credits\_used": 1 } \`\`\`

That is it. One credit, one verified email.

\## Authentication

Every request requires an API key in the \`Authorization\` header:

\`\`\` Authorization: Bearer YOUR\_API\_KEY \`\`\`

API keys have the same permissions as your account. Keep them secret — rotate them in Settings if compromised.

\## Base URL

\`\`\` <https://app.leadsonar.io/api/v1> \`\`\`

All API endpoints are under this base path.

\## Credits

LeadSonar uses a credit-based system. Every enrichment lookup costs credits:

\| Operation | Credit cost | |-----------|-------------| | Email lookup | 1 credit | | Phone lookup | 1 credit | | Lead search | Free | | AI lead scoring | 1 credit per lead | | Bulk enrichment | 1 credit per contact |

Check your balance at any time:

\`\`\`bash curl <https://app.leadsonar.io/api/v1/credits\\>
-H "Authorization: Bearer YOUR\_API\_KEY" \`\`\`

\## Rate limits

The API enforces per-account rate limits to ensure fair usage. If you exceed the limit, you will receive a \`429 Too Many Requests\` response. Wait and retry.

\## Next steps

\- \[API Reference]\(./03-api-reference.md) — full endpoint documentation - \[Bulk Enrichment]\(./04-bulk-enrichment.md) — enrich hundreds of contacts at once - \[AI Lead Scoring]\(./05-ai-lead-scoring.md) — grade leads against your ICP - \[Pricing & Plans]\(./06-pricing.md) — credit packages and subscriptions


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://scalingroom.gitbook.io/leadsonar-docs/02-getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.