---
title: "Analyzes voice range profile from sustained vowel glissando recording"
method: GET
path: "/api/calculate-ambitus"
tags: ["Advanced Voice Analysis"]
---

# Analyzes voice range profile from sustained vowel glissando recording

`GET /api/calculate-ambitus`

## Request

- Base URL: `https://platform.vocametrix.com`
- URL: `https://platform.vocametrix.com/api/calculate-ambitus`
- Auth: API key in header `X-API-Key`

## Query parameters

- `svFileId` string, binary, required
- `age` integer, required
- `gender` 1 | 2 | 3, required

## Response `200`

Successful response

- object
  - `AMBITUS_SEMITONES` string: Voice range in semitones (12 × log₂(F0_max/F0_min))
  - `AMBITUS_OCTAVES` string: Voice range in octaves (semitones ÷ 12)
  - `FREQUENCY_RATIO` number: Ratio of highest to lowest frequency (F0_max/F0_min)
  - `RANGE_CLASSIFICATION` string: Age-appropriate range assessment (Excellent/Normal/Reduced/Severely reduced)
  - `F0_MIN` number: Minimum fundamental frequency in Hz
  - `F0_MAX` number: Maximum fundamental frequency in Hz
  - `F0_MEAN` number: Mean fundamental frequency in Hz
  - `F0_MEDIAN` number: Median fundamental frequency in Hz
  - `PATIENT_AGE` string: Patient age used in analysis
  - `PATIENT_GENDER` string: Patient gender (Male/Female)
  - `AGE_GROUP` string: Age category (Child/Adolescent/Adult)
  - `PITCH_FLOOR` number: Lower limit for pitch tracking in Hz
  - `PITCH_CEILING` number: Upper limit for pitch tracking in Hz
  - `ANALYSIS_METHOD` string: Analysis technique used (vocal range, F0 only)

## Other responses

- `400`: Bad request — missing or invalid parameter
- `401`: Unauthorized — missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Server error

---

[API](https://skmtc.dev/vocametrix/apis/vocametrix-api.md) · [All operations](https://skmtc.dev/vocametrix/apis/vocametrix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vocametrix/apis/vocametrix-api/revisions/8a54d01bcc81?raw)