Word template filler API

Fill a Word .docx template with {placeholders}, table-row loops and conditions from JSON; merge many rows into a zip of documents. Formats VND and dates.

Parameters

Example

curl -X POST "https://apibox.io.vn/v1/docx-template" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "0=@./my-file"

const form = new FormData();
form.append('0', fileInput.files[0]);

const res = await fetch('https://apibox.io.vn/v1/docx-template', {
  method: 'POST',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
  body: form,
});
console.log(await res.json());

import requests

res = requests.post(
    "https://apibox.io.vn/v1/docx-template",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    files={"0": open("my-file", "rb")},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/docx-template');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => ['0' => new CURLFile('my-file')],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Response

{
  "filename": "document.docx",
  "delimiters": "{ }",
  "tags": [
    {
      "name": "so_hd",
      "kind": "variable"
    },
    {
      "name": "ho_ten",
      "kind": "variable",
      "filters": [
        "upper"
      ]
    },
    {
      "name": "luong",
      "kind": "variable",
      "filters": [
        "money"
      ]
    },
    {
      "name": "luong",
      "kind": "variable",
      "filters": [
        "words"
      ]
    },
    {
      "name": "items",
      "kind": "section"
    },
    {
      "name": "$index",
      "kind": "variable"
    },
    {
      "name": "ten",
      "kind": "variable"
    },
    {
      "name": "tien",
      "kind": "variable",
      "filters": [
        "money"
      ]
    }
  ],
  "missing_fields": [],
  "text": "HỢP ĐỒNG LAO ĐỘNG số 12/2026/HĐLĐ\nBên B: Ông/Bà NGUYỄN VĂN AN, lương 15.500.000 đồng (Mười lăm triệu năm trăm nghìn đồng)\nSTT\nNội dung\nSố tiền\n1\nLương cơ bản\n12.000.000",
  "docx_base64": "UEsDBBQAAAgIAAAAAACY9I3b6wAAAM4BAAATAAAAW0NvbnRlbnRfVHlwZXNdLnhtbH2R…",
  "bytes": 1190
}

Use cases

• Generate labour or sales contracts from HR / CRM data
• Mail-merge certificates, invitations or notices into a zip
• Produce quotations and handover minutes with item tables
• Fill official Vietnamese forms kept as Word templates

FAQ

Related APIs