POSTPublicrandom-phone-generate

Random Phone Number Generator

Batch generation of random mobile numbers compliant with various country rules, supporting China, USA, Japan, and more. Customizable by operator and format, up to 100 entries per request, meeting the testing needs of multilingual systems.

Usage Cost

1 coins/call

Try it online

Fire a real request right from your browser, no code required

Documentation

API Capabilities

This API provides a service for batch generation of random mobile numbers. It supports generating mobile numbers for multiple countries and regions, including China (can be subdivided by specific operators), the United States, Japan, and others. Developers can configure whether to include international dial codes and whether to use hyphens for formatted output, as needed. A single request supports generating up to 100 mobile number data entries.

Request and Response

Request Parameters:
count: Number to generate, maximum 100 per request.
country: Country or region code (e.g., CN for China).
operator: Operator type (e.g., all for any, or specify a particular operator).
includeDialCode: Whether to prepend the international dial code (e.g., +86) to the number.
formatWithDash: Whether to format the number with hyphens (-).
Return Results: The field will return a string array containing a list of random mobile numbers generated according to the specified rules.

Integration Examples

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

Request Example

{
  "count": 10,
  "country": "CN",
  "operator": "all",
  "includeDialCode": false,
  "formatWithDash": false
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": [
    "13812345678",
    "15987654321"
  ]
}

Request Fields

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

Path	Type	Sample
count	number	10
country	string	CN
operator	string	all
includeDialCode	boolean	false
formatWithDash	boolean	false

Response Fields

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

Path	Type	Sample
code	string	SUCCESS
message	string	success
data	array	"13812345678"
data[]	string	13812345678

curl --request POST \ --url 'https://openapi.toolkk.com/v1/random-phone-generate' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "count": 10,\n "country": "CN",\n "operator": "all",\n "includeDialCode": false,\n "formatWithDash": false\n}'

import os import requests url = "https://openapi.toolkk.com/v1/random-phone-generate" payload = { "count": 10, "country": "CN", "operator": "all", "includeDialCode": false, "formatWithDash": false } 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/random-phone-generate" payload := []byte("{\n \"count\": 10,\n \"country\": \"CN\",\n \"operator\": \"all\",\n \"includeDialCode\": false,\n \"formatWithDash\": false\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 \"count\": 10,\n \"country\": \"CN\",\n \"operator\": \"all\",\n \"includeDialCode\": false,\n \"formatWithDash\": false\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/random-phone-generate")) .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/random-phone-generate'; $payload = "{\n \"count\": 10,\n \"country\": \"CN\",\n \"operator\": \"all\",\n \"includeDialCode\": false,\n \"formatWithDash\": false\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;

Random Phone Number Generator

Try it online

Documentation

API Capabilities

Request and Response

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Use Cases

Usage Notes and Limitations

Shell Example

Python Example

Go Example

Java Example

PHP Example