JSON REST API for contacts, companies, campaigns, enrichment, and pipeline. Bearer token auth, rate limited, CORS-ready.
Everything you need to make your first API call.
https://www.kolvera.io/api/v2/Authorization: Bearer kv_your_tokenX-RateLimit-Remaining, X-RateLimit-ResetRetry-After header valueRun this in your terminal to verify your token.
# Set your token from Settings > API Tokens
TOKEN=your_api_token_here
curl https://www.kolvera.io/api/v2/contacts?q=test \
-H "Authorization: Bearer $TOKEN"All 44 endpoints grouped by resource. All responses are JSON.
Search, create, update, delete contacts, and trigger enrichment.
| Method | Endpoint | Description |
|---|---|---|
| GET | /contacts |
List contacts. Supports q, page, per_page. |
| POST | /contacts |
Create a new contact. |
| GET | /contacts/{id} |
Get a single contact by ID. |
| PUT | /contacts/{id} |
Update a contact. Partial updates supported. |
| DELETE | /contacts/{id} |
Delete a contact. |
| POST | /contacts/{id}/find-email |
Trigger email enrichment for this contact. 2 credits on success. |
| POST | /contacts/{id}/find-phone |
Trigger phone enrichment. Credit cost varies by result type. |
| POST | /contacts/bulk |
Bulk action on multiple contacts (enrich, export). Pass ids array. |
Manage company records, trigger contact discovery and deep research.
| Method | Endpoint | Description |
|---|---|---|
| GET | /companies |
List companies. Supports q, page, per_page. |
| POST | /companies |
Create a new company record. |
| GET | /companies/{id} |
Get a single company by ID. |
| PUT | /companies/{id} |
Update company details. Partial updates supported. |
| DELETE | /companies/{id} |
Delete a company record. |
| POST | /companies/{id}/enrich |
Find contacts at this company. 2 credits per new contact found. |
| POST | /companies/{id}/research |
Trigger deep research on this company. 3 credits. |
Create and manage outreach campaigns, steps, and enrolment.
| Method | Endpoint | Description |
|---|---|---|
| GET | /campaigns |
List all campaigns. |
| POST | /campaigns |
Create a new campaign. |
| GET | /campaigns/{id} |
Get campaign details and stats. |
| PUT | /campaigns/{id} |
Update campaign settings. |
| GET | /campaigns/{id}/steps |
List all steps in a campaign sequence. |
| POST | /campaigns/{id}/steps |
Add a step to the campaign sequence. |
| POST | /campaigns/{id}/enrol |
Enrol one or more contacts in this campaign. |
| POST | /campaigns/{id}/activate |
Activate a draft campaign. |
Manage Ideal Client Profiles and their linked company lists.
| Method | Endpoint | Description |
|---|---|---|
| GET | /icp-profiles |
List all ICP profiles. |
| POST | /icp-profiles |
Create a new ICP profile. |
| GET | /icp-profiles/{id} |
Get profile details and criteria. |
| PUT | /icp-profiles/{id} |
Update profile criteria. |
| GET | /icp-profiles/{id}/companies |
List companies linked to this profile. |
Manage curated prospect lists and their members.
| Method | Endpoint | Description |
|---|---|---|
| GET | /hot-lists |
List all hot lists. |
| POST | /hot-lists |
Create a new hot list. |
| GET | /hot-lists/{id} |
Get hot list details and member count. |
| PUT | /hot-lists/{id} |
Update hot list name or description. |
| GET | /hot-lists/{id}/members |
List contacts in this hot list. |
| POST | /hot-lists/{id}/members |
Add one or more contacts to this hot list. |
Query scrape jobs and saved search configurations.
| Method | Endpoint | Description |
|---|---|---|
| GET | /pipeline/jobs |
List recent scrape jobs with status and results. |
| GET | /pipeline/jobs/{id} |
Get a single scrape job by ID. |
| GET | /pipeline/configs |
List saved scrape configurations. |
| POST | /pipeline/configs/{id}/run |
Trigger a saved scrape configuration to run. |
Trigger deep research jobs and retrieve generated reports.
| Method | Endpoint | Description |
|---|---|---|
| POST | /research/trigger |
Trigger a new deep research job. 3 credits. |
| GET | /research/reports |
List all deep research reports. |
| GET | /research/reports/{id} |
Get the full content of a research report. |
Query your workspace credit balance and transaction history.
| Method | Endpoint | Description |
|---|---|---|
| GET | /credits/balance |
Current plan credit balance and add-on balance. |
| GET | /credits/history |
Paginated credit transaction history. |
List connected sending inboxes for use in campaigns.
| Method | Endpoint | Description |
|---|---|---|
| GET | /inboxes |
List all connected sending inboxes with status. |
For building apps that authenticate Kolvera users on their behalf.
https://www.kolvera.io/oauth/authorizehttps://www.kolvera.io/oauth/tokencode_challenge and code_challenge_method=S256 for PKCEFree trial — 50 credits, no card required. Full API access on all paid plans.
Start free trial