---
title: "Perform pronunciation assessment on uploaded audio"
method: POST
path: "/api/pronunciation-assessment"
tags: ["Core Speech Analysis"]
---

# Perform pronunciation assessment on uploaded audio

`POST /api/pronunciation-assessment`

## Request

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

## Request body

- object
  - `blobURL` string, required: The secure URL received from get-blob-url endpoint
  - `referenceText` string, required: The text to compare against the audio
  - `locale` string, required: The language locale (e.g., en-US, fr-FR)

## Response `200`

Successful response

- object
  - `accuracyScore` number: Phoneme-level pronunciation accuracy score (0-100)
  - `fluencyScore` number: Natural speech flow and timing score (0-100)
  - `completenessScore` number: Coverage of reference text score (0-100)
  - `prosodyScore` number: Speech qualities assessment score (0-100)
  - `pronScore` number: Overall weighted pronunciation score
  - `error` string: Error details with specific rejection reasons if applicable

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