Send SMS Download full documentation
To send messages though our API you need to make a HTTP GET call to our API with your account and SMS details. Below are all the details needed to make correct calls to the HTTP API.
Be sure to read the whole page, this will prevent simple mistakes and it will explain some of the special parameters of this call below.
Send SMS API endpoint
https://api.budgetsms.net/sendsms/
Send SMS parameters
| Variable | Description | Format | Required | Example |
|---|---|---|---|---|
| username | BudgetSMS username | Alphanumeric | Yes | user1 |
| userid | BudgetSMS userid | Numeric | Yes | 21547 |
| handle | BudgetSMS handle | Alphanumeric | Yes | 1e753da74 |
| msg | SMS message content | Alphanumeric | Yes | This is example content |
| from | SMS senderid | Alphanumeric or Numeric | Yes | BudgetSMS |
| to | SMS message receiver msisdn | Numeric | Yes | 31612345678 |
| customid | Custom identifier that can only be used once | Alphanumeric | No | 1324513254 |
| price | Get price information of the submitted message in the response | 1 or 0 | No | 1 |
| mccmnc | Get country and operator information of the submitted message in the response | 1 or 0 | No | 1 |
| credit | Get account credit in the response | 1 or 0 | No | 1 |
More information about send SMS parameter "to"
Make sure the value of this parameter is formatted correctly. Please follow the international formatting E.164
For example, you are sending an SMS to mobile number 06-12345678 in The Netherlands (country prefix: +31). The correctly formatted number would then become: 31612345678
No leading 00 or +, also no spaces or dashes in the number.
More information about send SMS parameter "customid"
Customid is created for customers that need to send a message only once. By submitting the message to the API with a customid, makes sure that the customid can only be used once. An error will occur when a customid is already used before.
If you do not have a specific use for this, as explained, please do not use this parameter.
More information about send SMS parameter "price"
When you include price=1 when sending SMS you will receive information about how many SMS parts the message contained and what the total price was.
More information about send SMS parameter "mccmnc"
When mccmnc=1 is included in the request, the response will contain information about the destination mcc and mnc. This can be used for storing information to what operator the SMS was sent to. If a country allows numbers to be ported, it will contain the actual operator the number is ported to.
More information about send SMS parameter "credit"
When credit=1 is included in the sendsms request, the response will contain the remaining credit of the account.