DEVELOPER REFERENCE

Bangla Converter API

Convert Bangla text inside Office documents over HTTP: send a DOCX or XLSX to one endpoint, receive the converted file in the same format. Every example on this page was executed against the live service.

No API key10 MB per fileFiles not retained

ENDPOINTS

Three endpoints, one job each.

Pasted text is converted in the browser on the tool pages and never needs an API call; these endpoints exist for document automation and spell-check workflows.

Method	Path	Purpose
POST	`/api/v1/convert/file/`	Convert Bangla text inside a DOCX or XLSX file between Unicode and Bijoy ANSI, returning an editable copy.
GET	`/api/health/`	Service availability probe. Returns ok with a timestamp; no authentication, no payload.
POST	`/api/v1/spell-check/`	Bangla spelling check proxy for the government (Sothik) spell service. Returns issues with suggestions.

DOCUMENT CONVERSION

POST /api/v1/convert/file/

Multipart form request. The service converts text runs inside the Office XML and returns a downloadable file with structure retained — paragraphs, tables, sheets, formulas, and styles.

Field	Type	Value
file	binary	DOCX or XLSX, maximum 10 MB
direction	string	`unicode-to-bijoy` or `bijoy-to-unicode`

Tested request

curl -X POST \
  -F "[email protected]" \
  -F "direction=unicode-to-bijoy" \
  https://banglatools.com/api/v1/convert/file/ \
  -o report-bijoy.docx

Verified response headers

HTTP/1.1 200 OK
cache-control: no-store
content-disposition: attachment; filename="report-bijoy.docx"
content-type: application/vnd.openxmlformats-officedocument.wordprocessingml.document
x-file-retention: none

A sample DOCX containing আমি বাংলায় লিখি। came back containing Avwg evsjvq wjwL| — the correct Bijoy ANSI text, with X-File-Retention: none confirming nothing is stored.

ERRORS

Every failure returns JSON.

Error bodies always have the form {"error":"message"}. Each code below was triggered against the live service while writing this page.

Status	When	Message
400	Form has no file, or direction is missing/unknown	Choose a DOCX or XLSX file. / Choose Unicode to Bijoy or Bijoy to Unicode.
413	File exceeds 10 MB, or expands beyond the processing limit	The file is larger than 10 MB.
415	Extension is not .docx or .xlsx	Only DOCX and XLSX files are supported.
422	Archive is not a valid Office document	The uploaded file is not a valid Office document.
500	Unexpected conversion failure	The document could not be converted.

ALSO AVAILABLE

Health and spell-check.

GET /api/health/

curl https://banglatools.com/api/health/
{"status":"ok","service":"banglatools-next","time":"2026-09-01T07:12:42.242Z"}

POST /api/v1/spell-check/

JSON body with content (Bangla text, up to 20,000 characters) and an optional personalDictionary array of up to 200 Bangla words. Issues come back sorted by position. Pasted text is forwarded to the government spell service with permissionToStoreData: false.

curl -X POST https://banglatools.com/api/v1/spell-check/ \
  -H "Content-Type: application/json" \
  -d '{"content":"আমি বাংলায় লিখি"}'

{"issues":[{"token":"লিখি","startIndex":12,"errorCode":9,"suggestions":["লিখি,"]}]}

OPERATIONAL LIMITS

What the service guarantees

No authentication or quota today. The API is free while usage stays reasonable; abusive traffic may be rate limited without notice. Contact us before building a production integration.

Files are processed in memory. Responses carry Cache-Control: no-store and X-File-Retention: none; nothing is written to disk.

Conversion quality matches the website. The document endpoint uses the same engine measured on the accuracy test page — 100% roundtrip pass on the published corpus as of its last verified date.

Plain text has no HTTP endpoint by design. Text conversion runs client-side on the Unicode to Bijoy converter, so pasted text never reaches the server.

COMMON QUESTIONS

Bangla converter API FAQ

Authentication, limits, retention, and response formats.

Do I need an API key for the Bangla converter API?

No. The document conversion, health, and spell-check endpoints are open. Keep usage reasonable and contact us before shipping a production integration, so we can tell you about changes instead of surprising you with rate limits.

Does the API store my documents?

No. Files are processed in memory and returned immediately. Responses carry Cache-Control: no-store and X-File-Retention: none, and nothing is written to disk.

Is there a text conversion endpoint?

No, by design. Pasted text is converted inside your browser on the website, so it never travels to a server. The HTTP endpoints cover Office documents and spell-check, where processing cannot happen client-side.

What are the file size limits?

Uploads are capped at 10 MB and the decompressed Office archive must stay within processing limits. The endpoint rejects other cases with a 413 response before conversion starts.

Which file formats does the API return?

The same format you upload: a DOCX comes back as DOCX and an XLSX as XLSX, with the Content-Disposition filename suffixed -bijoy or -unicode depending on the direction.