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 via API is a service that allows you to send certified, high-quality, and professional SMS messages globally. It enables sender customization and provides detailed delivery reports for each message sent.
The SMS API offers high scalability, fast sending times, and simple integration with your systems. It allows you to automate message sending and personalize content for each recipient. With the same endpoint, you can send SMS messages globally (to any country in the world). Additionally, messages can be sent to single or multiple recipients.
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.
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.
Yes, the SMS API service supports sending SMS messages worldwide. Prices vary depending on the destination country and can be consulted in the dedicated section of the Console.
The SMS service can be used for various purposes, including:
- Alerts and transactional notifications.
- Two-factor authentication.
- Appointment reminders.
- School, business, or public utility communications.
- Marketing.
- Onboarding or activation workflows on platforms.
The cost for a single request starts at €0.004. Prices for sending SMS messages vary based on the destination country. To view the full list of costs, please visit the Prices section on the CONSOLE portal.
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.
