batches

List translations

Most recent first, archived excluded by default. Pagination is cursor-based: pass the next_cursor from the previous response verbatim. Offsets are not supported because a translation created mid-pagination would silently shift them. search matches a translation's name or, when it has none, its uploaded file name — the same search the web app's batch list uses, so results never diverge between the two.

GET/v1/batches

Request

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

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.ai-glot.com/v1/batches");
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/batches", 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/batches"))
    .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/batches")
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": [
    {
      "id": "<string>",
      "name": null,
      "file_name": null,
      "status": "analyzing",
      "quality_tier": null,
      "word_count": 123,
      "credit_cost": 123,
      "is_sample": true,
      "archived": true,
      "progress": {
        "phase": null,
        "percent": null,
        "updated_at": null,
        "estimated_seconds_remaining": 123
      },
      "error": {
        "code": "<string>",
        "message": "<string>"
      },
      "created_at": null,
      "completed_at": null,
      "next_action": "provide_instruction",
      "plan": {
        "instruction": "<string>",
        "summary": null,
        "will_translate": null,
        "will_not_touch": null,
        "special_rules": [
          "<string>"
        ],
        "assumptions": [
          "<string>"
        ],
        "not_included": [
          "<string>"
        ],
        "languages": [
          {
            "source": "<string>",
            "target": "<string>",
            "segments": 123,
            "words": 123
          }
        ],
        "totals": {
          "segments": 123,
          "words": 123,
          "files": 123
        },
        "credits": {
          "standard": 123,
          "lite": 123
        },
        "preview": [
          {
            "location": "<string>",
            "source_text": "<string>",
            "context": null,
            "languages": [
              {
                "code": "<string>",
                "name": "<string>"
              }
            ],
            "source_lang": "<string>",
            "target_lang": "<string>"
          }
        ],
        "cached": true
      },
      "plan_revision": "<string>",
      "suggested_instructions": [
        "<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 batches:read. Archived translations are excluded by default. Pass next_cursor back unchanged to fetch the next page.

Filter with status, archived, quality_tier, created_after and created_before. search matches a translation’s name or, when it has none, its uploaded file name. This is the same search the web app’s list uses, so the two never disagree.

This endpoint only reads: it does not start a translation and consumes no credits. It lists every translation in the workspace, whichever interface created it. To start one, create a translation.

Authorizations

Authorizationbearerin headerrequired

Query parameters

limitintegerrange: 1–100

Number of items to return. Values outside 1-100 are clamped, and the response reports the limit actually applied.

cursorstring

statusenum<string>one of: analyzing, awaiting_instructions, awaiting_approval, translating, completed, failed, cancelled

Keep only translations in this state. awaiting_instructions and awaiting_approval both mean 'waiting for you' but need different calls, so they filter separately. cancelled filters separately from failed too: a cancellation is not a failure, so counting broken runs means asking for failed alone.

archivedenum<string>one of: 0, 1, true, false

quality_tierenum<string>one of: standard, lite

created_afterstring

created_beforestring

searchstringlength: 1–200 chars

Response

application/json

List translations

dataobject[]required

Show child attributes

data.idstringrequired

data.namestringnullrequired

data.file_namestringnullrequired

data.statusenum<string>requiredone of: analyzing, awaiting_instructions, awaiting_approval, translating, completed, failed, cancelled

Where the translation is. All seven values: analyzing — the file's structure is being read, which takes seconds; poll. awaiting_instructions — the file is read, nobody has said what to translate; call plan. awaiting_approval — a plan is waiting for a yes; call approve, the only call that spends credits. translating — running; poll. completed — fetch the result. failed — the run could not finish; read error. cancelled — someone stopped it on purpose; also terminal, and not a failure. The last three are terminal: stop polling.

data.quality_tierstringnullrequired

data.word_countinteger | nullrequired

data.credit_costinteger | nullrequired

Credits for this translation. null until it is approved: the quote before that is plan.credits, per quality. Set at approval, and lowered if a cancellation charges only part of it.

data.is_samplebooleanrequired

data.archivedbooleanrequired

data.progressobjectrequired

Show child attributes

data.progress.phasestringnullrequired

data.progress.percentnumbernullrequired

data.progress.updated_atstringnullrequired

data.progress.estimated_seconds_remaininginteger | null

data.errorobject | nullrequired

Show child attributes

data.error.codestringrequired

data.error.messagestringrequired

data.created_atstringnullrequired

data.completed_atstringnullrequired

data.next_actionenum<string>one of: provide_instruction, review_plan, wait, download, read_error

The call to make next, so a client never has to map status itself. provide_instruction — call plan with an instruction. review_plan — the priced plan is embedded; check plan.not_included, then approve. wait — poll again; progress.estimated_seconds_remaining says how long is left. download — fetch the result. read_error — the run is over without a result; read error (and status says whether it broke or was cancelled). Absent only on a legacy pre-2026-08-31 CSV batch, which has no plan behind it; every translation created since then answers.

data.planobject | null

Show child attributes

data.plan.instructionstringrequired

data.plan.summarystringnullrequired

data.plan.will_translatestringnullrequired

data.plan.will_not_touchstringnullrequired

data.plan.special_rulesstring[]required

data.plan.assumptionsstring[]required

data.plan.not_includedstring[]required

data.plan.languagesobject[]required

Show child attributes

data.plan.languages.sourcestringrequired

data.plan.languages.targetstringrequired

data.plan.languages.segmentsintegerrequired

data.plan.languages.wordsintegerrequired

data.plan.totalsobjectrequired

Show child attributes

data.plan.totals.segmentsintegerrequired

data.plan.totals.wordsintegerrequired

data.plan.totals.filesinteger | nullrequired

data.plan.creditsobjectrequired

Show child attributes

data.plan.credits.standardintegerrequired

data.plan.credits.liteintegerrequired

data.plan.previewobject[]required

Show child attributes

data.plan.preview.locationstringrequired

data.plan.preview.source_textstringrequired

data.plan.preview.contextstringnull

data.plan.preview.languagesobject[]

Show child attributes

data.plan.preview.languages.codestringrequired

data.plan.preview.languages.namestringrequired

data.plan.preview.source_langstringrequired

data.plan.preview.target_langstringrequired

data.plan.cachedbooleanrequired

data.plan_revisionstring | null

data.suggested_instructionsstring[] | null

has_morebooleanrequired

next_cursorstringnullrequired

limitintegerrequired

request_idstringrequired

List translations

Authorizations

Query parameters

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown