Services reference

This page lists every check you can put in checks, with its code, alias, input type, mode (real time and bulk, or bulk only), outputs and country coverage. Codes and aliases are interchangeable in requests, and responses always use the full code. GET /v1/services returns the live list for your key, with prices. The site's services page may show a live version of this table.

How do I read this table?

• Input: phone services run on numbers, e-mail services on emails.
• Modes: "real time + bulk" works on POST /v1/lookup and in jobs. "Bulk only" works in bulk jobs only. "Bulk (real time paused)" works like bulk only for now: real-time requests are paused while our real-time route is unreliable and return 403 service_disabled.
• Outputs: registered means the answer is yes/no/unknown. Named attributes appear in attributes for conclusive answers.
• Countries: "all" means any country except sanctioned ones. Numbers outside a service's countries return unsupported_country and are not billed. "all except CN" means mainland China (+86) numbers are not covered; "bulk: except CN" means they are covered in real time but not in bulk jobs. Bulk jobs mark such checks before they run: the estimate lists them in unsupported_checks, and GET /v1/services lists them per mode in unsupported_countries.
• Asking for whatsapp.registered and whatsapp.business together runs only whatsapp.business, because it answers both.

Which phone services are there?

number.hlr asks the mobile network live whether a number is reachable, ported or roaming. number.mnp answers only whether a number was ported and which network it belongs to now. See HLR lookup and MNP lookup. Access to number.spam is limited while it is in review. Ask us if you need it. Its report coverage is strongest for North American and European numbers.

Which e-mail services are there?

E-mail services have no country limits. See e-mail checks for normalization and the anti-enumeration rules.

What do the attribute values mean?

Each attribute's type (string, boolean, enum, integer), with enum values and integer bounds, is also returned by GET /v1/services. Enums may gain values, so treat unknown values as unknown.

Which countries are never checked?

Numbers from sanctioned countries and regions are never checked, never sent to any network or data source, and never billed. The countries are Cuba, Iran, North Korea, Syria, Russia, Belarus and Venezuela, plus sanctioned regions. Every check on such a number answers unsupported_country, which is free. They don't appear in our coverage tables, country guides or datasets. We review the list when sanctions programmes change.

The same rule applies to e-mail addresses on Russian and Belarusian mail domains. Every e-mail check, including the account checks, answers unsupported_country for an address on:

• a Russian or Belarusian country domain: .ru, .su, .рф, .by or .бел, and the Russian city and regional domains .рус, .москва, .moscow and .tatar;
• a Yandex or Mail.ru (VK) mail domain, for example yandex.com, yandex.kz, yandex.ua, yandex.com.tr, ya.ru, mail.ru, inbox.ru, list.ru, bk.ru or vk.com.

Subdomains count too (name@sub.mail.ru), and domains are matched without regard to case. These addresses are never sent to any data source and never billed. Job estimates count them as unsupported, not billable.

How do I get the live list?

curl https://api.mobilevalidate.com/v1/services \
  -H "Authorization: Bearer mv_test_publicSandboxn9ZgneuhR1B9CRfKG3fulym"

// npm install mobilevalidate · Node.js 20+ · save as check.mjs and run: node check.mjs
import { MobileValidate } from "mobilevalidate";

// Omit apiKey to read MOBILEVALIDATE_API_KEY from the environment.
const mv = new MobileValidate({ apiKey: "mv_test_publicSandboxn9ZgneuhR1B9CRfKG3fulym" });
const { data, error } = await mv.services();
if (error) console.error(error.code, error.message);
else console.dir(data, { depth: null });

// Node.js 18+, Deno, Bun or the browser console (ES module: save as .mjs or use "type": "module").
const res = await fetch("https://api.mobilevalidate.com/v1/services", {
  headers: {
    Authorization: "Bearer mv_test_publicSandboxn9ZgneuhR1B9CRfKG3fulym",
  },
});
console.log(res.status, res.headers.get("x-request-id"));
console.dir(await res.json(), { depth: null });

# pip install mobilevalidate-sdk
from mobilevalidate import MobileValidate

# Omit api_key to read MOBILEVALIDATE_API_KEY from the environment.
mv = MobileValidate(api_key="mv_test_publicSandboxn9ZgneuhR1B9CRfKG3fulym")
result = mv.services()
print(result)

<?php
$ch = curl_init('https://api.mobilevalidate.com/v1/services');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mv_test_publicSandboxn9ZgneuhR1B9CRfKG3fulym',
    ],
]);
$response = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_RESPONSE_CODE), PHP_EOL, $response, PHP_EOL;

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.mobilevalidate.com/v1/services", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer mv_test_publicSandboxn9ZgneuhR1B9CRfKG3fulym")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

require "net/http"
require "json"

uri = URI("https://api.mobilevalidate.com/v1/services")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer mv_test_publicSandboxn9ZgneuhR1B9CRfKG3fulym"

res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.code, res.body

Each entry ("object": "service") has these fields: