SIM Management
API Reference
Send Sms

SendSms

This endpoint allows sending of an sms message to the sim.

Network Support

NetworkNetworkId
eSIMsmart218
eSIMsmart IOT225
MT-IOT M2MO232
MT-IOT M2MV233
Vodafone GDSP240
  • SIM status must be "on-hire"
  • All SIMs must be:
    • On the same network
    • On the same account

Request

NameTypeDescriptionRestrictions
serialNumbersstring arrayAn array of serial numbers corresponding to the SIMs you wish to updateAt least one
messagestringThe message to send. Max 160 characters
binaryboolShould the message be sent in binary format
protocolIdint0 - 255binary = true
Not supported on Vodafone GDSP
dataCodingSchemeint0 - 255binary = true
Not supported on Vodafone GDSP
userDataHeaderstringHex formatbinary = true
Not supported on Vodafone GDSP
Example SendSms
curl --location 'https://api.cellhire.com/api/simSubmission/SendSms' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjRBMDlENTFBMDhEOEUxMTU0OTkyODFDN...' \
--data '{
    "serialNumbers": [
        "987654321"
    ],
    "message": "test message",
    "binary": false
}'
Binary SendSms Example
curl --location 'https://api.cellhire.com/api/simSubmission/SendSms' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjRBMDlENTFBMDhEOEUxMTU0OTkyODFDN...' \
--data '{
    "serialNumbers": [
        "987654321"
    ],
    "message": "48656C6C6F2C20746869732069732061207465737420534D53",
    "binary": true,
    "protocolId": 7,
    "dataCodingScheme": 8,
    "userDataHeader": "0x05"
}'

Successful Response

NameTypeDescription
ticketNumberguidSubmission Id that has been created
{ "ticketNumber": "1beeb8dd-1825-4bcd-8a62-f941aacb8d15" }