glossaries

List glossaries

One glossary per language pair, ordered alphabetically by pair, with its term count and the plan's cap. Terms themselves are omitted by default and returned only when you fetch a single glossary — or pass expand=terms here to get full content across a page of glossaries in one call. Pagination is cursor-based: pass the next_cursor from the previous response verbatim. expand=terms clamps the page size to 10, since a glossary's terms are otherwise unbounded in size.

GET/v1/glossaries

Request

curl --request GET \
  --url 'https://api.ai-glot.com/v1/glossaries' \
  --header 'Authorization: <api-key>'

import json
import requests

url = "https://api.ai-glot.com/v1/glossaries"
headers = {
  "Authorization": "<api-key>"
}

response = requests.request("GET", url, headers=headers)
print(response.json())

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.ai-glot.com/v1/glossaries");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.ai-glot.com/v1/glossaries", nil)
  req.Header.Set("Authorization", "<api-key>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.ai-glot.com/v1/glossaries"))
    .header("Authorization", "<api-key>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.ai-glot.com/v1/glossaries")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "<api-key>"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": [
    {
      "language_pair": "<string>",
      "source_language": "<string>",
      "target_language": "<string>",
      "term_count": 123,
      "max_terms": 123,
      "terms": {},
      "created_at": "<string>",
      "updated_at": "<string>"
    }
  ],
  "has_more": true,
  "next_cursor": null,
  "limit": 123,
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>"
  },
  "request_id": "<string>"
}

Requires glossaries:read. The list contains summaries by default: each glossary’s language pair, term count and the plan’s cap, without the terms themselves.

Pass expand=terms to get the full term map for every glossary on the page in a single call, instead of one request per glossary. Because a glossary’s terms are unbounded in size, expand=terms clamps the page size to 10; keep paging with next_cursor as usual.

Full term content for a page of glossariesGET /v1/glossaries?expand=terms&limit=10

This endpoint changes nothing and consumes no credits.

Response

application/json

List glossaries

dataobject[]required

Show child attributes

language_pairstringrequired

source_languagestringrequired

target_languagestringrequired

term_countintegerrequired

max_termsinteger | nullrequired

termsRecord<string, string>

created_atstringrequired

updated_atstringrequired

has_morebooleanrequired

next_cursorstringnullrequired

limitintegerrequired

request_idstringrequired

{ "data": [ { "language_pair": "<string>", "source_language": "<string>", "target_language": "<string>", "term_count": 123, "max_terms": 123, "terms": {}, "created_at": "<string>", "updated_at": "<string>" } ], "has_more": true, "next_cursor": null, "limit": 123, "request_id": "<string>" }

List glossaries

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown