# AI Ark Documentation

> Documentation for AI Ark

## Get Started: GET STARTED
- [Quickstart](https://docs.ai-ark.com/docs/get-started.md)
- [AI Agents (API Context)](https://docs.ai-ark.com/docs/ai-agents.md)

## API Reference: Search
- [People Search API](https://docs.ai-ark.com/reference/people-search-1.md): Searches 400+ million enriched, verified and active person profiles using contact and/or account (company) filters — the starting point for building outbound lead lists. Each result contains the full…
- [People Preview](https://docs.ai-ark.com/reference/people-preview.md): Run any People Search for a flat <strong>1 credit per page</strong> and see who matches before spending per-result credits — the recommended first call of every list-building workflow. Validate your…
- [Company Search API](https://docs.ai-ark.com/reference/company-search-1.md): Searches 70+ million enriched, verified and active company profiles using account filters — ideal for building target-account (ABM) lists. Includes <strong>Lookalike Search</strong>: pass up to 5…
- [Create or Update a List](https://docs.ai-ark.com/reference/save-list.md): Build reusable lists of people or companies, then reference them from <a href="/reference/people-search-1">People Search</a>, <a href="/reference/company-search-1">Company Search</a> and <a…

## API Reference: Export Single Person with Email
- [Export Single Person with Email](https://docs.ai-ark.com/reference/people-export-single.md): Exports a single person with email finding in real time — built for row-by-row enrichment (CRM records, spreadsheets, Clay tables). Returns the full person profile plus a verified email. <br/><br/>…
- [Export Single Person with Email (V2 - Clay Compatible)](https://docs.ai-ark.com/reference/people-export-single-v2.md): V2 of <a href="/reference/people-export-single">Export Single Person with Email</a> — <strong>Clay-compatible</strong>. Behaves exactly like <code>/v1/people/export/single</code>, except that when…

## API Reference: Export People with Email
- [Export People with Email](https://docs.ai-ark.com/reference/people-export-with-email.md): Search and email finding in a single asynchronous call: exports up to <strong>10,000</strong> people matching the same account and contact filters as the <a href="/reference/people-search-1">People…
- [Export People Results API](https://docs.ai-ark.com/reference/export-people-results-by-track-id.md): 💳 <strong>Credit Usage:</strong> Free — fetching results never costs credits (you already paid at submission). Paginate with <code>page</code> (zero-based) and <code>size</code> (1–100, default 10).…
- [Export People Statistics](https://docs.ai-ark.com/reference/get-export-people-statistics-by-track-id.md): 💳 <strong>Credit Usage:</strong> Free — polling never costs credits (you already paid at submission). Use this to track <code>state</code> and <code>statistics</code> until the job is…
- [Export People Submissions](https://docs.ai-ark.com/reference/get-export-people-submissions.md): 💳 <strong>Credit Usage:</strong> Free. Your own submission history, including refund status (<code>fullyRefunded</code>, <code>refundReason</code>: <code>STUCK_SOFT_REFUND</code> /…
- [Export People Webhook Payload](https://docs.ai-ark.com/reference/export-people-webhook.md)
- [Resend Export People Webhook](https://docs.ai-ark.com/reference/resend-export-people-webhook-1.md): 💳 <strong>Credit Usage:</strong> Free. Re-sends the completion webhook for a <code>trackId</code> to the URL you specify — use it when the initial delivery (auto-retried 3×) failed or you need to…

## API Reference: Find Emails by Track ID
- [Find Emails by Track ID](https://docs.ai-ark.com/reference/people-email-finder-by-track-id.md): Triggers email finding for a previous People Search result set, using the <code>trackId</code> from the <a href="/reference/people-search-1">People Search API</a> response. This is step 2 of the…
- [Email Finder Results API](https://docs.ai-ark.com/reference/get-email-finder-results-by-track-id.md): 💳 <strong>Credit Usage:</strong> Free — fetching results never costs credits (you already paid at submission). Paginate with <code>page</code> (zero-based) and <code>size</code> (1–100, default 10).…
- [Email Finder Statistics](https://docs.ai-ark.com/reference/get-email-finder-statistics-by-track-id.md): 💳 <strong>Credit Usage:</strong> Free — polling never costs credits (you already paid at submission). Use this to track <code>state</code> and <code>statistics</code> until the job is…
- [Email Finder Submissions](https://docs.ai-ark.com/reference/get-email-finder-submissions.md): 💳 <strong>Credit Usage:</strong> Free. Your own submission history, including refund status (<code>fullyRefunded</code>, <code>refundReason</code>: <code>STUCK_SOFT_REFUND</code> /…
- [Find Emails Webhook Payload](https://docs.ai-ark.com/reference/find-emails-webhook.md)
- [Resend Email Finder Webhook](https://docs.ai-ark.com/reference/resend-email-finder-webhook-1.md): 💳 <strong>Credit Usage:</strong> Free. Re-sends the completion webhook for a <code>trackId</code> to the URL you specify — use it when the initial delivery (auto-retried 3×) failed or you need to…

## API Reference: Mobile Finder
- [Mobile Phone Finder API](https://docs.ai-ark.com/reference/people-mobile-phone-finder.md): Finds mobile phone numbers for a person — use it to add direct-dial numbers to your outbound lists. <br/> <strong>Search Options:</strong> <br/> &nbsp;&nbsp;&nbsp;&nbsp;• <strong>LinkedIn…
- [Mobile Phone Finder API (V2 - Clay Compatible)](https://docs.ai-ark.com/reference/people-mobile-phone-finder-v2.md): V2 of the <a href="/reference/people-mobile-phone-finder">Mobile Phone Finder</a> — <strong>Clay-compatible</strong>. Behaves exactly like <code>/v1/people/mobile-phone-finder</code>, except that…

## API Reference: Intelligence
- [Personality Analysis API](https://docs.ai-ark.com/reference/people-analysis.md): Analyzes the skills, headline, and summary of a profile and returns a complete personality profile with ready-to-apply outreach guidance: <strong>DISC</strong> and <strong>OCEAN (Big Five)</strong>…
- [Reverse People Lookup API](https://docs.ai-ark.com/reference/people-reverse-lookup.md): Identifies a person from an <strong>email address</strong>: if a person with that email exists in the AI Ark database, you get back their full profile (name, title, company, LinkedIn, and more) —…

## API Reference: Credits
- [Fetch Your Credit](https://docs.ai-ark.com/reference/fetch-credit.md): Retrieves the number of remaining credits in your account. <br/><br/> 💳 <strong>Credit Usage:</strong> Free — this endpoint never costs credits. Call it before large jobs to make sure your balance…

## API Reference: MCP
- [MCP Server](https://docs.ai-ark.com/reference/mcp.md)

## API Reference: CLI
- [Command Line](https://docs.ai-ark.com/reference/cli.md): Install the ark command, store your API key and run searches, exports and enrichment from a terminal or a script.