All Products
Search
Document Center

Short Message Service:API overview

Last Updated:Dec 08, 2025

API standard and pre-built SDKs in multi-language

The OpenAPI specification of this product (Dysmsapi/2018-05-01) follows the RPC standard. Alibaba Cloud provides pre-built SDKs for popular programming languages to abstract low-level complexities such as request signing. This enables developers to call APIs using language-specific syntax without dealing with HTTP details directly.

Custom signature

If your specific needs, such as a customized signature, are not supported by the SDK, manually sign requests using the signature mechanism. Note that manual signing requires significant effort (usually about 5 business days). For support, join our DingTalk group (ID: 147535001692).

Before you begin

An Alibaba Cloud account has full administrative privileges. A compromised AccessKey pair exposes all associated resources to unauthorized access, posing a significant security risk. Create a Resource Access Management (RAM) user with API-only access and use RAM policies to apply the principle of least privilege (PoLP). Alibaba Cloud accounts are only used when explicitly required.

To call APIs securely, configure the following:

Send messages

API

Title

Description

BatchSendMessageToGlobe BatchSendMessageToGlobe Sends a message to multiple recipients in countries or regions outside the Chinese mainland.
SendMessageWithTemplate SendMessageWithTemplate Sends a message to the Chinese mainland by using a message template.
SendMessageToGlobe SendMessageToGlobe Sends a message to regions outside the Chinese mainland.

Query messages

API

Title

Description

QueryMessage QueryMessage Queries the delivery report of a message.

SMS conversion rates

API

Title

Description

ConversionData ConversionData Reports the status of an OTP message to Alibaba Cloud SMS.
SmsConversion SmsConversion Delivers one-time password (OTP) message statuses to Alibaba Cloud, which calculates and monitors OTP conversion rates.