SMS WW via API is the service that allows you to send certified, high-quality, professional SMS messages worldwide, with a customized sender.
The SMS is the first mobile communication channel, offering the certainty of message delivery even in the absence of network coverage. For this reason, it represents the ideal tool for real-time and secure communications such as alerts, transactional messages, two-factor authentication, and report availability notifications.
The Openapi service allows you to quickly send the same message to one or more recipients.
The dryRun and failOnMultipleMessages options allow you to control and validate message sending before the actual dispatch, reducing errors, unwanted costs, and compliance issues.
- dryRun: allows you to simulate the sending of an SMS without the message actually being sent. Ideal for checking the text in advance and ensuring it does not contain forbidden words or content.
- failOnMultipleMessages: prevents the sending of multiple messages. If the text contains special characters that would cause it to be split into multiple SMS messages, the sending is blocked and an ALERT warning is displayed.
SENDING SMS
The POST/WW-messages method allows you to send one or more SMS messages worldwide. To send a message through this endpoint, you must have a minimum credit on your account equal to €1.00 multiplied by the number of message parts (messageCount). The final price varies depending on the recipient’s operator.
IMPORTANT: if the message content or the sender contains prohibited words, the message will be blocked, the account will be added to the block list, and a penalty of €1 will be charged for each part of the message.
REQUEST EXAMPLE
POST/messages
This is an example request:
{
"sender": "MyCompany",
"recipient": "+393331234567",
"message": "Hello! This is a test message.",
"options": {
"dryRun": false,
"failOnMultipleMessages": false
},
"callback": {
"method": "JSON",
"field": "data",
"url": "https://www.mysite.com/myEndpoint",
"retry": 3,
"headers": {
"session_id": "9834r5fh589494"
},
"custom": {
"my_custom_id": "123456789"
}
}
}
RESPONSE EXAMPLE
POST/messages
The response returns the details of the accepted and queued message:
{
"id": "633aabe3e4a9a0e69811ad7f",
"username": "[email protected]",
"state": "NEW",
"sender": "Openapi",
"recipient": "string",
"internationalPrefix": "39",
"countryCode": "IT",
"message": "Lorem ipsum dolor sit amet, consectetur adipiscing elit",
"encoding": "GSM-7",
"charactersCount": 0,
"messageCount": 0,
"price": 0,
"totalPrice": 0,
"blocklisted": true,
"blocklistedReason": "string",
"options": {
"dryRun": false,
"failOnMultipleMessages": false
},
"callback": {
"method": "JSON",
"field": "data",
"url": "https://www.mysite.com/myEndpoint",
"retry": 3,
"headers": {
"session_id": "9834r5fh589494"
},
"custom": {
"my_custom_id": "123456789"
}
},
"createdAt": "2026-01-28T11:21:20.127Z",
"updatedAt": "2026-01-28T11:21:20.127Z",
"sentAt": "2026-01-28T11:21:20.127Z",
"deliveredAt": "2026-01-28T11:21:20.127Z"
}
VIEW SENT MESSAGES
GET /messagesThrough the GET/messages endpoint, it is possible to obtain a paginated list of messages sent by the account.
{
"id": "633aabe3e4a9a0e69811ad7f",
"username": "[email protected]",
"state": "NEW",
"sender": "Openapi",
"recipient": "string",
"internationalPrefix": "39",
"countryCode": "IT",
"message": "Lorem ipsum dolor sit amet, consectetur adipiscing elit",
"encoding": "GSM-7",
"charactersCount": 0,
"messageCount": 0,
"price": 0,
"totalPrice": 0,
"blocklisted": true,
"blocklistedReason": "string",
"options": {
"dryRun": false,
"failOnMultipleMessages": false
},
"callback": {
"method": "JSON",
"field": "data",
"url": "https://www.mysite.com/myEndpoint",
"retry": 3,
"headers": {
"session_id": "9834r5fh589494"
},
"custom": {
"my_custom_id": "123456789"
}
},
"createdAt": "2026-01-28T11:21:20.127Z",
"updatedAt": "2026-01-28T11:21:20.127Z",
"sentAt": "2026-01-28T11:21:20.127Z",
"deliveredAt": "2026-01-28T11:21:20.127Z"
}GET MESSAGE DETAILS
GET /messages/{id}Allows you to obtain all information about the sent message (via its ID), e.g. sender, content, number of recipients, overall delivery statistics, and costs.
{
"id": "633aabe3e4a9a0e69811ad7f",
"username": "[email protected]",
"state": "NEW",
"sender": "Openapi",
"recipient": "string",
"internationalPrefix": "39",
"countryCode": "IT",
"message": "Lorem ipsum dolor sit amet, consectetur adipiscing elit",
"encoding": "GSM-7",
"charactersCount": 0,
"messageCount": 0,
"price": 0,
"totalPrice": 0,
"blocklisted": true,
"blocklistedReason": "string",
"options": {
"dryRun": false,
"failOnMultipleMessages": false
},
"callback": {
"method": "JSON",
"field": "data",
"url": "https://www.mysite.com/myEndpoint",
"retry": 3,
"headers": {
"session_id": "9834r5fh589494"
},
"custom": {
"my_custom_id": "123456789"
}
},
"createdAt": "2026-01-28T11:21:20.127Z",
"updatedAt": "2026-01-28T11:21:20.127Z",
"sentAt": "2026-01-28T11:21:20.127Z",
"deliveredAt": "2026-01-28T11:21:20.127Z"
}Do you need help?
Haven't found the answer you're looking for?
Fill in all the details, we will get back to you as soon as possible!
SMS Worldwide is Openapi’s API solution that enables you to send professional SMS messages to mobile numbers worldwide, with a custom sender ID and certified delivery standards. It is ideal for managing immediate, reliable, and scalable communications, such as alerts, transactional notifications, two-factor authentication (2FA), and real-time updates, all through a single integration.
The SMS API includes features such as:
-
dryRun: allows you to validate the request and estimate the cost without actually sending the SMS
-
failOnMultipleMessages: checks whether the message exceeds the length of a single SMS, preventing the sending of concatenated messages
-
Custom sender name personalization
Yes. SMS Italia allows you to send the same message to one or multiple recipients in just a few moments by integrating the service directly into your systems via API.
Yes, the API has a dedicated endpoint for monitoring the status of each message. This feature allows you to obtain detailed information about sent messages, such as recipients, delivery status, and overall statistics.
The maximum length of an SMS depends on the encoding type used:
-
GSM-7: up to 160 characters per single SMS
-
UCS-2 (used for special characters, emojis, or non-Latin alphabets): up to 70 characters per single SMS
If the message exceeds these limits, it will be automatically split into multiple SMS messages.
Alternatively, you can use the failOnMultipleMessages option, which blocks the sending if the message exceeds the length of a single SMS.
Yes, you can view all the information about a specific message, such as the sender, content, number of recipients, delivery status, and cost. It's simple and helps you keep track of all details.
The SMS API service is designed for companies, developers, and digital teams that need a reliable, immediate, and highly effective communication channel that can be easily integrated into their systems and application workflows.
It is particularly suitable for:
-
OTP and Two-Factor Authentication (2FA) to increase access security
-
Real-time notifications and alerts, even without a data connection
-
Order, payment, and appointment confirmations to improve user experience
-
SMS marketing campaigns with high deliverability
-
Two-way SMS to manage user interactions and replies
-
Onboarding or activation flows for platforms and digital services
-
SIM activation, usage alerts, and credential resets
-
Appointment reminders and alerts for reports or sensitive communications
Thanks to its flexibility, the SMS API is suitable for both critical transactional communications and marketing and customer engagement initiatives, ensuring speed, reliability, and scalability.
The cost per single request varies depending on the destination country. You can consult the full price list, broken down by continent and country, in the dedicated section of the portal. When sending SMS Worldwide to Italian or Spanish numbers, if the relevant SMS Italia or SMS Spain subscriptions are active, the traffic is deducted from the subscription credit, allowing you to benefit from more competitive rates.
Carbon free energy for Our Cloud 
Low CO2
© 2024 Openapi SpA, a single-member company, under the direction and control of Open Holding Srl.
Viale Filippo Tommaso Marinetti 221 - 00143 Rome - Business Register: 1378273, Share Capital: €50,000.00, VAT Number: IT12485671007, Recipient Code: 'USAL8PV' - Certified Email: 
Openapi is certified in: Quality System **UNI EN ISO 9001:2015** - Data Quality **ISO 25012:2014** - Security Management **ISO/IEC 27001:2022** - Geneder Equality According UNI PdR 125:2022
All prices are net of any VAT, stamp duty, registration fees, or other taxes that may be due. All logos listed on the portal are copyrighted and owned by their respective owners.
