> ## Documentation Index
> Fetch the complete documentation index at: https://developers.mioesim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Supported PDF languages for eSIM delivery

> Language codes for the pdfLanguage parameter — controls which language the eSIM activation PDF is generated in when you place or renew an order.

When MIOeSIM generates an eSIM activation PDF, it uses the `pdfLanguage` parameter to determine which language the document is rendered in. The PDF contains the QR code and setup instructions your customer needs to activate their eSIM. Passing the right language code ensures your customer receives instructions they can read without any extra steps on your end.

## Where to use this parameter

Pass `pdfLanguage` in the request body of the following endpoints:

* `addEsimOrder` — when placing a new eSIM order, include `pdfLanguage` to generate the activation PDF in the customer's language.
* `renewCard` — when renewing an existing plan, pass `pdfLanguage` to generate a renewal PDF in the correct language.
* `handlerEsimPdf` — when requesting a PDF regeneration for an existing order, pass `pdfLanguage` to control the output language.

## Supported languages

| No. | Language                   | Code    |
| --- | -------------------------- | ------- |
| 1   | English                    | `en-US` |
| 2   | 中文 (Simplified Chinese)    | `zh-CN` |
| 3   | 繁體中文 (Traditional Chinese) | `zh-TW` |
| 4   | 日本語 (Japanese)             | `ja-JP` |
| 5   | Русский язык (Russian)     | `ru-RU` |
| 6   | Español (Spanish)          | `es-ES` |
| 7   | Français (French)          | `fr-FR` |
| 8   | 한국어 (Korean)               | `ko-KR` |
| 9   | Deutsch (German)           | `de-DE` |
| 10  | Italiano (Italian)         | `it-IT` |
| 11  | Bahasa Indonesia           | `id-ID` |
| 12  | اللغة العربية (Arabic)     | `ar-SA` |
| 13  | Português (Portuguese)     | `pt-BR` |
| 14  | Tiếng Việt (Vietnamese)    | `vi-VN` |
| 15  | ภาษาไทย (Thai)             | `th-TH` |

<Note>
  If you omit `pdfLanguage` or pass a code that is not in the list above, the PDF defaults to English (`en-US`).
</Note>

<Tip>
  Pass the `pdfLanguage` that matches your customer's locale at checkout. Most platforms store a preferred locale on the user record — use that value directly to look up the matching code in the table above. This removes the need for customers to navigate a foreign-language PDF and reduces activation support requests.
</Tip>