Send SMS


This endpoint allows you to send one or multiple sms at once to any country.

API Endpoint



You can choose one of the authentication methods referenced here.

Message object

The JSON object representing the SMS to send. Should be included in request body.

key description required default value
to array<string> Array ofE164formatted mobile numbers Yes
message string Your SMS message Yes
unicode boolean Indicates whether your message contains non-gsm characters No false

SMS messages are limited to 160 characters (70 if using unicode). If the size exceeds the limit, messages will be split and billed separately.


status code description
200 success Request sent successfully
400 bad request Incorrect or missing parameters
401 unauthorized Invalid credentials or incorrect authentication method

Request example


Content-type: application/json
Authorization: BASIC base64encodedCredentials


  "to": ["32412345678","32423456789"],
  "message": "Hello world",
  "unicode": false

Response example

    "code": 200,
    "message": "OK",
    "total_sms": 2,
    "valid_numbers": 2,
    "data": {
        "callerID": "NOMADO",
        "text": "Hello world",
        "unicode": 0,
        "32412345678": {
            "code": 200,
            "status": "SENT"
        "32423456789": {
            "code": 200,
            "status": "SENT"
    "cost": 0.20,
    "currency": "EUR"