Bulk SMS API for Developers

using System.Net.Http.Headers;
    using System.Net.Http.Json;
    using System.Text.Json.Serialization;
    
    var username = Environment.GetEnvironmentVariable("BULKSMS_USERNAME") ?? "YOUR_USERNAME";
    var password = Environment.GetEnvironmentVariable("BULKSMS_PASSWORD") ?? "YOUR_PASSWORD";
    
    var baseUrl = "https://api.bulksmsonline.co/rest/api/v1";
    
    using var http = new HttpClient
    {
        Timeout = TimeSpan.FromSeconds(30)
    };
    
    var tokenUrl =
        $"{baseUrl}/sms/gettoken/username/{Uri.EscapeDataString(username)}/password/{Uri.EscapeDataString(password)}";
    
    using var tokenResponse = await http.GetAsync(tokenUrl);
    var tokenBody = await tokenResponse.Content.ReadAsStringAsync();
    
    if (!tokenResponse.IsSuccessStatusCode)
    {
        throw new HttpRequestException($"Token request failed: {(int)tokenResponse.StatusCode} {tokenBody}");
    }
    
    var tokenResult = await tokenResponse.Content.ReadFromJsonAsync<TokenResponse>();
    var token = tokenResult?.Token;
    
    if (string.IsNullOrWhiteSpace(token))
    {
        throw new InvalidOperationException("Token was not returned by REST API.");
    }
    
    var smsPayload = new
    {
        from = "YourBrand",
        to = new[] { "1234567890" },
        type = "Text",
        content = "Hello from BulkSMSOnline REST API",
        sendDateTime = (string?)null
    };
    
    using var sendRequest = new HttpRequestMessage(HttpMethod.Post, $"{baseUrl}/sms/send/")
    {
        Content = JsonContent.Create(smsPayload)
    };
    
    sendRequest.Headers.Add("token", token);
    sendRequest.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
    
    using var sendResponse = await http.SendAsync(sendRequest);
    var sendBody = await sendResponse.Content.ReadAsStringAsync();
    
    if (!sendResponse.IsSuccessStatusCode)
    {
        throw new HttpRequestException($"Send request failed: {(int)sendResponse.StatusCode} {sendBody}");
    }
    
    Console.WriteLine(sendBody);
    
    public sealed record TokenResponse(
        [property: JsonPropertyName("token")] string Token
    );

import com.fasterxml.jackson.databind.JsonNode;
    import com.fasterxml.jackson.databind.ObjectMapper;
    
    import java.net.URI;
    import java.net.URLEncoder;
    import java.net.http.HttpClient;
    import java.net.http.HttpRequest;
    import java.net.http.HttpResponse;
    import java.nio.charset.StandardCharsets;
    import java.time.Duration;
    import java.util.List;
    import java.util.Map;
    
    public class SendRestSms {
        public static void main(String[] args) throws Exception {
            String username = getenvOrDefault("BULKSMS_USERNAME", "YOUR_USERNAME");
            String password = getenvOrDefault("BULKSMS_PASSWORD", "YOUR_PASSWORD");
    
            String baseUrl = "https://api.bulksmsonline.co/rest/api/v1";
            ObjectMapper mapper = new ObjectMapper();
    
            HttpClient client = HttpClient.newBuilder()
                .connectTimeout(Duration.ofSeconds(15))
                .build();
    
            String tokenUrl = baseUrl
                + "/sms/gettoken/username/" + encodePath(username)
                + "/password/" + encodePath(password);
    
            HttpRequest tokenRequest = HttpRequest.newBuilder()
                .uri(URI.create(tokenUrl))
                .timeout(Duration.ofSeconds(30))
                .GET()
                .build();
    
            HttpResponse<String> tokenResponse =
                client.send(tokenRequest, HttpResponse.BodyHandlers.ofString());
    
            if (tokenResponse.statusCode() < 200 || tokenResponse.statusCode() >= 300) {
                throw new RuntimeException("Token request failed: " + tokenResponse.body());
            }
    
            JsonNode tokenJson = mapper.readTree(tokenResponse.body());
            String token = tokenJson.path("token").asText();
    
            if (token == null || token.isBlank()) {
                throw new RuntimeException("Token was not returned by REST API.");
            }
    
            Map<String, Object> smsPayload = Map.of(
                "from", "YourBrand",
                "to", List.of("1234567890"),
                "type", "Text",
                "content", "Hello from BulkSMSOnline REST API",
                "sendDateTime", null
            );
    
            String jsonBody = mapper.writeValueAsString(smsPayload);
    
            HttpRequest sendRequest = HttpRequest.newBuilder()
                .uri(URI.create(baseUrl + "/sms/send/"))
                .timeout(Duration.ofSeconds(30))
                .header("token", token)
                .header("Content-Type", "application/json")
                .header("Accept", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
                .build();
    
            HttpResponse<String> sendResponse =
                client.send(sendRequest, HttpResponse.BodyHandlers.ofString());
    
            if (sendResponse.statusCode() < 200 || sendResponse.statusCode() >= 300) {
                throw new RuntimeException("Send request failed: " + sendResponse.body());
            }
    
            System.out.println(sendResponse.body());
        }
    
        private static String encodePath(String value) {
            return URLEncoder.encode(value, StandardCharsets.UTF_8).replace("+", "%20");
        }
    
        private static String getenvOrDefault(String key, String fallback) {
            String value = System.getenv(key);
            return value == null || value.isBlank() ? fallback : value;
        }
    }

using System.Text.Json;
    
    var endpoint = "https://api.bulksmsonline.co/mnp";
    
    var payload = new Dictionary<string, string>
    {
        ["username"] = Environment.GetEnvironmentVariable("BULKSMS_USERNAME") ?? "YOUR_USERNAME",
        ["password"] = Environment.GetEnvironmentVariable("BULKSMS_PASSWORD") ?? "YOUR_PASSWORD",
        ["msisdn"] = "12025550100"
    };
    
    using var http = new HttpClient
    {
        Timeout = TimeSpan.FromSeconds(30)
    };
    
    using var content = new FormUrlEncodedContent(payload);
    using var response = await http.PostAsync(endpoint, content);
    
    var body = await response.Content.ReadAsStringAsync();
    
    if (!response.IsSuccessStatusCode)
    {
        throw new HttpRequestException($"HTTP {(int)response.StatusCode}: {body}");
    }
    
    if (body.TrimStart().StartsWith("{", StringComparison.Ordinal))
    {
        using var json = JsonDocument.Parse(body);
        Console.WriteLine(json.RootElement.ToString());
    }
    else
    {
        Console.WriteLine($"MNP lookup error code: {body}");
    }

import java.net.URI;
    import java.net.URLEncoder;
    import java.net.http.HttpClient;
    import java.net.http.HttpRequest;
    import java.net.http.HttpResponse;
    import java.nio.charset.StandardCharsets;
    import java.time.Duration;
    import java.util.Map;
    import java.util.stream.Collectors;
    
    public class MnpLookup {
        public static void main(String[] args) throws Exception {
            String endpoint = "https://api.bulksmsonline.co/mnp";
    
            Map<String, String> payload = Map.of(
                "username", getenvOrDefault("BULKSMS_USERNAME", "YOUR_USERNAME"),
                "password", getenvOrDefault("BULKSMS_PASSWORD", "YOUR_PASSWORD"),
                "msisdn", "12025550100"
            );
    
            String formBody = payload.entrySet()
                .stream()
                .map(e -> encode(e.getKey()) + "=" + encode(e.getValue()))
                .collect(Collectors.joining("&"));
    
            HttpClient client = HttpClient.newBuilder()
                .connectTimeout(Duration.ofSeconds(15))
                .build();
    
            HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(endpoint))
                .timeout(Duration.ofSeconds(30))
                .header("Content-Type", "application/x-www-form-urlencoded")
                .header("Accept", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(formBody))
                .build();
    
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    
            if (response.statusCode() < 200 || response.statusCode() >= 300) {
                throw new RuntimeException("HTTP " + response.statusCode() + ": " + response.body());
            }
    
            String body = response.body().trim();
    
            if (body.startsWith("{")) {
                System.out.println("MNP lookup result: " + body);
            } else {
                System.out.println("MNP lookup error code: " + body);
            }
        }
    
        private static String encode(String value) {
            return URLEncoder.encode(value, StandardCharsets.UTF_8);
        }
    
        private static String getenvOrDefault(String key, String fallback) {
            String value = System.getenv(key);
            return value == null || value.isBlank() ? fallback : value;
        }
    }

using System.Text.Json;
    
    var endpoint = "https://api.bulksmsonline.co/mnv";
    
    var payload = new Dictionary<string, string>
    {
        ["username"] = Environment.GetEnvironmentVariable("BULKSMS_USERNAME") ?? "YOUR_USERNAME",
        ["password"] = Environment.GetEnvironmentVariable("BULKSMS_PASSWORD") ?? "YOUR_PASSWORD",
        ["msisdn"] = "12025550100"
    };
    
    using var http = new HttpClient
    {
        Timeout = TimeSpan.FromSeconds(30)
    };
    
    using var content = new FormUrlEncodedContent(payload);
    using var response = await http.PostAsync(endpoint, content);
    
    var body = await response.Content.ReadAsStringAsync();
    
    if (!response.IsSuccessStatusCode)
    {
        throw new HttpRequestException($"HTTP {(int)response.StatusCode}: {body}");
    }
    
    if (body.TrimStart().StartsWith("{", StringComparison.Ordinal))
    {
        using var json = JsonDocument.Parse(body);
        Console.WriteLine(json.RootElement.ToString());
    }
    else
    {
        Console.WriteLine($"MNV validation error code: {body}");
    }

import java.net.URI;
    import java.net.URLEncoder;
    import java.net.http.HttpClient;
    import java.net.http.HttpRequest;
    import java.net.http.HttpResponse;
    import java.nio.charset.StandardCharsets;
    import java.time.Duration;
    import java.util.Map;
    import java.util.stream.Collectors;
    
    public class MnvValidation {
        public static void main(String[] args) throws Exception {
            String endpoint = "https://api.bulksmsonline.co/mnv";
    
            Map<String, String> payload = Map.of(
                "username", getenvOrDefault("BULKSMS_USERNAME", "YOUR_USERNAME"),
                "password", getenvOrDefault("BULKSMS_PASSWORD", "YOUR_PASSWORD"),
                "msisdn", "12025550100"
            );
    
            String formBody = payload.entrySet()
                .stream()
                .map(e -> encode(e.getKey()) + "=" + encode(e.getValue()))
                .collect(Collectors.joining("&"));
    
            HttpClient client = HttpClient.newBuilder()
                .connectTimeout(Duration.ofSeconds(15))
                .build();
    
            HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(endpoint))
                .timeout(Duration.ofSeconds(30))
                .header("Content-Type", "application/x-www-form-urlencoded")
                .header("Accept", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(formBody))
                .build();
    
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    
            if (response.statusCode() < 200 || response.statusCode() >= 300) {
                throw new RuntimeException("HTTP " + response.statusCode() + ": " + response.body());
            }
    
            String body = response.body().trim();
    
            if (body.startsWith("{")) {
                System.out.println("MNV validation result: " + body);
            } else {
                System.out.println("MNV validation error code: " + body);
            }
        }
    
        private static String encode(String value) {
            return URLEncoder.encode(value, StandardCharsets.UTF_8);
        }
    
        private static String getenvOrDefault(String key, String fallback) {
            String value = System.getenv(key);
            return value == null || value.isBlank() ? fallback : value;
        }
    }