> This page is for version v1.2.
> For other versions, use one of these documentation indexes:
> - v1.3 (default): https://docs.virtuosis.ai/v-1-3/llms.txt
> - v1.2: https://docs.virtuosis.ai/v-1-2/llms.txt

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

# Virtuosis API Documentation

> Overview of the public Virtuosis REST API for uploading audio recordings and retrieving health analysis results.

The Virtuosis REST API lets third-party applications upload Base64-encoded audio recordings to Virtuosis and retrieve health analysis results after processing.

> **Warning**
>
> v1.2 is deprecated. Migrate to [v1.3](https://api.virtuosis.ai/v1.3). Responses carry a `Deprecation` header plus a `Link` to the successor version.

## API flow

1. Create an account for the user.
2. Upload a Base64-encoded recording, specifying which analysis types to run.
3. Poll for analysis results until processing completes.

## Base URL

```text
https://api.virtuosis.ai/v1.2
```

## What the API covers

* How to authenticate with the API.
* How to create accounts, upload recordings, poll analysis results, and inspect usage.
* Audio requirements for analysis processing.
* Supported analysis types: wellbeing, Parkinson's, and Alzheimer's.
* Shared API error response structure and error types.

## Required inputs

| Input         | Description                                      |
| ------------- | ------------------------------------------------ |
| API key       | Sent as `Authorization: Bearer <API_KEY>`.       |
| Audio file    | Base64-encoded WAV, MP3, MP4, or OGG recording.  |
| `recorded_at` | ISO 8601 timestamp for when the recording began. |

## Key facts

* Public API version: `v1.2`.
* API base URL: `https://api.virtuosis.ai/v1.2`.
* API authentication: `Authorization: Bearer <API_KEY>`.
* Maximum upload size: 50 MB.
* Recommended analysis polling interval: 15 to 30 seconds.
* Analysis processing may take up to five minutes.
* Available analysis types: `wellbeing`, `parkinsons`, `alzheimers`. The `analysis` array is required and must list at least one type.

## Recording guidance

Recordings should contain at least 30 seconds of free speech. If the recording is not part of a broader conversation, prompt the speaker with a short open-ended question such as:

* How's your day going?
* Can you introduce yourself?

Upload the audio file as a Base64-encoded string in the `audio` request field. The API does not accept a multipart file upload for this endpoint.

## LLM and tool usage

Use the OpenAPI exports when configuring an LLM agent or integration tool:

* [OpenAPI JSON](/openapi.json)
* [OpenAPI YAML](/openapi.yaml)
* [LLMs index](/llms.txt)

When implementing from the schema, preserve the three-step flow: create an account, upload a recording, then poll for analysis results. Do not infer additional endpoints, non-production hosts, multipart uploads, or diagnosis workflows.

## User-interface disclaimer

Applications that display Virtuosis outputs must include this disclaimer in the user interface:

> Not intended to provide a medical diagnosis or to replace clinical judgment. Outputs are for clinical decision support and must be interpreted by a qualified healthcare professional.

## Legal manufacturer information

Virtuosis provides logo assets in multiple formats and variants, as well as CE marking documentation. See [Guidelines and Assets](/guidelines) for downloadable assets and implementation requirements.