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

# API Reference

> Programmatically manage calls, contacts, and SMS with the Recepta API

## Overview

The Recepta API is a REST API that lets you integrate Recepta into your own applications, CRMs, AI agents, and automation workflows.

**Base URL:** `https://api.recepta.ai/api/v1`

## Authentication

All endpoints require an API key in the `x-api-key` header:

```
x-api-key: rcp_your_api_key_here
```

Create and manage API keys in **Settings > API Keys** in the Recepta dashboard.

## Rate Limits

| Plan       | Requests / Minute |
| ---------- | ----------------- |
| Free       | 30                |
| Starter    | 60                |
| Growth     | 300               |
| Enterprise | 1,000             |

Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` headers. Exceeding the limit returns `429 Too Many Requests` with a `Retry-After` header.

## Errors

All errors use this format:

```json theme={null}
{
  "success": false,
  "message": "Human-readable error description"
}
```

| Code | Meaning                                       |
| ---- | --------------------------------------------- |
| 400  | Bad Request — invalid or missing parameters   |
| 401  | Unauthorized — invalid or missing API key     |
| 403  | Forbidden — API key lacks required permission |
| 404  | Not Found — resource does not exist           |
| 429  | Rate Limited — too many requests              |
| 500  | Server Error — try again later                |