Developer documentation

Long SMS are split into parts, and you pay per part. How many characters fit in a part depends on the encoding the body needs. Try any body in the calculator next to the navigation to estimate parts and cost.

Encodings

• The GSM-7 extension characters ^ { } \ [ ~ ] | € count as two characters each.
• Emoji need Unicode, and most emoji count as two characters.
• The API counts exactly the characters it receives: a \n line break counts as one character and \r\n as two. The calculator counts each line break as two, because browsers submit \r\n.
• A body can be at most 10 parts: 1,530 GSM-7 characters or 670 Unicode characters. Longer bodies return 422 under body.

Examples

Pricing

Cost per message is parts × rate, and a batch costs the sum of its messages. For a broadcast that is parts × rate × recipients. For example, "Your OTP is 4821. It expires in 5 minutes." is 1 part; sent to 500 recipients at ৳0.30 per part it costs ৳150.00.

• Your rate per part depends on your account tier (user, entrepreneur or center) and on the sender: masking names cost more than the default non-masking sender.
• Each send response reports parts and cost per message and total_parts and total_cost for the batch, so you always know the exact charge.
• Amounts are strings with two decimals, in BDT.
• Failed messages are refunded to your wallet exactly once; sent messages are final and charged.