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

# API Reference

> Build with CallKaro AI APIs

## Quick Start

Make your first API call in under 5 minutes.

<Steps>
  <Step title="Get your API key">
    Navigate to [Dashboard → API Key](https://callkaro.ai/dashboard/api-key) and copy your key
  </Step>

  <Step title="Make a test call">
    ```bash theme={null}
    curl -X POST https://api.callkaro.ai/call/outbound \
      -H "Content-Type: application/json" \
      -H "X-API-KEY: your_api_key_here" \
      -d '{
        "to_number": "+919876543210",
        "agent_id": "your_agent_id"
      }'
    ```
  </Step>

  <Step title="Check dashboard">
    Monitor your call in the [Call History](https://callkaro.ai/dashboard/call-history)
  </Step>
</Steps>

***

## Base URL

All API requests should be made to:

```
https://api.callkaro.ai
```

***

## Authentication

Include your API key in the `X-API-KEY` header for all requests:

```bash theme={null}
X-API-KEY: your_api_key_here
```

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

***

## Available Endpoints

<CardGroup cols={3}>
  <Card title="Outbound Call" icon="phone" href="/api-reference/outbound-call">
    Make individual calls
  </Card>

  <Card title="Campaign (v1)" icon="layer-group" href="/api-reference/campaign">
    Create campaigns with agent ID
  </Card>

  <Card title="Campaign (v2)" icon="layer-plus" href="/api-reference/campaign-v2">
    Create campaigns without agent ID
  </Card>
</CardGroup>

***

## Common Responses

### Success Response

```json theme={null}
{
  "status": "success",
  "message": "Call created successfully",
  "call_id": "abc123def456"
}
```

### Error Responses

| Status Code | Description                                 |
| ----------- | ------------------------------------------- |
| `400`       | Bad Request - Missing or invalid parameters |
| `403`       | Forbidden - Invalid or missing API key      |
| `404`       | Not Found - Agent doesn't exist             |
| `500`       | Internal Server Error                       |

```json theme={null}
{
  "status": "error",
  "message": "Missing required field: agent_id"
}
```

***

## Need Help?

<CardGroup cols={2}>
  <Card title="Support" icon="envelope" href="mailto:support@callkaro.ai">
    Email us at [support@callkaro.ai](mailto:support@callkaro.ai)
  </Card>

  <Card title="Dashboard" icon="browser" href="https://callkaro.ai/dashboard">
    Manage your agents and calls
  </Card>
</CardGroup>