API docs

Balance and pricing

Read your credit balance, current prices and the days prices rise.

GET/v1/balance

The sum of the project's active credits.

curl https://api.wesend.mn/v1/balance \
  -H "Authorization: Bearer $WESEND_API_KEY"

Response200 OK

{
  "balance": 4930,
  "next_expiry": {
    "credits": 930,
    "expires_at": "2027-01-14T03:00:00.000Z"
  }
}

1 credit = 1₮. Credits are valid for 365 days from purchase.
Credits closest to expiry are spent first. next_expiry is that portion; it is null when there are no active credits.
Every send response carries the new balance, so you rarely need to ask separately.

Pricing

GET/v1/pricing

The 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": 70,
    "rate_multiplier": 1,
    "holiday": null,
    "latin_part_size": 150,
    "unicode_part_size": 60,
    "max_parts": 5
  },
  "email": {
    "credits": 5
  },
  "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 holidays list gives upcoming periods on the Ulaanbaatar calendar, both days included.
The multiplier in force now is sms.rate_multiplier, and the holiday's name is sms.holiday.
Each message's rate_multiplier says which multiplier was applied to it.