---
title: "Calculate multi-band HNR with gender-specific F0 notes (no dysphonia verdict)"
method: GET
path: "/api/calculate-hnr-multiband"
tags: ["Voice Quality Metrics"]
---

# Calculate multi-band HNR with gender-specific F0 notes (no dysphonia verdict)

`GET /api/calculate-hnr-multiband`

## Request

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

## Query parameters

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

## Response `200`

Successful response

- object
  - `HNR_FULL` number: Full-spectrum HNR (80-8000 Hz) in dB. Example: 15.4
  - `HNR_LOW` number: Low-frequency HNR (80-500 Hz) in dB. Example: 18.2
  - `HNR_MID` number: Mid-frequency HNR (500-1500 Hz) in dB. Example: 16.8
  - `HNR_HIGH` number: High-frequency HNR (1500-3500 Hz) in dB. Example: 12.3
  - `MEAN_F0` number: Mean fundamental frequency in Hz, null if pitch detection fails. Example: 195.4
  - `F0_STD` number: Standard deviation of F0. Example: 8.5
  - `GENDER` string: Gender classification result. Example: "Female"
  - `NOISE_RATIO_LOW` number: Low-frequency noise percentage. Example: 12.5
  - `NOISE_RATIO_MID` number: Mid-frequency noise percentage. Example: 18.2
  - `NOISE_RATIO_HIGH` number: High-frequency noise percentage. Example: 25.7
  - `HNR_SLOPE` number: Spectral tilt across frequency bands. Example: -0.68
  - `OVERALL_QUALITY` string: Not classified, with reference norms. Example: "Not classified (no validated cutoff to our knowledge). Norms for sustained /a/ about 21-24.5 dB (Banh 2009)"
  - `SEVERITY` string: No severity classification (no validated cutoff to our knowledge). Example: "Not classified (no validated cutoff to our knowledge)"
  - `NOISE_PATTERN` string: Dominant noise pattern classification. Example: "Distributed noise pattern"
  - `BREATHINESS` string: No breathiness classification (no validated cutoff for band HNR, to our knowledge). Example: "Not classified (no validated cutoff for band HNR, to our knowledge)"
  - `PATIENT_AGE` integer: Patient age used in analysis. Example: 35
  - `PATIENT_GENDER` string: Patient gender classification. Example: "Female"
  - `AGE_GROUP` string: Age group classification. Example: "Young adult (18-44)"
  - `AGE_NOTE` string: Age-related note (context only). Example: "Adult voice patterns expected"
  - `F0_NOTE` string: F0 validation note. Example: "F0 within expected range for gender/age"
  - `GENDER_NOTE` string: Gender-specific note. Example: "F0 consistent with reported gender"
  - `EXPECTED_F0_MIN` number: Expected minimum F0 for age/gender. Example: 165.4
  - `EXPECTED_F0_MAX` number: Expected maximum F0 for age/gender. Example: 294.3
  - `HNR_ADJUSTMENT` integer: Always 0 (no age adjustment), kept for API compatibility. Example: 0
  - `ADJUSTED_HNR_FULL` number: Equal to HNR_FULL (no age adjustment), kept for API compatibility. Example: 15.4

## 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)