---
title: "Get stored Hear vocabulary"
method: GET
path: "/v1/hear/vocabulary"
tags: ["Speech To Text (Hear)"]
---

# Get stored Hear vocabulary

`GET /v1/hear/vocabulary`

## Request

- Base URL: `https://api.pyai.com`
- URL: `https://api.pyai.com/v1/hear/vocabulary`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Return the organization's stored custom vocabulary and its explicit activation profiles. Stored terms do not affect any transcription unless `enabled_for` includes `batch` or `hear_stream`. Requires the `hear:configure` scope.

## Response `200`

Stored Hear vocabulary settings

- HearVocabulary
  - `object` 'hear.vocabulary', required
  - `terms` string[], required: The sanitized effective stored list.
  - `enabled_for` string[], required
  - `updated_at` integer, nullable, required: Unix milliseconds, or null when no settings have been saved.

## Other responses

- `401`: Missing or invalid API key (`code: unauthorized`)
- `403`: Key lacks the required scope or the origin is not allow-listed (`code: forbidden | origin_not_allowed`)

---

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