API Introduction

const response = await fetch('https://your-domain.com/api/v1/conversations', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const conversations = await response.json();

curl https://your-domain.com/api/v1/conversations \
  -H "Authorization: Bearer YOUR_API_KEY"

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1701234567

{
  "data": {
    "id": "conv_123",
    "status": "open",
    "customer": {
      "name": "John Smith",
      "phone": "+1234567890"
    }
  },
  "meta": {
    "timestamp": "2025-11-29T10:30:00Z"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Phone number is required",
    "field": "phone"
  }
}

GET /api/v1/conversations?page=2&limit=50

{
  "data": [...],
  "meta": {
    "page": 2,
    "limit": 50,
    "total": 247,
    "pages": 5
  }
}