Every vocabulary list the caller can read, the organization list first, and how many private entries the caller has.
A page of lists:
object string
Always list.
data array of object
The lists, each a vocabulary list object as below.
personal_entry_count integer
How many private entries the caller has.
id string
The list ID.
kind string
organization for the one list every organization has; custom otherwise.
name string
The list name.
description string or null
An optional description.
team_space_id string or null
The team space the list belongs to, if any.
owner_user_id string or null
The person who owns the list; null for the organization list.
enabled boolean
Whether the list's words are used in transcripts.
entry_count integer
Live entries in the list the caller can read.
reached_through string
How the list reached the caller: owner, person, role, department, team, team_space, organization or admin (only through administration rights).
can_edit boolean
Whether the caller may change the list.
can_share boolean
Whether the caller may share the list.
can_delete boolean
Whether the caller may delete the list.
created_at string
When the list was created.
updated_at string
When the list last changed.
- Bash
- Python
- JavaScript
curl -X GET "https://api.aitronos.com/v1/vocabulary/lists" \
-H "X-API-Key: $FREDDY_API_KEY"Response:
{
"object": "list",
"data": [
{
"id": "voclist_1b7d5e9f3a2c4680",
"kind": "organization",
"name": "Organization vocabulary",
"description": null,
"team_space_id": null,
"owner_user_id": null,
"enabled": true,
"entry_count": 48,
"reached_through": "organization",
"can_edit": false,
"can_share": false,
"can_delete": false,
"created_at": "2026-10-24T09:30:00Z",
"updated_at": "2026-10-24T09:30:00Z"
},
{
"id": "voclist_8f2a61c4e0b94d7a",
"kind": "custom",
"name": "Product names",
"description": "Names of our products and features.",
"team_space_id": null,
"owner_user_id": "usr_3c91d0a2b7e4",
"enabled": true,
"entry_count": 12,
"reached_through": "owner",
"can_edit": true,
"can_share": true,
"can_delete": true,
"created_at": "2026-10-24T09:30:00Z",
"updated_at": "2026-10-24T09:30:00Z"
}
],
"personal_entry_count": 23
}- Vocabulary API — Overview of lists, entries and settings.
- Create an access grant — Share a vocabulary list with people, teams or the whole organization.