Direct naar de inhoud

// bulkbewerkingen

Bulk Telefoonvalidatie

Upload een CSV met telefoonnummers en valideer ze allemaal op formaat en afleverbaarheid tegelijk.

Phone numbers, with an optional countryTot 10,000 rijen per taakCSV, lijst of rijen
phone-validator-list.csv2,500 rijen · phone numbers, with an optional countrycompleted
Bulk Phone Validator · /bulk/phone-validator2,500 / 2,500
  1. 01pendingPOST /v1/bulk/phone-validator201 · { "data": { "id": 1042 } }
  2. 02runninglaunch: truevoortgang opgevraagd met GET /v1/bulk/phone-validator/1042/progress
  3. 03completedbulk.completedondertekende webhook afgeleverd op je webhook_url
GET /v1/bulk/phone-validator/1042/download?file=fullIn rekening gebracht bij de eerste download · de taak verloopt na 180 dagen

// 01 · invoer

De invoer van een Phone Validator-bulktaak

Upload in de app een CSV van maximaal 4 MB, of stuur een lijst, rijen of een bestand naar POST /v1/bulk/phone-validator. Kolommen worden herkend aan de kopregel; stel een veldindex in om er zelf een te kiezen.

POST/bulk/phone-validatorKolommen
phone_field_index, country_field_index
Phone number, country

// 02 · api

Eén verzoek start de taak

Maak en start de taak in één aanroep, volg daarna de voortgang of ontvang een ondertekend bulk.completed-event. Elke resultaatrij is wat GET /phone-validator teruggeeft.

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"}'
POST /bulk/phone-validator
201 Created
{
  "data": {
    "id": 1042
  }
}
Elke rij, zoals GET /phone-validator die teruggeeft
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 · kosten en limieten

Wat een taak kost

Een taak aanmaken of starten kost niets. De kosten worden één keer in rekening gebracht, bij de eerste download van de resultaten.

// facturering per rij

1 search credit per valid number.

Bulkfacturering in de documentatie
  • Rijen: tot 10,000 per taak
  • 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)

// klanten

Teams die Phone Validator-taken uitvoeren

  • Tomba is my go-to to validate emails. Even in a waterfall process with multiple tools, Tomba is usually the top choice.
    Nuno PoçoSales Automation Architect, clickworks.io
  • The data is always fresh, and the n8n integration is excellent. Support is very responsive. I'd rate it 9/10.
    Benjie MalinaoCo-Founder & CTO, Channel Automation

// faq

Veelgestelde Vragen

Nog vragen? Bezoek het helpcentrum

// snelstart

Doe je eerste aanroep binnen een minuut

Gratis account, echte API-sleutel, dezelfde endpoints die Enterprise-klanten gebruiken.

  1. 1Maak een gratis account aan25 zoekopdrachten per maand. Geen creditcard.
  2. 2Kopieer je sleutel en secretOnder API-sleutels in het dashboard.
  3. 3Roep de API aanPlak het verzoek; het antwoord is JSON.
curl "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"
Antwoord
200 OK· 1 search credit
{
  "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": []
  }
}