SMS SPAIN is the Openapi service dedicated to sending professional SMS to Spanish numbers, designed for companies that require reliable, immediate, and traceable communications, with a customized sender ID and high quality standards.
Thanks to its wide reach, SMS remains one of the most effective channels for reaching end users: the message is delivered even in the absence of a data connection and is ideal for critical notifications , transactional communications , OTP and two-factor authentication, operational notices, and real-time updates.
With SMS SPAIN by Openapi, it is possible to send single messages or multiple campaigns in just a few seconds, integrating the service directly into your application workflows via REST APIs.
The service provides advanced features to optimize and secure SMS delivery:
- dryRun: allows you to simulate message sending in order to preview the content in advance and reduce the risk of errors or policy violations.
- failOnMultipleMessages: automatically blocks sending if the text generates multiple SMS (for example, due to special characters), returning an ALERT notification.
SEND SMS
The POST/ES-messages endpoint allows you to create and queue a new SMS intended exclusively for Spanish numbers, applying operational rules and pricing specific to Spain.
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 the cost of the message will be charged.
REQUEST EXAMPLE
POST/ES-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/ES-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"
}
SENT MESSAGES CONSULTATION
GET /messagesThrough the GET/messages endpoint, it is possible to retrieve 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 retrieve all information related to the sent message (via its ID), such as 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!
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.
