API docs
Balance and pricing
Read your credit balance, current prices and the days prices rise.
GET
/v1/balanceThe sum of the project's active credits.
curl https://api.wesend.mn/v1/balance \
-H "Authorization: Bearer $WESEND_API_KEY"Response200 OK
{
"balance": 4920,
"next_expiry": {
"credits": 920,
"expires_at": "2027-01-14T03:00:00.000Z"
},
"unlimited": false
}- 1 credit = 1₮. Credits are valid for 365 days from purchase.
- Credits closest to expiry are spent first.
next_expiryis that portion; it isnullwhen there are no active credits. - Every send response carries the new
balance, so you rarely need to ask separately. - When
unlimitedistrue, WeSend gave the project unlimited access: nothing is taken from the balance, so there is no need to check it before sending.
Pricing
GET
/v1/pricingThe prices that apply to your project now.
curl https://api.wesend.mn/v1/pricing \
-H "Authorization: Bearer $WESEND_API_KEY"Response200 OK
{
"sms": {
"credits_per_part": 80,
"rate_multiplier": 1,
"holiday": null,
"latin_part_size": 155,
"unicode_part_size": 65,
"max_parts": 4,
"prefix": {
"name": "WeSend",
"length": 8,
"is_latin": true
}
},
"email": {
"credits": 10
},
"holidays": [
{
"name": "Шинэ жил",
"starts_on": "2026-12-31",
"ends_on": "2027-01-01",
"rate_multiplier": 2
},
{
"name": "Цагаан сар",
"starts_on": "2027-02-06",
"ends_on": "2027-02-09",
"rate_multiplier": 2
}
]
}Holiday rates
Mobile operators raise their SMS rates on days such as New Year, Tsagaan Sar and Naadam. On those days SMS credits are multiplied by rate_multiplier. Email is not affected.
- The
holidayslist gives upcoming periods on the Ulaanbaatar calendar, both days included. - The multiplier in force now is
sms.rate_multiplier, and the holiday's name issms.holiday. - Each message's
rate_multipliersays which multiplier was applied to it.
Brand prefix
A verification SMS starts with the prefix {name}: . sms.prefix gives the project's brand name, or the project name in Latin letters when no brand is set (Монгол Шувуу → Mongol Shuvuu). A brand in the request takes its place.
lengthis the number of characters in the prefix, the trailing:included. They count toward the size of the first part.- When
is_latinisfalse, the name holds a Cyrillic letter or a special character, and the whole SMS is split atunicode_part_size.