> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Complete API documentation for Talkover voice conversation platform

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:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

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

## 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

<Info>
  Rate limit headers are included in all API responses to help you monitor usage.
</Info>

## Response Format

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

```json theme={null}
{
  "success": true,
  "data": {
    // Response data
  },
  "message": "Operation completed successfully"
}
```

## Error Handling

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

```json theme={null}
{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid",
    "details": {}
  }
}
```

## OpenAPI Specs

<Card title="OpenAPI Specification" icon="file-text" href="/api-reference/openapi.json">
  Download the complete OpenAPI specification
</Card>

## Getting Help

If you need assistance:

* **Documentation**: Browse our guides and examples
* **Support**: Contact us at [contact@talkover.ai](mailto:contact@talkover.ai)