Words proposed for the organization's vocabulary: members' names, the names of assistants and projects, and words several colleagues learned from their own corrections. Words learned by the most colleagues come first. Needs the right to manage the team vocabulary.
state string optional
Only this state: pending, approved, dismissed or shared.
source string optional
Only this source: people, assistant, project or learned.
limit integer optional · Defaults to 50
Page size, 1 to 200.
offset integer optional · Defaults to 0
Suggestions to skip, up to 10000.
object string
Always list.
data array
The suggestions:
id string
The suggestion ID (vsug_…).
term string
The proposed word, as it is written.
language string or null
The language tag; null for all languages.
source string
people (a member's name), assistant (an assistant shared with the organization), project (a project name) or learned (colleagues who corrected their own transcripts).
people_count integer or null
How many colleagues learned the word; set for learned only.
sounds_like array of strings
How the word was heard before it was corrected.
state string
pending, approved, dismissed, or shared when written automatically.
decided_by_user_id string or null
Who decided, if anyone.
decided_at string or null
When it was decided.
list_id string or null
The list the word was written into.
entry_id string or null
The entry that was written.
refreshed_at string
When the suggestion was last refreshed.
total integer
How many suggestions match the filters.
last_refreshed_at string or null
When suggestions were last refreshed; null if never.
- Bash
- Python
- JavaScript
curl -X GET "https://api.aitronos.com/v1/vocabulary/suggestions?state=pending" \
-H "X-API-Key: $FREDDY_API_KEY"Response:
{
"object": "list",
"data": [
{
"id": "vsug_4e8b2d6f1a3c5097",
"term": "Kubernetes",
"language": null,
"source": "learned",
"people_count": 4,
"sounds_like": [
"cube ernetes"
],
"state": "pending",
"decided_by_user_id": null,
"decided_at": null,
"list_id": null,
"entry_id": null,
"refreshed_at": "2026-10-26T09:30:00Z"
}
],
"total": 1,
"last_refreshed_at": "2026-10-26T09:30:00Z"
}- Refresh vocabulary suggestions — Collect new suggestions now.
- Update vocabulary settings — Switch suggestions on or off and choose the target list.
- Vocabulary API — Overview of lists, entries and settings.