POSTPublicmobile-status-check

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

{
  "mobile": "13800138000"
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "status": "正常在用"
  }
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
mobile	string	13800138000

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	string	SUCCESS
message	string	success
data	object	{...}
data.status	string	正常在用

curl --request POST \ --url 'https://openapi.toolkk.com/v1/mobile-status-check' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "mobile": "13800138000"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/mobile-status-check" payload = { "mobile": "13800138000" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/mobile-status-check" payload := []byte("{\n \"mobile\": \"13800138000\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"mobile\": \"13800138000\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/mobile-status-check")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/mobile-status-check'; $payload = "{\n \"mobile\": \"13800138000\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

Phone Number Status Check

Documentation