GET /tms-partner/api/v1/order/label/{source-path}Usage and important notes
Always HTML, not PDF. The response has Content-Type: text/html; the source explicitly says no binary PDF is generated and no download Content-Disposition is set. The HTML format follows the prior labelId. Open it in a browser or an appropriately isolated iframe, print from the browser, or perform HTML-to-PDF conversion in your own system if a PDF is needed. Treat returned HTML as external content, not trusted markup for your application.
Use Accept: text/html and both authentication headers. The presigned path still has an expiry. Use the same TMS Partner server.
Authentication headers
| Header | Requirement | Value / meaning |
|---|---|---|
| X-Api-Token | Required | ${API_TOKEN}: environment-specific token issued by TMS |
| X-Client-Source | Required | ${PARTNER_CODE}: partner code paired with the token |
| Content-Type | With a JSON body | application/json |
| Accept | Required by source | text/html |
| Accept-Language | Optional | vn, en, my, km, lo |
Path and query parameters
| Name | Location | Required | Description |
|---|---|---|---|
| source-path | path | Yes | securePath from create-label; use before exp. |
cURL example
BASE_URL must include /tms-partner/api/v1. Load the token and partner code from your private environment; never paste secrets into documentation or AI prompts.
curl --request GET "${BASE_URL}/order/label/${SECURE_PATH}" \
--header "X-Api-Token: ${API_TOKEN}" \
--header "X-Client-Source: ${PARTNER_CODE}" \
--header "Accept-Language: en" \
--header "Accept: text/html" \
--output label.htmlExample response
<!doctype html><html lang="en"><body><p>Illustrative label HTML; layout is generated by TMS.</p></body></html>Response fields
HTML label in the selected format. Not binary PDF; no download Content-Disposition is documented.
Error handling
See HTTP codes and source limitations. HTTP success does not prove COD, fees, or cancellation are correct; inspect the documented business fields. Do not assume create-order retries are safe.