API Reference

Complete reference for all Destined Voice API endpoints

Base URL

https://api.destined.ai

Authentication

Most endpoints require Bearer token authentication:

Authorization: Bearer YOUR_API_KEY

Response Format

All responses are JSON with this structure:

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

Error Format

{
  "detail": "Error message here",
  "status_code": 400,
  "request_id": "req_abc123"
}

Status Codes

Code	Description
200	Success
201	Created
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid/missing API key
403	Forbidden - Insufficient permissions
404	Not Found - Resource doesn’t exist
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error

Pagination

List endpoints support pagination:

GET /v1/speakers?limit=20&offset=40

Parameter	Type	Default	Description
limit	integer	20	Items per page (max 100)
offset	integer	0	Number of items to skip

Response includes pagination metadata:

{
  "items": [...],
  "total": 2400,
  "limit": 20,
  "offset": 40,
  "has_more": true
}

Rate Limits

Tier	Requests/min	Requests/day
Starter	60	1,000
Pro	300	10,000
Enterprise	1,000	Unlimited

Rate limit headers in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1705312260

Endpoint Groups

Health

API status and health checks

Speakers

Browse 2,400+ speaker voices

TTS Generation

Generate speech from text

Jobs

Track batch processing jobs

STT Testing

Evaluate STT providers

Datasets

Import CSV for bulk generation

Users

Profile and usage info

Billing

Subscription management