V1 Client APIs

Sign up as a new user or sign back in to retrieve your API key. Sends a 6-digit verification code to the provided email address. After receiving the code, call the verify endpoint to complete authentication and receive your API key. - **New users**: creates your account. API key is issued after verification. - **Existing users**: use this to recover your API key if lost. Verify with the OTP to get your existing key back.

Verify your email with the 6-digit code sent during sign-up. On success, returns your API key: - **New users**: a freshly generated API key for your account. - **Existing users**: your existing API key is returned (use this to recover a lost key). The verification code expires after 24 hours. You have up to 10 attempts per code. If you exhaust all attempts, call sign-up again to receive a new code.

List accounts with optional filters and pagination. **Request Body (optional):** - **filters**: Filter accounts by CRM status, employee count, funding stage, etc. - **pagination**: Control page size (limit) and offset for pagination. - limit: 1-500, default 50 - offset: default 0

Search accounts by name or domain with fuzzy matching.

Search for companies by describing their traits or characteristics. Use natural language to find companies matching specific criteria like: - **Industry**: "healthcare companies", "fintech startups" - **Products**: "companies with voice AI products", "payment processing platforms" - **Business model**: "B2B SaaS companies", "companies that sell to restaurants" - **Technology**: "companies using Kubernetes", "AI-first startups" Returns companies ranked by relevance with similarity scores.

Discovery endpoint for the firmographic filters accepted by the lookalike search endpoints — `GET /api/v1/account/search-lookalikes` (sync) and `POST /api/v1/account/search-lookalikes-bulk` (async): - **min_employees / max_employees** — inclusive integer bounds (>= 0, no upper limit). - **funding_stages** — the exact stage labels accepted; input is matched case-insensitively and canonicalized to these. - **locations** — supported HQ-country filters as `{code, name}`; pass the ISO 3166-1 alpha-3 `code` (e.g. `USA`, `GBR`) in `locations`. Static and fast — mirrors `GET /api/v2/tech/country-options`. Use it to populate filter pickers or to validate input before calling search.

Free, fast company search for finding lookalike accounts.

Start an async bulk lookalike search (up to 10000 companies). Returns a ``job_id`` immediately. Poll ``GET /api/v1/account/search-lookalikes-bulk/{job_id}`` for status and to page through results. Cancel a running job with ``POST /api/v1/account/search-lookalikes-bulk/{job_id}/cancel``. Credits are pre-checked against the requested ``limit`` here, then charged on the actual returned count when the job completes (or the delivered count if cancelled).