---
title: "Poll the status of a therapy (or stuttering-classification) session. Returns 404 if the session is unknown or has exp…"
method: GET
path: "/api/therapy-status/{sessionId}"
tags: ["Therapy Planning"]
---

# Poll the status of a therapy (or stuttering-classification) session. Returns 404 if the session is unknown or has exp…

`GET /api/therapy-status/{sessionId}`

## Request

- Base URL: `https://platform.vocametrix.com`
- URL: `https://platform.vocametrix.com/api/therapy-status/{sessionId}`
- Auth: API key in header `X-API-Key`

## Path parameters

- `sessionId` string, required

## Response `200`

Successful response

- object
  - `success` boolean: Boolean.
  - `session_id` string: String — may be normalized from the input (the server does flexible lookup).
  - `status` string: "pending" | "processing" | "complete" | "pending_approval" | "failed".
  - `progress_percent` number: Number 0–100.
  - `progress` number: Number — alias for progress_percent (kept for back-compat).
  - `status_message` string: Free-form progress description.
  - `error_message` string: String, or null.
  - `created_at` string, date-time: ISO 8601 timestamp.
  - `updated_at` string, date-time: ISO 8601 timestamp.
  - `completed_at` string, date-time: ISO 8601 timestamp, or null until complete.
  - `result_available` boolean: Boolean — true when status is "complete" or "pending_approval".
  - `approval_required` boolean: Boolean — true when status is "pending_approval".
  - `generated_prompts` object[]: Array, or null. Workflow-internal prompts (mostly for debugging).
  - `timestamp` string, date-time: ISO 8601 server time.

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