SMS API for Timor-Leste: bulk SMS to +670 numbers
Timor-Leste
Calling code +670
- Per SMS segment
- $0.01217
- Messages for $100
- 8,216
- Local language
- Tetum and Portuguese
- Encoding
- GSM-7 or Unicode
What a bulk SMS send to Timor-Leste costs
| Messages | 1 segment | 2 segments |
|---|---|---|
| 1 | $0.01217 | $0.02434 |
| 1,000 | $12.17 | $24.34 |
| 10,000 | $121.70 | $243.40 |
| 100,000 | $1,217.00 | $2,434.00 |
Number format in Timor-Leste
Mobile numbers in Timor-Leste have 8 digits after +670 and no trunk prefix, so the local form 7721 2345 becomes +670 7721 2345 in the to field.
Alphabet and segments
Texts in Tetum and Portuguese fit 160 GSM-7 characters per segment until they use á, â, ã, ç, ê, í, ó, ô, õ and ú: those letters are outside GSM-7 and turn the message into Unicode at 70 characters per segment (67 per part). For short alerts, write them without those letters to keep one segment; for longer texts, the console names each letter that changed the encoding.
Time zone and timing
Timor-Leste keeps UTC+9 all year with no clock change, so 09:00 in Dili is always 00:00 UTC. send_at takes UTC or any ISO 8601 offset, and the console scheduler converts from your own time zone.
Send to Timor-Leste with one request
The answer comes back at once with the message id, the country the number was matched to (TL) and the price. A delivered or failed event follows on your webhook, and a failed message is refunded.
For a list, send the same text to up to 10,000 numbers with POST /v1/batches, or a personal text per number in messages.
curl https://bulksmsapi.cc/v1/messages \
-H "Authorization: Bearer $BULKSMSAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"to": "+67077212345", "text": "Your Northwind code is 482913. It expires in 10 minutes."}'const res = await fetch("https://bulksmsapi.cc/v1/messages", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.BULKSMSAPI_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({ to: "+67077212345", text: "Your Northwind code is 482913. It expires in 10 minutes." }),
});
console.log(await res.json()); // price: "0.01217", country: "TL"import json, os, urllib.request
req = urllib.request.Request(
"https://bulksmsapi.cc/v1/messages",
data=json.dumps({"to": "+67077212345", "text": "Your Northwind code is 482913. It expires in 10 minutes."}).encode(),
headers={"Authorization": "Bearer " + os.environ["BULKSMSAPI_KEY"], "Content-Type": "application/json", "User-Agent": "northwind-app/1.0"},
method="POST",
)
with urllib.request.urlopen(req) as res:
print(json.load(res)["price"]) # "0.01217"What developers send to Timor-Leste
Payment alerts
Mobile banking apps notify users in Dili and rural areas when a transaction is completed, ensuring immediate confirmation.
Health reminders
Clinics send SMS to patients in Baucau and other regions to remind them of upcoming appointments or vaccination schedules.
Community alerts
Local NGOs use SMS to inform communities in remote areas about emergency updates or public health information.
Event notifications
Cultural organizations in Dili send SMS to attendees about changes in event schedules or venue details.
More countries in Southeast Asia
SMS to Timor-Leste: questions
More answers on accounts, payments and the API are in the FAQ.
How much does it cost to send bulk SMS to Timor-Leste?
How many SMS to Timor-Leste does a $100 top-up send?
How do I write Timor-Leste numbers for the API?
Which language should SMS be sent in?
How to reach expatriates and visitors?
Start sending to Timor-Leste
Create an account, top up from $40 and send to Timor-Leste at $0.01217 per segment, from the console or with one API call.