Skip to content

Get a vocabulary entry

One vocabulary entry the caller can read, with its spoken forms, usage counts and the caller's rights on it. An unreadable entry answers 404.

GEThttps://api.aitronos.com/v1/vocabulary/entries/{entry_id}

Path Parameters

entry_id string required

The entry ID.


Returns

The vocabulary entry:

id string

The entry ID: pdict_… for a private entry, tdict_… for one in a list.

scope string

personal for a private entry, list for an entry in a list.

list_id string or null

The list the entry belongs to, if any.

written string

How the word is written.

sounds_like array of string

How the word may be spoken or misheard.

language string or null

The language tag; null for all languages.

kind string

bias makes the word more likely to be recognised; replace also rewrites the spoken forms to the written form.

source string

How the entry was created.

weight number

How strongly the word is favoured, above 0 and up to 10.

enabled boolean

Whether the entry is used in transcripts.

visibility string

private for a private entry; list when everyone who reads the list sees it; restricted when only the people it is shared with see it.

shared boolean

Whether the entry is shared on its own.

owner_user_id string

The person who created the entry.

reached_through string

How the entry reached the caller.

can_edit boolean

Whether the caller may change the entry.

can_share boolean

Whether the caller may share the entry.

stats object

Usage counters: applied_count, heard_count, corrected_count, last_applied_at, last_heard_at.

created_at string

When the entry was created.

updated_at string

When the entry last changed.

cURL
curl -X GET "https://api.aitronos.com/v1/vocabulary/entries/tdict_5a9c2e7b1d3f4068" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response:

200 OK
{
  "id": "tdict_5a9c2e7b1d3f4068",
  "scope": "list",
  "list_id": "voclist_8f2a61c4e0b94d7a",
  "written": "Kubernetes",
  "sounds_like": [
    "cube ernetes",
    "kuber netties"
  ],
  "language": null,
  "kind": "bias",
  "source": "manual",
  "weight": 1.0,
  "enabled": true,
  "visibility": "list",
  "shared": false,
  "owner_user_id": "usr_3c91d0a2b7e4",
  "reached_through": "owner",
  "can_edit": true,
  "can_share": true,
  "stats": {
    "applied_count": 14,
    "heard_count": 9,
    "corrected_count": 0,
    "last_applied_at": "2026-10-24T09:30:00Z",
    "last_heard_at": "2026-10-24T09:30:00Z"
  },
  "created_at": "2026-10-24T09:30:00Z",
  "updated_at": "2026-10-24T09:30:00Z"
}