Quelles vérifications de validation sont effectuées ?

Validation du format, détection du type de numéro, identification du pays/région, recherche de l'opérateur et détection du fuseau horaire.

Quels formats de numéro sont retournés ?

Formats local, international, E.164 et RFC3966 plus le code pays et l'indicatif d'appel.

Combien de crédits par validation ?

1 crédit par validation de téléphone. Beaucoup moins cher que la recherche de téléphone (10 crédits).

Puis-je valider en masse ?

Oui. L'API Validation de Téléphone en Masse traite des milliers de numéros via CSV ou API.

// get /v1/phone-validator

API Validation de Téléphone

Validez les numéros de téléphone en temps réel vérification du format, détection du type, identification du pays et de l'opérateur via notre API RESTful.

Obtenir une clé API gratuite Référence de l'API

1 search credit

// console api

Exemple de réponse tiré de la référence de l'API

valid: true
intl_format: +1 650-555-0132
line_type: MOBILE
carrier: AT&T
country_code: US
region.name: California
timezones: 1 item

// 01 · requête

Phone Validator tient en une requête HTTPS

Envoyez les paramètres avec votre clé et votre secret. Chaque SDK, la CLI et le serveur MCP effectuent ce même appel.

GET/phone-validatorParamètre

phoneobligatoire: The number, ideally in E.164
country_codeUS: Country, when the number has no prefix

GET /phone-validator

curl "https://api.tomba.io/v1/phone-validator?phone=%2B16505550132" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

const res = await fetch("https://api.tomba.io/v1/phone-validator?phone=%2B16505550132", {
  headers: {
    "X-Tomba-Key": process.env.TOMBA_API_KEY,
    "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY
  }
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.tomba.io/v1/phone-validator?phone=%2B16505550132",
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
)
data = res.json()["data"]

// 02 · réponse

Ce qui est renvoyé

Du JSON, identique dans tous les langages. Les champs que Tomba ne connaît pas valent null, jamais une supposition.

GET/phone-validatorChamp

dataobject | array: The number's details; an empty array, with phone repeating your input, when it isn't valid
data.validboolean | null: Whether the number is a valid phone number
data.intl_format, data.e164_format, data.local_formatstring | null: The number in international, E.164 and national formats
data.country_codestring | null: Country of the number (ISO code)
data.line_typestring | null: MOBILE, FIXED_LINE, FIXED_LINE_OR_MOBILE, VOIP, TOLL_FREE…
data.carrierstring | null: The network operator
data.region, data.timezonesobject | null, array | null: Where the number is registered, and its time zones

GET /phone-validator

200 OK· 1 search credit

{
  "data": {
    "valid": true,
    "local_format": "(650) 555-0132",
    "intl_format": "+1 650-555-0132",
    "e164_format": "+16505550132",
    "rfc3966_format": "tel:+1-650-555-0132",
    "country_code": "US",
    "line_type": "MOBILE",
    "carrier": "AT&T",
    "region": {
      "name": "California",
      "code": "CA"
    },
    "timezones": [
      "America/Los_Angeles"
    ]
  }
}

// 03 · coût et limites

Ce que coûte un appel

Un appel n'est facturé que dans la condition ci-dessous. Les limites de débit dépendent de votre offre.

// coût

1search credit

Facturé quand: Every successful response, including one with no data.

Les erreurs, les réponses 429 et 451, ainsi que la même requête répétée dans votre fenêtre d'utilisation ne coûtent rien.

Comment fonctionnent les crédits

// limites de débit

Requêtes par seconde / minute / jour

	Free	Basic	Growth	Pro
Search, finder, similar, technology	1 / 2 / 5	3 / 50 / 500	5 / 80 / 1,000	8 / 150 / 4,000
Email verifier	1 / 2 / 10	2 / 40 / 500	3 / 60 / 1,000	5 / 100 / 4,000

Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. Limites de débit

// faq

Questions sur l'API Validation de Téléphone

D'autres questions ? Consultez le centre d'aide

Votre premier appel en une minute

Compte gratuit, vraie clé API, les mêmes endpoints que ceux qu'utilisent les clients Enterprise.

1Créez un compte gratuit25 recherches par mois. Sans carte bancaire.

2Copiez votre clé et votre secretDepuis Clés API dans le tableau de bord.

3Appelez l'APICollez la requête ; la réponse est en JSON.

const res = await fetch("https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", { headers: { "X-Tomba-Key": process.env.TOMBA_API_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY } }); const { data } = await res.json();

import os, requests res = requests.get( "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", headers={ "X-Tomba-Key": os.environ["TOMBA_API_KEY"], "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"], }, ) data = res.json()["data"]

{ "data": { "email": "richard@piedpiper.com", "first_name": "Richard", "last_name": "Hendricks", "full_name": "Richard Hendricks", "website_url": "piedpiper.com", "company": "Pied Piper", "pattern": "{first}", "department": "executive", "type": "personal", "position": "CEO", "country": "US", "gender": "male", "twitter": null, "linkedin": "https://www.linkedin.com/in/richard-hendricks", "score": 100, "accept_all": false, "phone_number": true, "verification": { "date": "2025-01-15T10:32:00+01:00", "status": "valid" }, "sources": [ { "uri": "https://piedpiper.com/blog/engineering", "website_url": "piedpiper.com", "extracted_on": "2024-06-01T09:14:07+01:00", "last_seen_on": "2025-01-10T17:02:44+01:00", "still_on_page": true } ], "phone_data": [] } }