Reseller API

Manage customers and organizations as a Scriptix reseller.

Overview

The Reseller API allows resellers to:

• Create and manage customer organizations
• Manage subscriptions and billing
• View usage statistics
• Access customer transcripts
• Manage API tokens
• Generate reports

Available to: Reseller and Enterprise accounts only

Base Endpoint

/api/v3/reseller

Quick Start

Create Customer

curl -X POST https://api.scriptix.io/api/v3/reseller/customers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corporation",
    "email": "admin@acme.com",
    "plan": "gold"
  }'

List Customers

curl https://api.scriptix.io/api/v3/reseller/customers \
  -H "Authorization: Bearer YOUR_API_KEY"

Get Customer Usage

curl https://api.scriptix.io/api/v3/reseller/customers/123/usage \
  -H "Authorization: Bearer YOUR_API_KEY"

Customer Object

{
  "id": 123,
  "name": "Acme Corporation",
  "email": "admin@acme.com",
  "plan": "gold",
  "status": "active",
  "usage": {
    "transcription_minutes": 450,
    "quota_minutes": 10000
  },
  "created_at": "2025-01-17T10:00:00Z"
}

Features

Customer Management

• Create, update, delete customers
• Manage subscriptions
• View usage and billing

API Tokens

• Generate customer API tokens
• Manage token permissions
• Revoke tokens

Usage Tracking

• Real-time usage statistics
• Historical usage data
• Export usage reports

Content Access

• View customer transcripts
• Access customer documents
• Download customer content

API Endpoints

Method	Endpoint	Description
POST	/api/v3/reseller/customers	Create customer
GET	/api/v3/reseller/customers	List customers
GET	/api/v3/reseller/customers/{id}	Get customer
PATCH	/api/v3/reseller/customers/{id}	Update customer
DELETE	/api/v3/reseller/customers/{id}	Delete customer
GET	/api/v3/reseller/customers/{id}/usage	Get usage stats
POST	/api/v3/reseller/tokens	Generate API token
GET	/api/v3/reseller/transcripts	List all transcripts
GET	/api/v3/reseller/transcripts/documents	List all documents

Customer Plans

Plan	Monthly Minutes	Custom Models	Priority Support
Bronze	500	❌	❌
Silver	2,000	❌	❌
Gold	10,000	✅	✅
Enterprise	Custom	✅	✅

Best Practices

1. Monitor Customer Usage

# Check usage regularly
usage = get_customer_usage(customer_id)
if usage['usage_percent'] > 80:
    notify_customer_quota_warning(customer_id)

2. Organize Customers

Use metadata to organize customers:

{
  "name": "Acme Corp",
  "metadata": {
    "segment": "enterprise",
    "industry": "healthcare",
    "account_manager": "john@reseller.com"
  }
}

3. Automate Reporting

Generate monthly usage reports automatically.

Next Steps

• Customers API - Customer management
• API Tokens - Token management
• Transcripts - Access customer content
• Data Models - Schema reference