API for Plain Language and Easy Language.
Send your source text, the desired target language and one of the two language modes. Simple8 automatically detects the source language and returns the finished text in the target language.
{
"text": "Complex source content in the selected language.",
"locale": "en",
"mode": "simple-language"
}SDK and cURL examples available
Endpoint
POST /api/v2/translate
Creates a Plain Language or Easy Language text and returns it directly in the HTTP response.
Required headers
| Header | Value | Purpose |
|---|---|---|
| Authorization | Bearer <API_KEY> | Workspace authentication |
| Content-Type | application/json | Indicates that the query contains JSON |
| Accept | application/json | Requests a JSON response |
| Idempotency-Key | Required only for background and batch jobs | Preventing double-entry orders |
Request body
No other content setting is part of the public request schema.
| Field | Type | Required | Allowed value | Description |
|---|---|---|---|---|
| text | string | Yes | 1 to 5,000 NFC-normalized Unicode code points | The following is the list of the categories of products: |
| locale | string | Yes | One of 136 supported 2- or 3-letter codes | Output language. The source language is detected automatically. |
| mode | string | Yes | simple-language, easy-language | Simplification mode |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Response body
The answer shall include the finished text and the documented usage data.
| Field | Type | Description |
|---|---|---|
| requestId | string | Unique identifier for support and logs |
| locale | string | Selected target language |
| mode | string | Selected simplification mode |
| output | string | Finished text in the selected target language |
| usage.inputCharacters | integer | Characters counted for this request, or 0 for a cache hit |
| usage.cacheHit | boolean | Whether the result came from the 180-day cache |
{
"requestId": "req_sync_002",
"locale": "en",
"mode": "easy-language",
"output": "You need to send documents.\nSend the documents before the deadline.",
"usage": {
"inputCharacters": 78,
"cacheHit": false
}
}Validation behavior
- Missing, empty, unknown, or invalid fields return HTTP 400 with error code invalid_request and validation details.
- Text length is measured after NFC normalization in Unicode code points.
- The locale must be one of the 136 documented 2- or 3-letter codes.
- The mode must be exactly simple-language or easy-language.
- The source text may be written in a language other than that specified. Simple8 automatically detects the language and creates the result in the selected target language.