Sending a binary data SMS message using HTTP
Overview
This page describes how to send a binary data message through the SMS Gateway. This request type is commonly used to send binary information to a specific port or application on an end user's mobile phone.
For information about integrating with the SMS Gateway, see either Sending a Single SMS or Broadcasting an SMS.
Sending binary data as an SMS message
| Single-recipient end points: |
http://sms.openmarket.com/sms/v1/send https://sms.openmarket.com/sms/v1/send |
| Broadcast end points: (HTTP POST only) |
http://sms.openmarket.com/sms/v1/bulksend https://sms.openmarket.com/sms/v1/bulksend |
Example single-recipient request:
http://sms.openmarket.com/sms/v1/send?This sends the binary content 0x01020304 to port 0x1234 on the mobile phone, from the account MyBulkAccount, with password P4ssw0rD, to the recipient 447700900750.
Mandatory parameters:
| Parameter | Description | |
| user | The SMS Gateway account you are sending the message through. | |
| pass | The password for the SMS Gateway account. | |
| smsto | The MSISDN of the message recipient in international format (e.g. 447700900750). No leading "+" is required.
If you are sending a broadcast SMS request, separate each MSISDN with a line break (e.g. smsto=447700900750%0A447700900765%0A447700900999). | |
| smsfrom | Either a phone number (up to 16 digits) or an alphanumeric string encoded in the
Modified Latin-9 character set (up to 11 characters). This parameter is
mandatory for bulk services in all regions accept the US. Regulatory requirements means that you cannot change the originator for Premium Rate SMS messages in any region. In these instances, the originator is always your service's Short Code. If you do set the originator, the SMS Gateway will ignore the value. | |
| smsmsg | The 8-bit binary content you are sending. You must hexadecimal encode the data. | |
| smsudh | The UDH information, in the format of octet pairs in decimal notation, e.g. 06050430393039. | |
Optional parameters specific to this request type:
There are no optional parameters specific to sending a Binary Data message request.
Optional parameters you can use for any request type:
- submitid: used to send broadcast SMS messages
- report: sets the delivery reports you want for the message
- response: (for single-recipient requests only) changes the format of the HTTP response from the SMS Gateway
- note, subaccount: optional reporting notes that you can add to the request
- vp, billingsingleshot: alters the validity period and billing for the SMS message
- purpose: (US only) adds message purpose details required by Verizon for Premium Rate services
- optin1, optin1ts, optin2, optin2ts: (US only) adds opt-in details required by T-Mobile US for Premium Rate services
