How to send SMS from Node.js in Sri Lanka

const API = 'https://avcsms.lk/api/v1';
const KEY = process.env.AVCSMS_API_KEY;

export async function sendSms(to, message, extra = {}) {
  const res = await fetch(`${API}/sms/send`, {
    method: 'POST',
    headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({ to, message, ...extra }),
  });
  const reply = await res.json();
  if (!res.ok) throw new Error(reply.message || `SMS request failed (HTTP ${res.status})`);
  return reply.data;
}

const result = await sendSms('0771234567', 'Your order #1042 is ready for pick-up.');
console.log(result.messages[0].id);   // keep this ID to check delivery later

const result = await sendSms(
  [
    { to: '0771234567', name: 'Nimal' },
    { to: '0712345678', name: 'Kumari' },
  ],
  'Hi {name}, your November invoice is ready.',
  { sender_id: 'MYSHOP', ref: 'invoice-nov' },
);

console.log(`Accepted ${result.accepted} messages, cost Rs. ${result.cost}`);

export async function smsStatus(id) {
  const res = await fetch(`${API}/sms/${id}`, { headers: { Authorization: `Bearer ${KEY}` } });
  const reply = await res.json();
  if (!res.ok) throw new Error(reply.message);
  return reply.data;
}

console.log((await smsStatus(9001)).status);   // queued, sending, sent, delivered or failed

import express from 'express';

const app = express();
app.use(express.json());

app.post('/sms-status', (req, res) => {
  const { event, id, ref, to, status } = req.body;
  if (event === 'sms.status') {
    // update the order or login record that matches the reference
  }
  res.sendStatus(200);
});

app.listen(3000);