phone-calling

# Ringez Phone Calling API

Make affordable international phone calls from anywhere. No hidden fees, no subscriptions — just pay for the minutes you use.

## What is Ringez?

Ringez is a simple, privacy-focused international calling service that lets you make phone calls to 200+ countries without complicated setups or expensive plans.

**Perfect for:**
- Calling family abroad
- Business calls to international clients
- AI agents making reservations or appointments
- Quick calls without buying a calling plan

---

## Quick Start Guide

### 1. Create an Account

First, check if your email is already registered:

```http
POST https://ringez-api.vercel.app/api/v1/auth/check-email
Content-Type: application/json

{"email": "you@example.com"}
```

**Response:**
- `new_user` → Continue to OTP verification
- `existing_user` → Login with password

#### For New Users: Verify with OTP

**Step 1:** Request OTP
```http
POST https://ringez-api.vercel.app/api/v1/auth/send-otp
Content-Type: application/json

{"email": "you@example.com"}
```

**Step 2:** Verify OTP
```http
POST https://ringez-api.vercel.app/api/v1/auth/verify-otp
Content-Type: application/json

{
  "email": "you@example.com",
  "otp": "123456"
}
```

**Response:**
```json
{
  "session_id": "sess_abc123xyz",
  "user": {
    "email": "you@example.com",
    "balance_minutes": 5
  }
}
```

Save the `session_id` — you will need it for all API calls.

#### For Existing Users: Login

```http
POST https://ringez-api.vercel.app/api/v1/auth/login
Content-Type: application/json

{
  "email": "you@example.com",
  "password": "your-password"
}
```

---

### 2. Check Your Balance

See how many minutes you have before making a call:

```http
GET https://ringez-api.vercel.app/api/v1/auth/me
X-Session-ID: sess_abc123xyz
```

**Response:**
```json
{
  "balance_minutes": 5,
  "balance_usd": 0,
  "email": "you@example.com"
}
```

---

### 3. Make a Phone Call

Use the `idempotency_key` to prevent accidental duplicate calls:

```http
POS...