API Reference

Base URL: https://api.dramwell.ai

The DramWell API is a RESTful API that provides programmatic access to all platform features. Authenticate with API keys and interact with resources across DramTrade, DramGuest, DramPulse, and more.

Overview

Introduction to the DramWell API

Authentication

API keys, JWT tokens, and OAuth flows

Errors

Error codes, types, and handling patterns

Pagination

Cursor-based and offset pagination

Webhooks

Event subscriptions and signature verification

Rate Limits

Request limits, headers, and best practices

Quick Example

List Customers

Returns a paginated list of customers for the authenticated organization.

GET /api/v1/customers

# cURL

curl https://api.dramwell.ai/v1/customers \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json"

# Response

{
  "data": [
    {
      "id": "cust_abc123",
      "name": "John Smith",
      "email": "john@example.com",
      "phone": "+15551234567"
    }
  ],
  "has_more": true,
  "cursor": "cust_abc124"
}