Skip to main content
POST
/
tashkil
/
diacritize
Diacritize Arabic Text
curl --request POST \
  --url https://api.munsit.com/api/v1/tashkil/diacritize \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "text": "ذهب الطالب الى المدرسة"
}
'
{
  "statusCode": 200,
  "data": {
    "original_text": "ذهب الطالب الى المدرسة",
    "diacritized_text": "ذَهَبَ الطَّالِبُ إِلَى المَدْرَسَةِ"
  },
  "message": "Success"
}

Documentation Index

Fetch the complete documentation index at: https://docs.munsit.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

POST /tashkil/diacritize

​
Authentication

Requires API key authentication with the x-api-key header. 
x-api-key: YOUR_MUNSIT_API_KEY

​
Request body

FieldTypeRequiredDescription
textstringYesArabic text to diacritize

​
Response

FieldTypeDescription
statusCodenumberHTTP-style status code
data.original_textstringOriginal input text
data.diacritized_textstringText with Arabic diacritics
messagestringRequest status message

​
Example

curl 'https://api.munsit.com/api/v1/tashkil/diacritize' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_MUNSIT_API_KEY' \
  -d '{
    "text": "ذهب الطالب الى المدرسة"
  }'

{
  "statusCode": 200,
  "data": {
    "original_text": "ذهب الطالب الى المدرسة",
    "diacritized_text": "ذَهَبَ الطَّالِبُ إِلَى المَدْرَسَةِ"
  },
  "message": "Success"
}

​
Notes

  • The model performs best on Fusha and formal Arabic text.
  • Dialectal, noisy, or highly informal text may need additional review.

​
Error responses

HTTP statuserrorCodeScenario
40040001Missing or invalid text field
40140101Missing, invalid, expired, or revoked API key
41341301Request body exceeds the maximum size limit
50050001Internal error or upstream Tashkil service failure

​
Missing API key

{
  "errorCode": 40101,
  "errorMessage": "API key required"
}

​
Invalid API key

{
  "errorCode": 40101,
  "errorMessage": "Invalid API key"
}

​
Validation error

{
  "errorCode": 40001,
  "errorMessage": "text: Expected string"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication

Body

application/json
​
text
string
required

Arabic text to diacritize. Fusha and formal Arabic text are recommended for best results.

Minimum string length: 1

Response

Text diacritized successfully

​
statusCode
integer
required
Example:

200

​
data
object
required
​
message
string
required
Example:

"Success"