Integrate SMS into your application

# Bulk send to a list of numbers
curl -X POST https://api.sms.md/v1/messages/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipients": ["+37369000001", "+37369000002", "+37369000003"],
    "from": "CompanyName",
    "text": "20% off today only! Promo code: SALE20"
  }'

# Checking delivery status by ID
curl -X GET https://api.sms.md/v1/messages/msg_8f3a91bc \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response:
{
  "id":           "msg_8f3a91bc",
  "status":       "delivered",
  "delivered_at": "2026-03-24T14:32:11Z",
}

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

$client = new Client();
$response = $client->post('https://api.sms.md/v1/messages', [
    'headers' => [
        'Authorization' => 'Bearer ' . $apiKey,
    ],
    'json' => [
        'to'   => '+37369000000',
        'from' => 'CompanyName',
        'text' => 'Your order #1042 has been accepted.',
    ],
]);
$data = json_decode($response->getBody(), true);
echo $data['id']; // msg_8f3a91bc

$response = $client->post('https://api.sms.md/v1/messages/bulk', [
    'headers' => ['Authorization' => 'Bearer ' . $apiKey],
    'json' => [
        'recipients' => [
            '+37369000001',
            '+37369000002',
            '+37369000003',
        ],
        'from' => 'CompanyName',
        'text' => '20% off today only!',
    ],
]);
$result = json_decode($response->getBody(), true);
echo $result['sent']; // 3

$response = $client->get(
    'https://api.sms.md/v1/messages/msg_8f3a91bc',
    ['headers' => ['Authorization' => 'Bearer ' . $apiKey]]
);
$msg = json_decode($response->getBody(), true);

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

import requests

response = requests.post(
    'https://api.sms.md/v1/messages',
    headers={'Authorization': f'Bearer {api_key}'},
    json={
        'to':   '+37369000000',
        'from': 'CompanyName',
        'text': 'Your order #1042 has been accepted.',
    }
)
data = response.json()
print(data['id'])  # msg_8f3a91bc

response = requests.post(
    'https://api.sms.md/v1/messages/bulk',
    headers={'Authorization': f'Bearer {api_key}'},
    json={
        'recipients': [
            '+37369000001',
            '+37369000002',
            '+37369000003',
        ],
        'from': 'CompanyName',
        'text': '20% off today only!',
    }
)
print(response.json()['sent'])  # 3

response = requests.get(
    'https://api.sms.md/v1/messages/msg_8f3a91bc',
    headers={'Authorization': f'Bearer {api_key}'}
)
msg = response.json()

if msg['status'] == 'delivered':
    print('Delivered at', msg['delivered_at'])

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

const data = await response.json();
console.log(data.id); // msg_8f3a91bc

const response = await fetch('https://api.sms.md/v1/messages/bulk', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type':  'application/json',
  },
  body: JSON.stringify({
    recipients: ['+37369000001', '+37369000002'],
    from: 'CompanyName',
    text: '20% off today only!',
  }),
});
const { sent } = await response.json();
console.log(`Sent: ${sent}`);

const response = await fetch(
  'https://api.sms.md/v1/messages/msg_8f3a91bc',
  { headers: { 'Authorization': `Bearer ${apiKey}` } }
);
const msg = await response.json();

if (msg.status === 'delivered') {
  console.log('Delivered at', msg.delivered_at);
}