Dolva API Reference: Base URL, Auth, and Endpoints

The Dolva API is a REST API that accepts audio file uploads and returns JSON analysis results. All endpoints are available at https://api.dolva.ai.

Base URL

https://api.dolva.ai

The current API version is v1. All analysis endpoints are prefixed with /v1/.

All analysis endpoints require a Bearer token in the Authorization header:

Authorization: Bearer dv-xxxxxxxx

The GET /health endpoint does not require authentication. See Authentication for full details on obtaining and using your token.

Analysis endpoints accept multipart/form-data requests. Include your audio file in the audio field:

Field	Type	Required	Description
`audio`	binary (file)	Yes	The audio file to analyze

All endpoints return application/json. Successful responses have HTTP status 200.

Analyze cognitive signals from an audio file.

Analyze emotional signals from an audio file.

Check API availability.

Status	Description
`401 Unauthorized`	Missing or invalid Bearer token
`403 Forbidden`	Token valid but lacks permissions
`422 Unprocessable Entity`	Validation error — see error body for details
`500 Internal Server Error`	Server-side error — retry with backoff

When a 422 is returned, the response body contains a structured error object:

{
  "detail": [
    {
      "loc": ["body", "audio"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}

See Error Handling for guidance on handling these errors in your code.