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

# API Reference

> Complete API reference for MediAPI

## Base URL

```
https://api.ringbee.dev
```

## Authentication

Include your API key in every request:

```
X-API-Key: mk_live_abc123...
```

## Response format

All responses are JSON. Successful responses return `2xx` status codes. Errors return `4xx` or `5xx` with an `error` field:

```json theme={null}
{ "error": "Description of what went wrong" }
```

## Rate limits

| Plan       | Requests/min |
| ---------- | ------------ |
| Free       | 10           |
| Pro        | 60           |
| Business   | 300          |
| Enterprise | Unlimited    |

## Job lifecycle

```
pending → processing → completed
                     → failed
pending → cancelled
```

Jobs are processed asynchronously. Use polling (`GET /v1/jobs/{id}`) or webhooks to know when a job completes.