REST API Documentation

{
    "sender": "InfoSMS",
    "receiver": "491700000001",
    "message": "Hello from the API!"
}

curl -X POST 'https://rest.mrmessaging.net/messages' \
-H 'Authorization: App <YOUR_API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
    "sender": "InfoSMS",
    "receiver": "491700000001",
    "message": "Hello from the API!"
}'

<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;

$client = new Client();
$apiKey = '<YOUR_API_KEY>';
$url = 'https://rest.mrmessaging.net/messages';

try {
    $response = $client->post($url, [
        'headers' => [
            'Authorization' => 'App ' . $apiKey,
            'Content-Type'  => 'application/json',
            'Accept'        => 'application/json',
        ],
        'json' => [
            'sender' => 'InfoSMS',
            'receiver' => '491700000001',
            'message' => 'Hello from the API!',
        ]
    ]);
    echo $response->getBody();
} catch (RequestException $e) {
    echo $e->getResponse()->getBody()->getContents();
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SendSms {
    public static void main(String[] args) throws Exception {
        String apiKey = "<YOUR_API_KEY>";
        String json = "{\n"
                + "    \"sender\": \"InfoSMS\",\n"
                + "    \"receiver\": \"491700000001\",\n"
                + "    \"message\": \"Hello from the API!\"\n"
                + "}";
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://rest.mrmessaging.net/messages"))
                .header("Authorization", "App " + apiKey)
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

import requests
import json

api_key = "<YOUR_API_KEY>"
url = "https://rest.mrmessaging.net/messages"
payload = {
    "sender": "InfoSMS",
    "receiver": "491700000001",
    "message": "Hello from the API!"
}
headers = {
    "Authorization": f"App {api_key}",
    "Content-Type": "application/json"
}
response = requests.post(url, data=json.dumps(payload), headers=headers)
print(response.status_code)
print(response.json())

{
    "messageId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "receiver": "491700000001",
    "status": "SENT",
    "messageCount": 1,
    "type": "GSM"
}

{
    "errorCode": 200,
    "description": "No route or pricing configured for the receiver number(s)."
}

{
    "errorCode": 401,
    "description": "Authentication failed. The provided API Key or credentials are not valid."
}

{
    "errorCode": 402,
    "description": "Your account has insufficient balance."
}

{
    "errorCode": 403,
    "description": "Permission denied. Your account is not authorized to perform this action."
}

{
    "errorCode": 429,
    "description": "Message throughput exceeded. Please try again later."
}

{
    "sender": "InfoSMS",
    "receiver": "491700000001",
    "message": "This is a message with all parameters. It also includes a unicode character: é",
    "type": "auto",
    "validityPeriod": 60,
    "reference": "cust-ref-123",
    "callbackUrl": "https://example.com/dlr"
}

curl -X POST 'https://rest.mrmessaging.net/messages' \
-H 'Authorization: App <YOUR_API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
    "sender": "InfoSMS",
    "receiver": "491700000001",
    "message": "This is a message with all parameters. It also includes a unicode character: é",
    "type": "auto",
    "validityPeriod": 60,
    "reference": "cust-ref-123",
    "callbackUrl": "https://example.com/dlr"
}'

<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;
$client = new Client();
$response = $client->post('https://rest.mrmessaging.net/messages', [
    'headers' => [
        'Authorization' => 'App <YOUR_API_KEY>',
        'Content-Type'  => 'application/json',
    ],
    'json' => [
        'sender' => 'InfoSMS',
        'receiver' => '491700000001',
        'message' => 'This is a message with all parameters. It also includes a unicode character: é',
        'type' => 'auto',
        'validityPeriod' => 60,
        'reference' => 'cust-ref-123',
        'callbackUrl' => 'https://example.com/dlr',
    ]
]);
echo $response->getBody();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
String json = "{\n"
        + "    \"sender\": \"InfoSMS\",\n"
        + "    \"receiver\": \"491700000001\",\n"
        + "    \"message\": \"This is a message with all parameters. It also includes a unicode character: é\",\n"
        + "    \"type\": \"auto\",\n"
        + "    \"validityPeriod\": 60,\n"
        + "    \"reference\": \"cust-ref-123\",\n"
        + "    \"callbackUrl\": \"https://example.com/dlr\"\n"
        + "}";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://rest.mrmessaging.net/messages"))
        .header("Authorization", "App <YOUR_API_KEY>")
        .header("Content-Type", "application/json")
        .POST(HttpRequest.BodyPublishers.ofString(json))
        .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

import requests
import json
payload = {
    "sender": "InfoSMS",
    "receiver": "491700000001",
    "message": "This is a message with all parameters. It also includes a unicode character: é",
    "type": "auto",
    "validityPeriod": 60,
    "reference": "cust-ref-123",
    "callbackUrl": "https://example.com/dlr"
}
headers = {"Authorization": "App <YOUR_API_KEY>", "Content-Type": "application/json"}
response = requests.post("https://rest.mrmessaging.net/messages", data=json.dumps(payload), headers=headers)
print(response.json())

{
    "messageId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "receiver": "491700000001",
    "status": "SENT",
    "reference": "cust-ref-123",
    "messageCount": 1,
    "type": "UNICODE"
}

{
    "errorCode": 110,
    "description": "The 'sender' field is required."
}

{
    "sender": "12345",
    "receiver": "491700000001",
    "hexMessage": "041A043E04340020043F043E04340442043204350440043604340435043D0438044F003A0020003000370039003300310033",
    "dataCoding": 8,
    "esmClass": 0,
    "reference": "cust-ref-hex"
}

curl -X POST 'https://rest.mrmessaging.net/messages' \
-H 'Authorization: App <YOUR_API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
    "sender": "12345",
    "receiver": "491700000001",
    "hexMessage": "041A043E04340020043F043E04340442043204350440043604340435043D0438044F003A0020003000370039003300310033",
    "dataCoding": 8,
    "esmClass": 0,
    "reference": "cust-ref-hex"
}'

<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;
$client = new Client();
$response = $client->post('https://rest.mrmessaging.net/messages', [
    'headers' => [
        'Authorization' => 'App <YOUR_API_KEY>',
        'Content-Type'  => 'application/json',
    ],
    'json' => [
        'sender' => '12345',
        'receiver' => '491700000001',
        'hexMessage' => '041A043E04340020043F043E04340442043204350440043604340435043D0438044F003A0020003000370039003300310033',
        'dataCoding' => 8,
        'esmClass' => 0,
        'reference' => 'cust-ref-hex',
    ]
]);
echo $response->getBody();

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
String json = "{\n"
        + "    \"sender\": \"12345\",\n"
        + "    \"receiver\": \"491700000001\",\n"
        + "    \"hexMessage\": \"041A043E04340020043F043E04340442043204350440043604340435043D0438044F003A0020003000370039003300310033\",\n"
        + "    \"dataCoding\": 8,\n"
        + "    \"esmClass\": 0,\n"
        + "    \"reference\": \"cust-ref-hex\"\n"
        + "}";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://rest.mrmessaging.net/messages"))
        .header("Authorization", "App <YOUR_API_KEY>")
        .header("Content-Type", "application/json")
        .POST(HttpRequest.BodyPublishers.ofString(json))
        .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

import requests
import json
payload = {
    "sender": "12345",
    "receiver": "491700000001",
    "hexMessage": "041A043E04340020043F043E04340442043204350440043604340435043D0438044F003A0020003000370039003300310033",
    "dataCoding": 8,
    "esmClass": 0,
    "reference": "cust-ref-hex"
}
headers = {"Authorization": "App <YOUR_API_KEY>", "Content-Type": "application/json"}
response = requests.post("https://rest.mrmessaging.net/messages", data=json.dumps(payload), headers=headers)
print(response.json())

{
    "messageId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "receiver": "491700000001",
    "status": "SENT",
    "reference": "cust-ref-hex",
    "messageCount": 1
}

{
    "errorCode": 200,
    "description": "No route or pricing configured for the receiver number(s)."
}