Integrate SMS into your application

# Bulk send to a list of numbers (up to 500 per request)
curl -X POST https://api.sms.md/v3/messages/bulk \
  -H "X-Api-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "CompanyName",
    "recipients": ["+37369000001", "+37369000002", "+37369000003"],
    "text": "20% off today only! Promo code: SALE20"
  }'

# Response:
{
  "status":   "success",
  "httpCode": 200,
  "data": {
    "bulkId": "019fd720-1a7d-715c-a4ef-bfe26b903293"
  }
}

# Checking delivery status by ID
curl https://api.sms.md/v3/messages/787ab0aa-09cd-44f2-aa98-6ebc3cdb2ec6 \
  -H "X-Api-Token: YOUR_API_TOKEN"

# Response:
{
  "status":   "success",
  "httpCode": 200,
  "data": {
    "id":     "787ab0aa-09cd-44f2-aa98-6ebc3cdb2ec6",
    "status": { "id": 3, "name": "Delivered" },
    "dateUpdated": "2026-03-24T14:32:11+03:00"
  }
}

// Use Guzzle or any HTTP client
use GuzzleHttp\Client;

$client = new Client();
$response = $client->post('https://api.sms.md/v3/messages', [
    'headers' => [
        'X-Api-Token' => $apiToken,
    ],
    'json' => [
        'from' => 'CompanyName',
        'to'   => '+37369000000',
        'text' => 'Your order #1042 has been accepted.',
    ],
]);
$body = json_decode($response->getBody(), true);
echo $body['data']['id']; // 787ab0aa-09cd-44f2-aa98-6ebc3cdb2ec6

$response = $client->post('https://api.sms.md/v3/messages/bulk', [
    'headers' => ['X-Api-Token' => $apiToken],
    'json' => [
        'from' => 'CompanyName',
        'recipients' => [
            '+37369000001',
            '+37369000002',
            '+37369000003',
        ],
        'text' => '20% off today only!',
    ],
]);
$body = json_decode($response->getBody(), true);
echo $body['data']['bulkId'];

$response = $client->get(
    'https://api.sms.md/v3/messages/' . $messageId,
    ['headers' => ['X-Api-Token' => $apiToken]]
);
$msg = json_decode($response->getBody(), true)['data'];

if ($msg['status']['name'] === 'Delivered') {
    // Message delivered
}

import requests

response = requests.post(
    'https://api.sms.md/v3/messages',
    headers={'X-Api-Token': api_token},
    json={
        'from': 'CompanyName',
        'to':   '+37369000000',
        'text': 'Your order #1042 has been accepted.',
    }
)
body = response.json()
print(body['data']['id'])  # 787ab0aa-09cd-44f2-aa98-6ebc3cdb2ec6

response = requests.post(
    'https://api.sms.md/v3/messages/bulk',
    headers={'X-Api-Token': api_token},
    json={
        'from': 'CompanyName',
        'recipients': [
            '+37369000001',
            '+37369000002',
            '+37369000003',
        ],
        'text': '20% off today only!',
    }
)
print(response.json()['data']['bulkId'])

response = requests.get(
    f'https://api.sms.md/v3/messages/{message_id}',
    headers={'X-Api-Token': api_token}
)
msg = response.json()['data']

if msg['status']['name'] == 'Delivered':
    print('Delivered', msg['dateUpdated'])

const response = await fetch('https://api.sms.md/v3/messages', {
  method: 'POST',
  headers: {
    'X-Api-Token':   apiToken,
    'Content-Type':  'application/json',
  },
  body: JSON.stringify({
    from: 'CompanyName',
    to:   '+37369000000',
    text: 'Your order #1042 has been accepted.',
  }),
});

const { data } = await response.json();
console.log(data.id); // 787ab0aa-09cd-44f2-aa98-6ebc3cdb2ec6

const response = await fetch('https://api.sms.md/v3/messages/bulk', {
  method: 'POST',
  headers: {
    'X-Api-Token':   apiToken,
    'Content-Type':  'application/json',
  },
  body: JSON.stringify({
    from: 'CompanyName',
    recipients: ['+37369000001', '+37369000002'],
    text: '20% off today only!',
  }),
});
const { data } = await response.json();
console.log(`Bulk ID: ${data.bulkId}`);

const response = await fetch(
  `https://api.sms.md/v3/messages/${messageId}`,
  { headers: { 'X-Api-Token': apiToken } }
);
const { data } = await response.json();

if (data.status.name === 'Delivered') {
  console.log('Delivered', data.dateUpdated);
}