API reference

The OriginalVoices REST API. Every endpoint takes and returns JSON.

https://api.originalvoices.ai

Authentication

Create a key under Developers → API Keys in the platform, and send it on every request:

Authorization: Bearer YOUR_API_KEY

Responses

Every response has the same envelope. On success, error is null. On failure, data is null and error has a message and code. See Errors & limits.

{ "requestId": "…", "data": { … }, "error": null }

Endpoints

Method	Endpoint	What it does
POST	/v1/ask	Ask questions
GET	/v1/audiences	List audiences
POST	/v1/audiences	Create an audience
PATCH	/v1/audiences/{id}	Rename an audience
DELETE	/v1/audiences/{id}	Delete an audience
GET	/v1/studies	List studies
GET	/v1/studies/{studyId}/participants	List participants

Using Postman or generating a client? Import the OpenAPI spec.