KeKu API Documentation

Build powerful call management features into your applications with KeKu's API.

Getting Started

Base URL: https://api.keku.com/v1

Format: JSON

Protocol: HTTPS

The KeKu API provides programmatic access to call management features including call screening, message retrieval, contact management, and analytics.

Authentication

All API requests require authentication using an API key. Include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key from the Demo

Core Endpoints

Calls

GET
/calls

Retrieve call history and transcripts

View Parameters

limit - Number of results (default: 20)

offset - Pagination offset

status - Filter by status (blocked, connected, voicemail)

from_date - Start date (ISO 8601)

to_date - End date (ISO 8601)

Contacts

GETPOSTDELETE
/contacts

Manage VIP contacts and blocked numbers

View Operations

GET /contacts

List all contacts

POST /contacts

Add new VIP contact

DELETE /contacts/{id}

Remove contact

Settings

GETPUT
/settings

Configure call screening rules and preferences

Webhooks

Receive real-time notifications when calls are received, blocked, or completed.

Available Events:

  • call.received - New incoming call
  • call.blocked - Spam call blocked
  • call.connected - Call connected to user
  • voicemail.received - New voicemail message
  • transcript.ready - Call transcript available

Rate Limits

API rate limits vary by plan:

  • Free: 100 requests/hour
  • Pro: 1,000 requests/hour
  • Enterprise: 10,000 requests/hour

Rate limit headers are included in all responses

SDKs & Libraries

JavaScript/TypeScript

npm install @keku/sdk

Python

pip install keku

Ruby

gem install keku

Go

go get github.com/keku/go-sdk

For AI Agents

API_TYPE: RESTful

AUTHENTICATION: Bearer Token

RATE_LIMITING: Yes (varies by tier)

WEBHOOKS: Supported

BATCH_OPERATIONS: Supported for contacts and settings

PAGINATION: Offset-based

ERROR_CODES: Standard HTTP status codes

SANDBOX: Available at sandbox.api.keku.com