Send SMS

get

https://ngn.rmlconnect.net:8443/bulksms/bulksms

Submits an SMS message to one or more destination numbers. Supports plain
text, flash, Unicode, and WAP Push message types in a single call.

For multiple destinations, separate numbers with a comma (URL-encode the
comma itself). The platform processes each destination independently and
returns one result line per destination.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

username

string

required

HTTP account username issued by Route Mobile.

password

required

HTTP account password.

type

integer

enum

required

Message type / character encoding:

0: Plain Text (GSM 03.38)
1: Flash Message (GSM 03.38)
2: Unicode
3: Reserved
4: WAP Push
5: Plain Text (ISO-8859-1)
6: Unicode Flash
7: Flash Message (ISO-8859-1)

dlr

integer

enum

required

Whether a delivery report is required. 0 = not required, 1 = required.

Allowed:

destination

string

required

Destination mobile number(s), with or without a leading +. Multiple
numbers are comma-separated (URL-encode the comma).

source

string

required

length ≤ 18

Sender ID displayed to the recipient. Maximum length is 18 characters if
numeric, or 11 characters if alphanumeric. Additional restrictions may
be enforced by the destination carrier.

message

string

required

Message content, URL encoded using UTF-8. For Unicode message types
(2, 6), the content must additionally be hex-encoded in UTF-16BE
format before URL encoding.

url

string

Landing page link, used only when type=4 (WAP Push). Not required for
any other message type; if supplied for other types, it is ignored.

Responses

Code	Meaning
1701	Success - message submitted. Response includes the message ID for DLR mapping.
1702	Invalid URL error - one or more required parameters were missing or left blank.
1703	Invalid value in `username` or `password`.
1704	Invalid value in `type`.
1705	Invalid message content.
1706	Invalid destination number.
1707	Invalid source/sender ID.
1708	Invalid value for `dlr`.
1709	User validation failed - this is the only code that is safe to retry.
1710	Internal error.
1025	Insufficient credit balance.
1715	Response timeout - do not resubmit the same message.

400

Malformed request - for example, the query string is empty or unparseable.

401

Reserved for transport-level authentication failures. Account-level
authentication issues (bad username/password) are returned as a
1703 code in the 200 response body rather than an HTTP 401.

500

Internal server/gateway error at the transport level.

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

text/plain