API Reference
Overview
Base URL, bearer-token authentication, conventions (UUIDs, ISO 8601, limit/offset pagination) and the full endpoint list for the Specala AI REST API.
The Specala AI REST API is a small, predictable HTTP API. All endpoints live under one base URL and use the same bearer-token authentication.
Base URL
https://app.specala.ai/api/v1/developerAuthentication
Every request needs an Authorization header with your sk_live_ key:
Authorization: Bearer sk_live_your_key_hereSee Authentication for keys, scopes and rate limits.
Conventions
- IDs are UUIDs. Transcriptions, projects and workspaces are identified by UUID.
- Timestamps are ISO 8601, UTC (e.g.
2026-05-20T09:14:00Z). - Responses are JSON, except export endpoints which return files.
- Pagination uses
limit(max 100) andoffset. - Errors return a JSON body with an HTTP status code — see Errors.
- Caching: responses are sent with
Cache-Control: no-store.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /projects | List projects (to get project_id for filtering) |
GET | /transcriptions | List transcriptions (filter, sort, paginate) |
GET | /transcriptions/{id} | Get one transcription with full text + reports |
GET | /transcriptions/{id}/export | Export one transcription as .md / .txt |
POST | /transcriptions/export | Export up to 100 transcriptions as a ZIP |
API-key management (create / list / revoke) is done in the web app under Settings → API & MCP, not through this API.