# POST /v1/translate/batch

Part of the HebrewCore documentation. Web: https://hc.itsbaba.com/docs#batch · Whole docs: https://hc.itsbaba.com/docs.md · Index: https://hc.itsbaba.com/llms.txt

`POST /v1/translate/batch`

Translate many strings to one target language in a single request, for example to localize a set of UI strings or content fields. Up to 50 items, each up to 5,000 characters.

| Parameter | Type | Description |
| --- | --- | --- |
| `items` *required* | string[] | 1–50 strings to translate. |
| `target_lang` *required* | string | Applies to every item. |
| `source_lang`, `transliterate`, `quality`, `gender`, `message_format` | varies | Same as `/v1/translate`; applied to all items. With `message_format: "icu"`, each item is one ICU message. |
| Protection fields | varies | Any [protected translation](https://hc.itsbaba.com/docs#protected) field; each item then carries its own `protection` block. A protected batch carries at most 20,000 characters in total. Interface variables such as `{count}` and `%s` are kept in place. |

```json
{ "results": [ /* TranslationBlock per item, in input order */ ], "usage": { "characters": 18 } }
```

```http
POST /v1/translate/batch
{
  "items": ["{count} items in your cart", "Checkout", "Last updated %s ago"],
  "target_lang": "he",
  "protect": true,
  "glossary": { "Checkout": "לתשלום" }
}

→ ["{count} פריטים בעגלת הקניות שלך", "לתשלום", "עודכן לאחרונה לפני %s"]
```