> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.virtuosis.ai/v-1-2/api-reference/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.virtuosis.ai/_mcp/server.

# API Reference

> Machine-readable reference for the Virtuosis REST API v1.2.

The Virtuosis REST API v1.2 lets third-party applications create user accounts, upload Base64-encoded audio recordings, poll health analysis results, and inspect recording usage.

## Environments

| Environment | Base URL                        | Purpose                                      |
| ----------- | ------------------------------- | -------------------------------------------- |
| Production  | `https://api.virtuosis.ai/v1.2` | Live integrations and production recordings. |

## Authentication

All requests require a bearer token:

```http
Authorization: Bearer <API_KEY>
```

Requests with JSON bodies must also include:

```http
Content-Type: application/json
```

## Processing guidance

* Create one account per user.
* Upload audio as a Base64-encoded string in the JSON `audio` field.
* Specify which analysis types to run (`wellbeing`, `parkinsons`, `alzheimers`). The `analysis` array is required and must contain at least one type.
* Do not send multipart file uploads to the recording endpoint.
* Use at least 30 seconds of free speech. If needed, prompt the speaker with an open-ended question such as "How's your day going?" or "Can you introduce yourself?"
* Poll analysis results every 15 to 30 seconds.
* Do not poll more frequently than every 5 seconds.
* Use a five-minute timeout for analysis processing.

## Error guidance

All endpoints use the same error response shape. Error `type` values are documented in the OpenAPI schema and may expand over time. Internal server errors may not include a detailed message, but are recorded by Virtuosis error tracking for debugging.

> Integrate the Virtuosis AI voice biomarker API to upload speech recordings and retrieve health, wellbeing, and communication insights.


## API Docs

- API Reference > Accounts [Create an account](https://docs.virtuosis.ai/api-reference/accounts/create-account.md)
- API Reference > Recordings [Upload a recording for analysis](https://docs.virtuosis.ai/api-reference/recordings/upload-recording.md)
- API Reference > Recordings [Get analysis results for a recording](https://docs.virtuosis.ai/api-reference/recordings/get-recording-analysis.md)
- API Reference > Usage [Get analysis usage for the organisation](https://docs.virtuosis.ai/api-reference/usage/get-recordings-usage.md)
- API Reference [Health check](https://docs.virtuosis.ai/api-reference/ping.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.virtuosis.ai/v-1-2/api-reference/openapi.json)
- [OpenAPI YAML](https://docs.virtuosis.ai/v-1-2/api-reference/openapi.yaml)