Free Phone Number Generator API

Endpoint

GET https://freephonenum.com/api/generate-phone-numbers

Quick start

curl "https://freephonenum.com/api/generate-phone-numbers?country=us&count=3&format=e164"

Parameters

Param	Default	Description
country	US	2-letter ISO code (US, GB, IN, DE, BR…). 30+ supported.
count	5	How many numbers to return (1-100).
format	e164	e164 (+14155550132), intl, national, or plain.

Response

{
  "country": "United States",
  "country_code": "+1",
  "format": "e164",
  "count": 3,
  "numbers": ["+14155550132", "+12027550148", "+13105550199"],
  "disclaimer": "Randomly generated dummy data for testing only..."
}

Examples

JavaScript

const res = await fetch(
  'https://freephonenum.com/api/generate-phone-numbers?country=gb&count=10'
);
const { numbers } = await res.json();
console.log(numbers);

Python

import requests
r = requests.get("https://freephonenum.com/api/generate-phone-numbers",
                 params={"country": "in", "count": 20, "format": "national"})
print(r.json()["numbers"])

PHP

$data = json_decode(file_get_contents(
  "https://freephonenum.com/api/generate-phone-numbers?country=de&count=5"
), true);
print_r($data["numbers"]);

Notes

The numbers are random dummy data matching each country's format — they pass validation but cannot receive calls or SMS. Use them for testing, never for real verification.
Free, no API key, open CORS (call it from the browser). Please keep count reasonable.
Need a number that actually receives a code? Use our free numbers to receive SMS instead.

Embed the generator on your site (free)

Prefer a widget over the API? Paste this snippet to embed the live generator on any page — your readers get a working tool, no code required:

<iframe src="https://freephonenum.com/embed/number-generator"
  width="100%" height="380" frameborder="0" loading="lazy"
  title="Fake Phone Number Generator"></iframe>
<p>Free <a href="https://freephonenum.com/fake-phone-number-generator">Fake Phone Number Generator</a> by FreePhoneNum</p>

Live preview:

Interactive generator OTP data study Test SMS verification guide