This section of the control panel is dedicated to developers.
If you need to implement specific features such as home automation , OTP (One-Time Password) systems, or similar functionalities, you can use our APIs .
Integration is extremely simple: in the table below, locate the row corresponding to the API you’re interested in, then scroll to the right to find the “CODE” button.
By clicking it, you’ll access the source code examples for integration in various programming languages.
For more information, refer to the complete API guide .
Sending from Multiple Devices
As explained earlier, our app can be installed on multiple devices, allowing large-scale and fast SMS delivery in a short amount of time.
There is no limit to the number of phones that can be linked for message sending.
Each phone is connected to a specific list through a PIN .
When you send a message via the API, the request is forwarded to all associated phones, but only one of them (the first available) will actually send the SMS.
Response and Message Handling
The HTTP response, in JSON format , may contain more than one record, each one indicates that the request was received by a specific device.
This is normal behavior and is used to track which phone performed the sending.
Message Status Verification via IPN
To check the status of a message, that is, to confirm whether it was sent or delivered , use IPN (Instant Process Notification) .
When a message is sent or delivered to the recipient’s phone, the IPN automatically makes a call to a script on your server (if enabled).
Through this call, you can receive real-time confirmation of both the sending and delivery of the message.
IP Authorization and API Settings
In the video below, you can see the “Allow only from IP” option.
If enabled, only the specified IP address will be authorized to make HTTP requests to the API.
It’s also important to specify the correct domain if cross-domain access is required.
JSON API Response – GenioApi
When an API request is made, the response returned by GenioApi includes a status code and additional informational parameters:
{
"response": "200",
"status_code": "2"
}
• response: "200" – The request was valid and successfully delivered to all connected phones. Only one of them (the first available) will actually send the SMS. This status indicates that the message has been delivered to the device, not yet to the final recipient .
• status_code: "2" – Indicates that any IP address can send messages because the over_ip option is active.
To obtain the actual status of a message ( sent or delivered ), you need to use IPN (Instant Process Notification) , which provides real-time updates on message transmission and delivery.
Status Code Table (`status_code`)
| Code | Status | Description |
|---|---|---|
| 1 | ok_ip | Sending allowed because the IP address is authorized. |
| 2 | ok_over_ip | Sending allowed from any IP becauseover_ip > 0 and `API key = 0`. |
| 3 | api_key_error | Sending not allowed: incorrect API token. |
| 4 | unauthorized_ip | Sending not allowed: IP address not authorized. |
| 5 | param_error | Sending not allowed: invalid parameters (deprecated). |
| 6 | token_or_id_device_error | Sending not allowed: incorrect device token or device ID. |
| 7 | missing_to_number | Sending not allowed: missing destination number. |
| 8 | missing_msg | Sending not allowed: missing message content. |
| 9 | balance_error | Sending not allowed: insufficient credit. |
In the following video, we’ll show you how to create and use an API , where to find the example code, and how to run a test send using cURL .
