POSTPublicmobile-empty-check

Phone Number Status Check

Provides highly accurate phone number status checking services. Identify disconnected, invalid, and active numbers to help businesses optimize data and reduce marketing costs.

Documentation

Features

The phone number status check service uses carrier interfaces to query the real-time status of mobile numbers, including invalid, disconnected, active, powered off, and high-risk numbers. This service helps users identify invalid numbers, effectively improving data quality, preventing resource waste, and boosting communication efficiency. It supports bulk queries with fast response times and highly accurate results.

Use Cases

Widely used in various enterprise scenarios, such as phone number scrubbing before SMS marketing campaigns to ensure precise delivery; maintaining customer data in CRM systems by removing invalid contacts; identifying potential high-risk numbers in financial risk control; and optimizing outbound call lists for call centers to improve connection rates and reduce operating costs.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "mobile_number": "13800138000"
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "status": "在用",
    "desc": "实号"
  }
}

Request Fields

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

Path	Type	Sample
mobile_number	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	在用
data.desc	string	实号

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

import os import requests url = "https://openapi.toolkk.com/v1/mobile-empty-check" payload = { "mobile_number": "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-empty-check" payload := []byte("{\n \"mobile_number\": \"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_number\": \"13800138000\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/mobile-empty-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-empty-check'; $payload = "{\n \"mobile_number\": \"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

Features

Use Cases

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online