Aller au contenu

// post /v1/bulk/phone-validator

API de validation de téléphone en masse

Validez et normalisez des ensembles de données téléphoniques volumineux dans une opération API asynchrone conçue pour évoluer.

Phone numbers, with an optional countryJusqu'à 10,000 lignes
curl -X POST "https://api.tomba.io/v1/bulk/phone-validator" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Phone Validator job","list":"+16505550132","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

// 01 · requête

Phone Validator en masse 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.

type
phone-validator
list | data | file
Phone numbers, with an optional country
launch
true lance la tâche immédiatement
webhook_url
Reçoit un événement signé à la fin de la tâche
rows
Jusqu'à 10,000 par tâche
curl -X POST "https://api.tomba.io/v1/bulk/phone-validator" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Phone Validator job","list":"+16505550132","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

// 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-validator
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
POST /bulk/phone-validator
201 Created
{
  "data": {
    "id": 1042
  }
}
Chaque ligne, telle que GET /phone-validator la renvoie
200 OK
{
  "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

1 search credit per valid number.

Charged once, at the first download; later downloads are free

  • Jobs created: 15 per day for each type
  • Running jobs: 2 per type
  • Downloads: 25 per day for each job
  • Request size: 4 MB (CSV, list or rows)

// faq

Foire aux questions

D'autres questions ? Consultez le centre d'aide

// commencer gratuitement

Découvrez qui Tomba trouve dans n'importe quelle entreprise

Saisissez le domaine d'une entreprise pour voir ses collaborateurs, leurs fonctions et leurs emails professionnels vérifiés, chacun avec les pages où il a été trouvé. Compte gratuit, sans carte.