Quickstart

Get up and running with the Konver API in minutes. This guide will walk you through making your first API calls.

Prerequisites

Before you begin, make sure you have:

• A Konver account with API access
• An API key
• A tool to make HTTP requests (cURL, Postman, or your preferred programming language)

Base URL

All API requests should be made to your Konver API instance. The base URL will be provided by your administrator:

https://api.konver.ai/v1

Your First API Call

Let's start by retrieving a list of call lists from your organization.

cURL

curl -X GET "https://api.konver.ai/v1/call-list" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

JavaScript

const KONVER_API_KEY = process.env.KONVER_API_KEY;
const BASE_URL = 'https://api.konver.ai/v1';

async function getCallLists() {
  const response = await fetch(`${BASE_URL}/call-list`, {
    headers: {
      'X-Api-Key': KONVER_API_KEY,
      'Content-Type': 'application/json'
    }
  });

  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }

  return response.json();
}

// Usage
const callLists = await getCallLists();
console.log(`Found ${callLists.totalCount} call lists`);
callLists.items.forEach(list => {
  console.log(`- ${list.name} (${list.id})`);
});

Python

import os
import requests

KONVER_API_KEY = os.environ.get('KONVER_API_KEY')
BASE_URL = 'https://api.konver.ai/v1'

def get_call_lists():
    headers = {
        'X-Api-Key': KONVER_API_KEY,
        'Content-Type': 'application/json'
    }
    
    response = requests.get(f'{BASE_URL}/call-list', headers=headers)
    response.raise_for_status()
    
    return response.json()

# Usage
call_lists = get_call_lists()
print(f"Found {call_lists['totalCount']} call lists")
for call_list in call_lists['items']:
    print(f"- {call_list['name']} ({call_list['id']})")

C#

using System.Net.Http.Headers;
using System.Text.Json;

public class KonverClient
{
    private readonly HttpClient _client;
    private const string BaseUrl = "https://api.konver.ai/v1";

    public KonverClient(string apiKey)
    {
        _client = new HttpClient();
        _client.DefaultRequestHeaders.Add("X-Api-Key", apiKey);
    }

    public async Task<CallListResponse> GetCallListsAsync()
    {
        var response = await _client.GetAsync($"{BaseUrl}/call-list");
        response.EnsureSuccessStatusCode();
        
        var content = await response.Content.ReadAsStringAsync();
        return JsonSerializer.Deserialize<CallListResponse>(content);
    }
}

// Usage
var apiKey = Environment.GetEnvironmentVariable("KONVER_API_KEY");
var client = new KonverClient(apiKey);
var callLists = await client.GetCallListsAsync();

Console.WriteLine($"Found {callLists.TotalCount} call lists");
foreach (var list in callLists.Items)
{
    Console.WriteLine($"- {list.Name} ({list.Id})");
}

Example Response

{
  "totalCount": 3,
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "name": "Q1 2026 Prospects",
      "createdAt": "2026-01-28T14:30:00Z",
      "isLocked": false
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "name": "Enterprise Leads",
      "createdAt": "2026-01-25T09:15:00Z",
      "isLocked": false
    }
  ]
}

Next Steps

Now that you've made your first API calls, explore more:

• Error Handling — Handle API errors gracefully
• Rate Limiting — Understand API rate limits
• API Reference — Complete API documentation