Send SMS to many numbers (GET form)

Sends one text to several phone numbers in one call.

Kept for existing integrations. This is the same call as the POST form, with every field in the address instead of a JSON body. Your API key and the message text travel in the address, where proxies and logs can record them. New integrations should use the POST form.

Authentication. Put your API key in the api_id query parameter. If your account has a list of allowed IP addresses, the call must come from one of them.

Before you call. You need an approved sender name and enough balance.

Rules

Every number in phonenumber must be in international E.164 format; one invalid number refuses the whole request.

Send either textmessage or templateid.

Send either sms_type or rate_plan_id.

A local number such as 091234567 and the 00 prefix are refused.

The answer. The call answers HTTP 200 whether the message is accepted or refused, so read status.

status: "S": accepted. Keep message_id; you need it to look up the delivery result.

status: "F": refused. remarks says why, for example SenderId is not found.

Delivery result. Give a callback_url and we post the result to it, once for each number, or ask later with the SMS status call (POST /api/partners/SmsDataRecords, filter campaignId = message_id).

Limits. Each API key may run a limited number of sends at the same time. Above the limit the call answers 429 with a Retry-After header: wait that many seconds and send again.

The answer carries one message_id for the whole send, and client_costs lists the price for each number.

curl --location 'https://api.veloconnect.me/api/SendSMSMulti?api_id=API1234567890&sender_id=MyBrand&phonenumber=+37491234567%2C+37499123456&textmessage=Your%20verification%20code%20is%20482913&templateid=10&sms_type=T&rate_plan_id=12&uid=order-1042&callback_url=https%3A%2F%2Fexample.com%2Fsms%2Fdelivery&ValidityPeriodInSeconds=172800&encoding=T'

{ "message_id": 1284417, "status": "S", "remarks": "Message submitted successfully", "uid": "order-1042", "client_costs": [ { "phonenumber": "+37491234567", "cost": 0.021 }, { "phonenumber": "+37499123456", "cost": 0.021 } ] }

Send SMS to many numbers (GET form)

Request

Responses