API Reference

Welcome to the Talkover API Reference. This documentation provides information about all available endpoints, authentication methods, and integration examples.

Overview

The Talkover API enables you to:

Create and manage call flows - Design conversation paths
Initiate and control calls - Start conversations programmatically
Monitor call status - Track real-time call progress and outcomes
Access call analytics - Retrieve detailed performance metrics

Authentication

All API endpoints require authentication using Bearer tokens. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Keep your API key secure and never expose it in client-side code or public repositories.

Base URL

All API requests should be made to:

https://app.talkover.ai/api/v1

Rate limits

Standard Plan: 100 requests per minute
Professional Plan: 1,000 requests per minute
Enterprise Plan: Custom limits

Rate limit headers are included in all API responses to help you monitor usage.

Response Format

All API responses are returned in JSON format with the following structure:

{
  "success": true,
  "data": {
    // Response data
  },
  "message": "Operation completed successfully"
}

Error Handling

The API uses standard HTTP status codes and returns detailed error messages:

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid",
    "details": {}
  }
}

OpenAPI Specs

OpenAPI Specification

Download the complete OpenAPI specification

Getting Help

If you need assistance:

Documentation: Browse our guides and examples
Support: Contact us at [email protected]

Get Started

Concepts

Guides

API Reference

Overview

Authentication

Base URL

Rate limits

Response Format

Error Handling

OpenAPI Specs

OpenAPI Specification

Getting Help

​Overview

​Authentication

​Base URL

​Rate limits

​Response Format

​Error Handling

​OpenAPI Specs

OpenAPI Specification

​Getting Help

Overview

Authentication

Base URL

Rate limits

Response Format

Error Handling

OpenAPI Specs

Getting Help