Skip to content
HALOWERK

Textwerk

transliterate

ISO 9:1995 (= GOST 7.79-2000 System A) maps every letter of the Russian, Ukrainian, Belarusian, Bulgarian, Serbian and Macedonian alphabets plus the historic letters Ѣ Ѫ Ѳ Ѵ one-to-one. ICAO Doc 9303 Part 3, 8th edition 2021, section 6 tables A and B give the machine-readable passport form (A–Z only) with the language rules for Ukrainian, Belarusian and Bulgarian; Latin letters with diacritics follow table A; optional MRZ name field SURNAME<<GIVEN<NAMES. Greek uses the ELOT 743 transcription.

POST https://text.halowerk.com/v1/transliterate

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringNoText to transliterate.
systemstringYesiso9: Cyrillic (ISO 9:1995); icao: ICAO Doc 9303 passport names; elot743: Greek (UN 1987).
languagestringNoLanguage rules for ICAO Cyrillic (Serbian and Macedonian are not offered, see limitations).
icao_diacriticsstringNoICAO table A options: expanded Ä→AE, Å→AA, Ö→OE, Ü→UE; simple → A, A, O, U.
mrz_nameobjectNoICAO only: build the MRZ name field from primary (surname) and secondary (given names) identifier.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "system"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20000,
      "description": "Text to transliterate."
    },
    "system": {
      "type": "string",
      "enum": [
        "iso9",
        "icao",
        "elot743"
      ],
      "description": "iso9: Cyrillic (ISO 9:1995); icao: ICAO Doc 9303 passport names; elot743: Greek (UN 1987)."
    },
    "language": {
      "type": "string",
      "enum": [
        "ru",
        "uk",
        "be",
        "bg"
      ],
      "default": "ru",
      "description": "Language rules for ICAO Cyrillic (Serbian and Macedonian are not offered, see limitations)."
    },
    "icao_diacritics": {
      "type": "string",
      "enum": [
        "expanded",
        "simple"
      ],
      "default": "expanded",
      "description": "ICAO table A options: expanded Ä→AE, Å→AA, Ö→OE, Ü→UE; simple → A, A, O, U."
    },
    "mrz_name": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "primary"
      ],
      "description": "ICAO only: build the MRZ name field from primary (surname) and secondary (given names) identifier.",
      "properties": {
        "primary": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "description": "Primary identifier (surname)."
        },
        "secondary": {
          "type": "string",
          "maxLength": 200,
          "description": "Secondary identifier (given names)."
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "text": "Юрий Гагарин",
  "system": "icao",
  "language": "ru"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →