📋 List Custom Glossary

This API retrieves a paginated list of custom glossary entries for a specific user.

📋 Basic Information

Method: GET
Path: https://api.bluente.com/api/20250924/blu_translate/glossary/list
Authentication: Required — Authorization: Bearer $BLUENTE_API_KEY

📝 Request Parameters (Query)

Query String

Field	Type	Required	Description
`next_token`	string	No	Pagination token for next page; omit or empty to fetch the first page
`size`	int	No	Number of entries per page, default 20

Request Body

None

💡 Example

curl -X GET "https://api.bluente.com/api/20250924/blu_translate/glossary/list?next_token=0&size=20" \
     -H "Authorization: Bearer $BLUENTE_API_KEY" \
     -H "Accept: application/json"

fetch("https://api.bluente.com/api/20250924/blu_translate/glossary/list?next_token=0&size=20", {
  method: "GET",
  headers: {
    "Authorization": "Bearer $BLUENTE_API_KEY"
  }
})

✅ Success Response Example

{
    "message": "success",
    "code": 0,
    "data": {
        "list": [
            {
                "id": 3,
                "user_id": "",
                "organization_id": "",
                "source_lang": "English",
                "source_text": "Amount of Investment",
                "target_lang": "Chinese",
                "target_text": "投资产量",
                "namespace": "Bluente Partner",
                "app_id": 10000,
                "updated_by": "",
                "updated_at": "2024-02-16 13:18:25",
                "created_at": "2024-01-09 10:59:38"
            },
            {
                "id": 217,
                "user_id": "",
                "organization_id": "0cbc6611-f554-0bd0-809a-388dc95a615b",
                "source_lang": "English",
                "source_text": "worll",
                "target_lang": "Tamil",
                "target_text": "நன்றி",
                "namespace": "Bluente Partner",
                "app_id": 10000,
                "updated_by": "",
                "updated_at": "2024-06-04 08:25:57",
                "created_at": "2024-06-04 08:25:57"
            }
        ],
        "next_token": "20"
    }
}

📊 Response Fields

Field	Type	Description
`message`	string	Response message, usually `"success"`
`code`	int	Status code, `0` means success
`data.list`	array	List of glossary entries
`list[].id`	int	Glossary item ID
`list[].user_id`	string	User ID who owns the entry
`list[].organization_id`	string	Organization ID (may be empty)
`list[].source_lang`	string	Source language of the entry
`list[].source_text`	string	Source term text
`list[].target_lang`	string	Target language of the entry
`list[].target_text`	string	Translated term text
`list[].namespace`	string	Namespace (client or partner)
`list[].app_id`	int	Application ID
`list[].updated_by`	string	Last updated by (user)
`list[].updated_at`	string	Last update timestamp
`list[].created_at`	string	Creation timestamp
`data.next_token`	string	Token for fetching next page; empty means no more entries

❌ Error Response Example

{
    "message": "unauthorized",
    "code": 401
}

📌 Notes

Use next_token to paginate through large glossaries.
The size parameter controls how many entries are returned per request.
Entries are scoped by user_id and optionally by namespace.

Batch Delete