Phone Number Status Check
Check the active status of mobile phone numbers, including whether they are in service, disconnected, or invalid. Helps businesses verify phone number validity.
Documentation
Phone Number Status Check
Overview
This API provides real-time status checking for mobile phone numbers. By inputting a phone number, the system returns its current status within the carrier network, such as active (in service), disconnected, invalid/empty, powered off, or non-existent. This feature is designed to help businesses and developers quickly and accurately verify phone number validity, preventing messages from being sent to invalid numbers and avoiding unnecessary resource expenditures.
Use Cases
- Marketing Campaigns: Batch verify the validity of target phone numbers before launching SMS marketing, outbound calling, or app push notifications. Ensure marketing resources are directed at real, active users to improve reach and conversion rates.
- User Registration & Login: Validate whether the phone number entered by a user during registration or login is real and active, effectively preventing fake registrations and malicious attacks.
- Risk Management: Industries such as finance and e-commerce can use this API to assess the risk of phone numbers submitted by users, identifying potential high-risk users or fraudulent activities.
- Data Cleaning & Maintenance: Regularly check the active status of phone numbers in your user database. Promptly remove invalid, disconnected, or empty numbers to optimize data quality and reduce operational costs.
- Identity Verification: Serve as a supplementary step in the identity verification process by checking the actual usage status of a user's phone number, thereby improving the reliability of the authentication.
Integration Examples
Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.
Request Example
{}Response Example
{
"code": 200,
"data": {
"result": {
"type": "string",
"example": "1",
"description": "0销号或未启用(不在网),1正常,2停机,3在网但不可用,4预销号 5关机"
},
"channel": {
"type": "string",
"example": "移动",
"description": "移动,电信,联通,广电"
},
"orderNo": {
"type": "string",
"example": "202406282055560705659"
},
"resultMsg": {
"type": "string",
"example": "正常"
},
"transferStatus": {
"type": "string",
"example": "0",
"description": "0未转网 1转网"
}
},
"message": "success"
}Response Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Sample |
|---|---|---|
| code | number | 200 |
| data | object | {...} |
| data.result | object | {...} |
| data.result.type | string | string |
| data.result.example | string | 1 |
| data.result.description | string | 0销号或未启用(不在网),1正常,2停机,3在网但不可用,4预销号 5关机 |
| data.channel | object | {...} |