NAV
cURL Python Node.js Ruby JAVA PHP Rlang Dart CLI

Introduction

We are maintaining a Public API. This service allows any developers to retrieve and manage TOmba data with HTTP requests.

This documentation will show you how to query.

The main calls are available:

API endpoint

https://api.tomba.io/v1/

API endpoint

Authentication

Authentication is made with a key and secret you will have to add to every call you make to our API. This parameter is always required. We'll return an error if the key is either missing or invalid.

Your API key and secret is what identifies your account, so make sure to keep it secret! You can at anytime generate or delete API keys and rest secret on Secret Key.

Api Authorization Location
key X-Tomba-Key header
secret X-Tomba-Secret header

Errors

Tomba API uses the following error codes:

Error Code Meaning
400 Bad Request -- Your request is invalid.
401 Unauthorized -- Your API key is wrong.
402 The Email Verification failed because of an unexpected response from the remote SMTP server. This failure is outside of our control. We advise you to retry later.
403 Forbidden -- The kitten requested is hidden for administrators only.
404 Not Found -- The specified kitten could not be found.
405 Method Not Allowed -- You tried to access a kitten with an invalid method.
406 Not Acceptable -- You requested a format that isn't json.
410 Gone -- The kitten requested has been removed from our servers.
418 I'm a teapot.
429 Too Many Requests -- You're requesting too many kittens! Slow down!
500 Internal Server Error -- We had a problem with our server. Try again later.
503 Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

Rate Limits

If you exceed that limit we'll return a 429 HTTP status code to you.

Paid plans come with higher monthly limits

HTTPS / SSL

Our API is available over a secure HTTPS connection for all users, even on the free plan. Simply add https:// to the request URLs to make the requests secure.

Data

When you use Tomba , you access data from one unique source: the public web. Every day, we analyse millions of websites to index the most up to date business data.

Data at scale

We are the largest professional email database of companies and domains in the world. We have 160+m email from 55 millions domains, all bought together into a standardised global schema.

Direct from source

We only collect data from the official source itself, we do not use third party data providers to access this data, and we provide direct line of sight to the original source.

Libraries

Language Libraries

Official libraries for common programming languages, like PHP, Python etc.

Language Status Link Package Manager
Javascript In progress tomba-io/node
Go In progress tomba-io/go
Java In progress tomba-io/java
Python In progress tomba-io/python
PHP In progress tomba-io/php
Ruby In progress tomba-io/ruby
Perl In progress tomba-io/perl
Dart In progress tomba-io/dart
Rust In progress tomba-io/rlang
R In progress tomba-io/rlang

Framework Libraries

Official libraries for common frameworks. These libraries should use the official lanaguge library as a dependency, so for example the Django library should use the Python library.

In the framework libraries we can assume more about the developer's use case, and we probably have access to more information, such as a HTTP request object. We can therefore implement additional functionality that doesn't make sense in the core language library. This includes bot filtering (not sending requests to our API if the user agent belongs to a "bot").

Account Information

Returns information about the current account.

curl --request GET \
  --url 'https://api.tomba.io/v1/me' \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'  
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");

require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /me

The parameters are defined as follows

Parameter Default Description
key Required Your API key
secret Required Your API secret

Response Objects details

Full Response

{
    "data": {
        "available": 5000,
        "user_id": 1,
        "secret_token": "ts_xxx",
        "role": 2,
        "confirmed": true,
        "blocked": false,
        "first_name": "xxx",
        "last_name": "xxxx",
        "email": "xxx@tomba.io",
        "phone": "+xxxxxxx",
        "image": "https:\/\/www.gravatar.com\/avatar\/xxxxxxxxx?s=128&d=https:\/\/ui-avatars.com\/api\/M+B\/128\/001529\/fff?ssl=1",
        "deleted": false,
        "timezone": "xx\/xx",
        "newletter": false,
        "activity": false,
        "title": "",
        "country": "AU",
        "created_at": "2020-02-18T15:52:10+01:00",
        "ip": "1.0.0.0",
        "payment_status": true,
        "issued": "2020-12-22T15:52:10+01:00",
        "expired": "2021-10-24T00:00:00+01:00",
        "pricing": {
            "name": "Growth",
            "pricing_id": 3,
            "available_searches": 2500,
            "available_verifications": 2500,
            "available_phones": 500,
            "available_leads": 10000,
            "available_list": 150,
            "available_attr": 29,
            "available_keys": 10,
            "available_teams": 5,
            "available_email_count": 10000,
            "frequency": "monthly"
        },
        "time": {
            "date": "2021-01-31 21:23:00.997965",
            "timezone_type": 3,
            "timezone": "xx\/xxxx"
        },
        "used": 1349,
        "requests": {
            "domains": {
                "available": 2500,
                "used": 12
            },
            "verifications": {
                "available": 2500,
                "used": 49
            },
            "phones": {
                "available": 500,
                "used": 17
            }
        }
    }
}

Domain Search

Search emails are based on the website You give one domain name and it returns all the email addresses found on the internet.

curl --request GET \
  --url 'https://api.tomba.io/v1/domain-search/stripe.com' \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /domain-search/:domain

The parameters are defined as follows

Parameter Default Description
domain Required Domain name from which you want to find the email addresses. For example, "stripe.com".
page optional Specifies the number of email addresses to skip. The default is 1.
limit optional Specifies the max number of email addresses to return. The default is 10. valid number(10,20,50)
department optional Get only email addresses for people working in the selected department(s).
type optional Get only personal or generic email addresses.

Response Objects details

Full Response

{
    "data": {
        "organization": {
            "location": {
                "country": "US",
                "city": "San Francisco",
                "state": "California",
                "street_address": null
            },
            "social_links": {
                "twitter_url": "https:\/\/twitter.com\/stripe",
                "facebook_url": "https:\/\/www.facebook.com\/StripeHQ",
                "linkedin_url": "https:\/\/www.linkedin.com\/company\/2135371"
            },
            "disposable": false,
            "webmail": false,
            "website_url": "stripe.com",
            "phone_number": "",
            "industries": "internet",
            "postal_code": "94107",
            "employee_count": 976,
            "last_updated": "2021-01-09T05:51:19+01:00",
            "revenue": "150000",
            "accept_all": false,
            "pattern": "{first}",
            "domain_score": 30,
            "organization": "stripe"
        },
        "emails": [
            {
                "email": "nonprofit@stripe.com",
                "first_name": null,
                "last_name": null,
                "full_name": null,
                "phone_number": null,
                "type": "generic",
                "country": null,
                "position": null,
                "department": null,
                "seniority": null,
                "twitter": null,
                "linkedin": null,
                "accept_all": false,
                "pattern": "{first}",
                "score": 55,
                "verification": {
                    "date": null,
                    "status": null
                },
                "last_updated": "2021-01-22T13:01:41+01:00",
                "sources": [
                    {
                        "uri": "https:\/\/donatetools.com\/pricing",
                        "extracted_on": "2020-12-15 14:35:50",
                        "last_seen_on": "2021-01-22 13:01:41",
                        "still_on_page": true,
                        "website_url": "donatetools.com"
                    },
                    {
                        "uri": "https:\/\/fundrazr.com\/pages\/stripe",
                        "extracted_on": "2020-12-25 09:33:19",
                        "last_seen_on": "2021-01-30 16:21:18",
                        "still_on_page": true,
                        "website_url": "fundrazr.com"
                    },
                    {
                        "uri": "https:\/\/www.wizevents.com\/pricing",
                        "extracted_on": "2020-12-26 07:19:54",
                        "last_seen_on": "2021-01-28 15:43:44",
                        "still_on_page": true,
                        "website_url": "www.wizevents.com"
                    },
                    {
                        "uri": "https:\/\/bloomerang.co\/features\/payment-processing\/",
                        "extracted_on": "2020-12-16 08:14:17",
                        "last_seen_on": "2021-01-29 13:37:40",
                        "still_on_page": true,
                        "website_url": "bloomerang.co"
                    },
                    {
                        "uri": "https:\/\/mancloud.eu\/nl\/hotel-software\/betaaloplossing",
                        "extracted_on": "2021-01-12 14:06:03",
                        "last_seen_on": "2021-02-01 12:48:59",
                        "still_on_page": true,
                        "website_url": "mancloud.eu"
                    },
                    {
                        "uri": "https:\/\/mancloud.eu\/en\/hotel-software\/payment-provider",
                        "extracted_on": "2021-01-12 14:06:14",
                        "last_seen_on": "2021-02-01 12:49:00",
                        "still_on_page": true,
                        "website_url": "mancloud.eu"
                    },
                    {
                        "uri": "https:\/\/donorbox.org\/pricing",
                        "extracted_on": "2020-12-23 13:44:27",
                        "last_seen_on": "2021-02-01 13:15:44",
                        "still_on_page": true,
                        "website_url": "donorbox.org"
                    },
                    {
                        "uri": "https:\/\/rootfunding.com\/blogs\/discounted-stripe-credit-card-processing-fees-for-non-profits",
                        "extracted_on": "2021-01-26 08:55:14",
                        "last_seen_on": "2021-02-01 18:22:06",
                        "still_on_page": true,
                        "website_url": "rootfunding.com"
                    },
                    {
                        "uri": "https:\/\/rootfunding.com\/feed.rss",
                        "extracted_on": "2021-01-26 08:55:15",
                        "last_seen_on": "2021-02-01 18:22:06",
                        "still_on_page": true,
                        "website_url": "rootfunding.com"
                    }
                ]
            },
            {
                "email": "conduct@stripe.com",
                "first_name": "",
                "last_name": "",
                "full_name": null,
                "phone_number": null,
                "type": "personal",
                "country": null,
                "position": null,
                "department": "0",
                "seniority": null,
                "twitter": null,
                "linkedin": null,
                "accept_all": false,
                "pattern": "{first}",
                "score": 50,
                "verification": {
                    "date": null,
                    "status": null
                },
                "last_updated": "2021-04-07T19:50:30+01:00",
                "sources": [
                    {
                        "uri": "https:\/\/xpotoursandtravel.com\/vendor\/stripe\/stripe-php\/CODE_OF_CONDUCT.md",
                        "extracted_on": "2021-03-30 14:57:17",
                        "last_seen_on": "2021-04-07 19:50:30",
                        "still_on_page": true,
                        "website_url": "xpotoursandtravel.com"
                    }
                ]
            },
            {
                "email": "am@stripe.com",
                "first_name": "amy",
                "last_name": "mente",
                "full_name": "Amy Mente",
                "phone_number": null,
                "type": "generic",
                "country": "US",
                "position": "Account Support",
                "department": "marketing",
                "seniority": "junior",
                "twitter": null,
                "linkedin": "https:\/\/www.linkedin.com\/in\/amy-mente-6b0854ba",
                "accept_all": false,
                "pattern": "{first}",
                "score": 90,
                "verification": {
                    "date": null,
                    "status": null
                },
                "last_updated": "2021-03-13T01:43:04+01:00",
                "sources": [
                    {
                        "uri": "https:\/\/chicobetas.com\/alumni-association\/alumni-directory\/",
                        "extracted_on": "2020-12-10 16:39:31",
                        "last_seen_on": "2021-01-22 03:13:01",
                        "still_on_page": true,
                        "website_url": "chicobetas.com"
                    }
                ]
            },
            {
                "email": "notices@stripe.com",
                "first_name": null,
                "last_name": null,
                "full_name": null,
                "phone_number": null,
                "type": "personal",
                "country": null,
                "position": null,
                "department": null,
                "seniority": null,
                "twitter": null,
                "linkedin": null,
                "accept_all": false,
                "pattern": "{first}",
                "score": 50,
                "verification": {
                    "date": null,
                    "status": null
                },
                "last_updated": "2021-01-29T23:42:02+01:00",
                "sources": [
                    {
                        "uri": "https:\/\/www.swiftcomply.com\/privacy-policy\/",
                        "extracted_on": "2021-01-05 04:20:27",
                        "last_seen_on": "2021-01-27 10:04:44",
                        "still_on_page": true,
                        "website_url": "www.swiftcomply.com"
                    }
                ]
            },
            {
                "email": "julia@stripe.com",
                "first_name": "julia",
                "last_name": "evans",
                "full_name": "Julia Evans",
                "phone_number": null,
                "type": "personal",
                "country": "CA",
                "position": "software engineer",
                "department": "software",
                "seniority": "senior",
                "twitter": null,
                "linkedin": "https:\/\/www.linkedin.com\/in\/jvans",
                "accept_all": false,
                "pattern": "{first}",
                "score": 90,
                "verification": {
                    "date": null,
                    "status": null
                },
                "last_updated": "2021-03-13T02:00:47+01:00",
                "sources": [
                    {
                        "uri": "https:\/\/pypi.org\/project\/topmodel\/",
                        "extracted_on": "2021-01-30 07:57:41",
                        "last_seen_on": "2021-02-05 03:12:19",
                        "still_on_page": true,
                        "website_url": "pypi.org"
                    }
                ]
            },
            {
                "email": "dpo@stripe.com",
                "first_name": null,
                "last_name": null,
                "full_name": null,
                "phone_number": null,
                "type": "generic",
                "country": null,
                "position": null,
                "department": null,
                "seniority": null,
                "twitter": null,
                "linkedin": null,
                "accept_all": false,
                "pattern": "{first}",
                "score": 65,
                "verification": {
                    "date": null,
                    "status": null
                },
                "last_updated": "2021-01-12T09:21:07+01:00",
                "sources": [
                    {
                        "uri": "https:\/\/capotinas.com\/politica-de-privacidad\/",
                        "extracted_on": "2021-01-12 09:21:07",
                        "last_seen_on": "2021-01-12 09:21:07",
                        "still_on_page": true,
                        "website_url": "capotinas.com"
                    },
                    {
                        "uri": "https:\/\/consultoriablogger.com\/politica-de-privacidad\/",
                        "extracted_on": "2021-01-14 03:14:51",
                        "last_seen_on": "2021-01-14 03:14:51",
                        "still_on_page": true,
                        "website_url": "consultoriablogger.com"
                    },
                    {
                        "uri": "https:\/\/lorukoru.fi\/pages\/terms-and-conditions",
                        "extracted_on": "2021-01-16 13:49:33",
                        "last_seen_on": "2021-01-16 13:49:33",
                        "still_on_page": true,
                        "website_url": "lorukoru.fi"
                    },
                    {
                        "uri": "https:\/\/leoclub-muenchen-maximilianeum.de\/datenschutz-impressum\/",
                        "extracted_on": "2020-12-05 08:00:11",
                        "last_seen_on": "2021-01-31 04:32:11",
                        "still_on_page": true,
                        "website_url": "leoclub-muenchen-maximilianeum.de"
                    },
                    {
                        "uri": "https:\/\/ochimanikia.com\/politica-de-privacidad\/",
                        "extracted_on": "2020-12-11 02:22:32",
                        "last_seen_on": "2021-01-23 19:24:34",
                        "still_on_page": true,
                        "website_url": "ochimanikia.com"
                    },
                    {
                        "uri": "https:\/\/plusdeprotection.com\/politique-de-confidentialite\/",
                        "extracted_on": "2020-12-06 02:36:03",
                        "last_seen_on": "2021-01-23 19:55:52",
                        "still_on_page": true,
                        "website_url": "plusdeprotection.com"
                    },
                    {
                        "uri": "https:\/\/online-hebamme.com\/datenschutzbestimmungen\/",
                        "extracted_on": "2020-12-10 15:55:57",
                        "last_seen_on": "2021-01-23 20:24:07",
                        "still_on_page": true,
                        "website_url": "online-hebamme.com"
                    },
                    {
                        "uri": "https:\/\/ridelifestyle4home.com\/pages\/conditions-generales-de-vente",
                        "extracted_on": "2020-12-16 21:34:36",
                        "last_seen_on": "2021-01-24 06:35:17",
                        "still_on_page": true,
                        "website_url": "ridelifestyle4home.com"
                    },
                    {
                        "uri": "https:\/\/trouvezmoi.ch\/declaration-de-confidentialite\/",
                        "extracted_on": "2020-12-15 16:18:12",
                        "last_seen_on": "2021-01-24 21:12:22",
                        "still_on_page": true,
                        "website_url": "trouvezmoi.ch"
                    },
                    {
                        "uri": "https:\/\/gaudinfancia.com\/politica-de-privacidad\/",
                        "extracted_on": "2020-12-21 01:02:14",
                        "last_seen_on": "2021-01-25 13:47:29",
                        "still_on_page": true,
                        "website_url": "gaudinfancia.com"
                    },
                    {
                        "uri": "https:\/\/gaudinfancia.com\/ca\/politica-de-privacidad\/",
                        "extracted_on": "2020-12-21 01:03:09",
                        "last_seen_on": "2021-01-25 13:47:30",
                        "still_on_page": true,
                        "website_url": "gaudinfancia.com"
                    },
                    {
                        "uri": "https:\/\/www.rentchester.com\/politica-privacidad\/",
                        "extracted_on": "2020-12-24 18:40:55",
                        "last_seen_on": "2021-01-27 15:26:43",
                        "still_on_page": true,
                        "website_url": "www.rentchester.com"
                    },
                    {
                        "uri": "https:\/\/www.rentchester.com\/politica-de-cookies\/",
                        "extracted_on": "2020-12-24 18:40:57",
                        "last_seen_on": "2021-01-27 15:26:43",
                        "still_on_page": true,
                        "website_url": "www.rentchester.com"
                    },
                    {
                        "uri": "https:\/\/involic.com\/privacy-policy.html",
                        "extracted_on": "2021-01-02 18:23:47",
                        "last_seen_on": "2021-01-28 19:50:39",
                        "still_on_page": true,
                        "website_url": "involic.com"
                    },
                    {
                        "uri": "https:\/\/almarc.de\/datenschutz.htm",
                        "extracted_on": "2020-12-13 02:48:11",
                        "last_seen_on": "2021-01-29 03:53:22",
                        "still_on_page": true,
                        "website_url": "almarc.de"
                    },
                    {
                        "uri": "https:\/\/www.boc-group.com\/en\/privacy-policy\/",
                        "extracted_on": "2020-12-21 15:11:48",
                        "last_seen_on": "2021-01-29 17:18:20",
                        "still_on_page": true,
                        "website_url": "www.boc-group.com"
                    },
                    {
                        "uri": "https:\/\/www.drivelock.com\/data-protection",
                        "extracted_on": "2020-12-13 06:16:37",
                        "last_seen_on": "2021-01-31 14:32:44",
                        "still_on_page": true,
                        "website_url": "www.drivelock.com"
                    },
                    {
                        "uri": "https:\/\/www.drivelock.com\/fr\/protection-des-donnees",
                        "extracted_on": "2020-12-13 06:17:00",
                        "last_seen_on": "2021-01-31 14:32:45",
                        "still_on_page": true,
                        "website_url": "www.drivelock.com"
                    },
                    {
                        "uri": "https:\/\/www.drivelock.de\/datenschutz\/",
                        "extracted_on": "2020-12-13 06:17:15",
                        "last_seen_on": "2021-01-31 14:32:45",
                        "still_on_page": true,
                        "website_url": "www.drivelock.de"
                    },
                    {
                        "uri": "https:\/\/actuanimaux.com\/actuanimaux\/cgu-stripe\/",
                        "extracted_on": "2020-12-13 16:08:48",
                        "last_seen_on": "2021-01-31 19:08:52",
                        "still_on_page": true,
                        "website_url": "actuanimaux.com"
                    }
                ]
            },
            {
                "email": "site@stripe.com",
                "first_name": null,
                "last_name": null,
                "full_name": null,
                "phone_number": null,
                "type": "generic",
                "country": null,
                "position": null,
                "department": null,
                "seniority": null,
                "twitter": null,
                "linkedin": null,
                "accept_all": false,
                "pattern": "{first}",
                "score": 50,
                "verification": {
                    "date": null,
                    "status": null
                },
                "last_updated": "2021-02-26T21:12:52+01:00",
                "sources": [
                    {
                        "uri": "https:\/\/atelim.com\/this-week-is-going-to-be-huge-for-ritual-sacrifices.html?part=17",
                        "extracted_on": "2021-02-17 23:57:41",
                        "last_seen_on": "2021-02-26 21:12:52",
                        "still_on_page": true,
                        "website_url": "atelim.com"
                    }
                ]
            },
            {
                "email": "support@stripe.com",
                "first_name": null,
                "last_name": null,
                "full_name": null,
                "phone_number": null,
                "type": "generic",
                "country": "US",
                "position": null,
                "department": null,
                "seniority": null,
                "twitter": null,
                "linkedin": null,
                "accept_all": false,
                "pattern": "{first}",
                "score": 75,
                "verification": {
                    "date": null,
                    "status": null
                },
                "last_updated": "2021-01-16T00:17:41+01:00",
                "sources": [
                    {
                        "uri": "https:\/\/www.hsi-medical.com\/datenschutz\/",
                        "extracted_on": "2021-01-16 00:17:41",
                        "last_seen_on": "2021-01-16 00:17:41",
                        "still_on_page": true,
                        "website_url": "www.hsi-medical.com"
                    },
                    {
                        "uri": "https:\/\/knucklewalkgym.com\/terms\/",
                        "extracted_on": "2021-01-16 04:16:49",
                        "last_seen_on": "2021-01-16 04:16:49",
                        "still_on_page": true,
                        "website_url": "knucklewalkgym.com"
                    },
                    {
                        "uri": "https:\/\/www.nyccfb.info\/PDF\/NYC-Votes_FAQ.pdf",
                        "extracted_on": "2021-01-19 20:52:05",
                        "last_seen_on": "2021-01-19 20:52:05",
                        "still_on_page": true,
                        "website_url": "www.nyccfb.info"
                    },
                    {
                        "uri": "https:\/\/chitachok.ru\/forums\/288\/",
                        "extracted_on": "2020-12-18 06:27:46",
                        "last_seen_on": "2021-01-22 05:52:27",
                        "still_on_page": true,
                        "website_url": "chitachok.ru"
                    },
                    {
                        "uri": "https:\/\/www.enzocouture.us\/index.php?id_cms=5&controller=cms&id_lang=1",
                        "extracted_on": "2020-12-15 14:58:03",
                        "last_seen_on": "2021-01-22 18:02:55",
                        "still_on_page": true,
                        "website_url": "www.enzocouture.us"
                    },
                    {
                        "uri": "https:\/\/www.listedbeauty.com\/stripe_info",
                        "extracted_on": "2020-12-10 00:26:59",
                        "last_seen_on": "2021-01-23 12:07:37",
                        "still_on_page": true,
                        "website_url": "www.listedbeauty.com"
                    },
                    {
                        "uri": "https:\/\/online-theatre-academy.com\/privacy-policy\/",
                        "extracted_on": "2020-12-11 00:31:35",
                        "last_seen_on": "2021-01-23 20:29:12",
                        "still_on_page": true,
                        "website_url": "online-theatre-academy.com"
                    },
                    {
                        "uri": "https:\/\/online-theatre-academy.com\/ru\/privacy-policy\/",
                        "extracted_on": "2020-12-11 00:35:02",
                        "last_seen_on": "2021-01-23 20:29:12",
                        "still_on_page": true,
                        "website_url": "online-theatre-academy.com"
                    },
                    {
                        "uri": "https:\/\/online-theatre-academy.com\/de\/privacy-policy\/",
                        "extracted_on": "2020-12-11 00:35:25",
                        "last_seen_on": "2021-01-23 20:29:12",
                        "still_on_page": true,
                        "website_url": "online-theatre-academy.com"
                    },
                    {
                        "uri": "https:\/\/www.pregfit.de\/datenschutzerklaerung?utm_source=pregfit&utm_medium=home&utm_campaign=1&utm_content=12",
                        "extracted_on": "2020-12-13 09:28:50",
                        "last_seen_on": "2021-01-24 01:17:57",
                        "still_on_page": true,
                        "website_url": "www.pregfit.de"
                    },
                    {
                        "uri": "https:\/\/www.pregfit.de\/datenschutzerklaerung",
                        "extracted_on": "2020-12-13 09:28:58",
                        "last_seen_on": "2021-01-24 01:17:57",
                        "still_on_page": true,
                        "website_url": "www.pregfit.de"
                    },
                    {
                        "uri": "https:\/\/stripeexperts.com\/index.php?id_cms=12&controller=cms&id_lang=1",
                        "extracted_on": "2020-12-10 21:08:41",
                        "last_seen_on": "2021-01-24 18:15:16",
                        "still_on_page": true,
                        "website_url": "stripeexperts.com"
                    },
                    {
                        "uri": "https:\/\/boutique-rasta.fr\/pages\/conditions-generales-de-ventes",
                        "extracted_on": "2020-12-20 00:12:13",
                        "last_seen_on": "2021-01-24 19:44:37",
                        "still_on_page": true,
                        "website_url": "boutique-rasta.fr"
                    },
                    {
                        "uri": "https:\/\/llarenapagatu.com\/donatius\/",
                        "extracted_on": "2020-12-26 08:52:15",
                        "last_seen_on": "2021-01-26 23:29:05",
                        "still_on_page": true,
                        "website_url": "llarenapagatu.com"
                    },
                    {
                        "uri": "https:\/\/ludwig.guru\/privacy",
                        "extracted_on": "2020-12-25 18:41:45",
                        "last_seen_on": "2021-01-27 00:22:31",
                        "still_on_page": true,
                        "website_url": "ludwig.guru"
                    },
                    {
                        "uri": "http:\/\/shovler.com\/blog\/how-to-become-a-snow-shoveler-on-shovler\/",
                        "extracted_on": "2020-12-23 05:59:51",
                        "last_seen_on": "2021-01-27 02:51:47",
                        "still_on_page": true,
                        "website_url": "shovler.com"
                    },
                    {
                        "uri": "http:\/\/shovler.com\/blog\/page\/4\/",
                        "extracted_on": "2020-12-23 05:59:51",
                        "last_seen_on": "2021-01-27 02:51:47",
                        "still_on_page": true,
                        "website_url": "shovler.com"
                    },
                    {
                        "uri": "http:\/\/shovler.com\/blog\/2016\/11\/",
                        "extracted_on": "2020-12-23 05:59:53",
                        "last_seen_on": "2021-01-27 02:51:47",
                        "still_on_page": true,
                        "website_url": "shovler.com"
                    },
                    {
                        "uri": "https:\/\/gigsmart.com\/terms\/",
                        "extracted_on": "2021-01-02 08:51:21",
                        "last_seen_on": "2021-01-27 13:22:21",
                        "still_on_page": true,
                        "website_url": "gigsmart.com"
                    },
                    {
                        "uri": "https:\/\/zkorean.com\/account\/register",
                        "extracted_on": "2021-01-03 18:38:20",
                        "last_seen_on": "2021-01-27 19:34:49",
                        "still_on_page": true,
                        "website_url": "zkorean.com"
                    }
                ]
            },
            {
                "email": "jsmith@stripe.com",
                "first_name": null,
                "last_name": null,
                "full_name": null,
                "phone_number": null,
                "type": "personal",
                "country": null,
                "position": null,
                "department": null,
                "seniority": null,
                "twitter": null,
                "linkedin": null,
                "accept_all": false,
                "pattern": "{first}",
                "score": 50,
                "verification": {
                    "date": null,
                    "status": null
                },
                "last_updated": "2021-02-02T16:57:52+01:00",
                "sources": [
                    {
                        "uri": "https:\/\/www.lusha.com\/organization\/stripe_26094\/",
                        "extracted_on": "2021-01-31 03:55:22",
                        "last_seen_on": "2021-02-26 16:45:53",
                        "still_on_page": true,
                        "website_url": "www.lusha.com"
                    }
                ]
            },
            {
                "email": "smith@stripe.com",
                "first_name": null,
                "last_name": null,
                "full_name": null,
                "phone_number": null,
                "type": "personal",
                "country": null,
                "position": null,
                "department": null,
                "seniority": null,
                "twitter": null,
                "linkedin": null,
                "accept_all": false,
                "pattern": "{first}",
                "score": 50,
                "verification": {
                    "date": null,
                    "status": null
                },
                "last_updated": "2021-02-02T16:57:52+01:00",
                "sources": [
                    {
                        "uri": "https:\/\/www.lusha.com\/organization\/stripe_26094\/",
                        "extracted_on": "2021-01-31 03:55:22",
                        "last_seen_on": "2021-02-26 16:45:53",
                        "still_on_page": true,
                        "website_url": "www.lusha.com"
                    }
                ]
            }
        ]
    },
    "meta": {
        "total": 1514,
        "pageSize": 10,
        "current": 0,
        "total_pages": 152
    }
}
Attribute Type Description
organization > location.country string The country of company
organization > social_links.twitter_url string The Twitter screen name
organization > social_links.facebook_url string The Facebook screen name
organization > social_links.linkedin_url string The Linkedin screen name
organization > disposable bool is disposable email service
organization > webmail bool is webmail email
organization > website_url string The Domain of company’s website
organization > state string The company state
organization > accept_all bool The SMTP checks
organization > industries string The company industries info
organization > last_updated date The time at which we update this data
organization > organization string The Name of company
organization > pattern string The Name of company
emails array The list of Emails

Email Finder

This API endpoint generates or retrieves the most likely email address from a domain name, a first name and a last name.

curl --request GET \
  --url 'https://api.tomba.io/v1/email-finder/asana.com?first_name=Moskoz&last_name=Dustin' \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /email-finder/:domain

The parameters are defined as follows

Parameter Default Description
domain Required The domain name of the company, used for emails. For example, "asana.com".
full_name Required The person's full name
first_name Required The person's first name. It doesn't need to be in lowercase..
last_name Required The person's last name. It doesn't need to be in lowercase..

Response Objects details

Full Response

{
  "data": {
    "email": "jan.marek@g-in.cz",
    "first_name": "Jan",
    "last_name": "Marek",
    "full_name": "Jan Marek",
    "country": "CZ",
    "position": null,
    "twitter": null,
    "linkedin": "https://www.linkedin.com/in/jan-marek-245b85103",
    "phone_number": null,
    "accept_all": null,
    "website_url": "g-incz",
    "company": "Garp integ.rated",
    "score": 80,
    "verification": {
      "date": null,
      "status": null
    },
    "sources": []
  }
}
Attribute Type Description
email string The email address
type string Get the count of only personal or generic email addresses.
website_url string Company domain
first_name string First name of person (if found)
last_name string Last name of person (if found)
full_name string Full formatted name of person. Sometimes this will be present even if the last_name or first_name aren’t available
country string Two letter country code based on location
accept_all bool is true if the SMTP server accepts all the email addresses. It means you can have have false positives on SMTP checks.
position string The job title of person (if found)
department string The person working in the selected department(s).
twitter string Twitter handle for the person (if found).
linkedin_url string LinkedIn URL for the person (if found).
phone_number bool true if found
company string The company of person (if found)
last_updated string The time at which we update this data

Email Verifier

This API endpoint allows you to verify the deliverability of an email address.

Tomba focuses on B2B. Therefore, webmails are not verified. We'll run every check but won't reach the remote SMTP server.

curl --request GET \
  --url 'https://api.tomba.io/v1/email-verifier/ziad@test.io' \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");

require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /email-verifier/:email

The parameters are defined as follows

Parameter Default Description
email Required The email address you want to verify.

Response Objects details

Full Response

{
    "data": {
        "email": {
            "mx_records": true,
            "smtp_server": null,
            "smtp_check": true,
            "accept_all": null,
            "block": null,
            "email": "b.mohamed@tomba.io",
            "gibberish": false,
            "disposable": false,
            "webmail": false,
            "regex": true,
            "status": "valid",
            "result": "deliverable",
            "score": 82
        },
        "sources": [
            {
                "uri": "https:\/\/github.com\/tomba-io\/generic-emails\/blob\/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9\/src\/lib\/validation\/hash.ts",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true,
                "website_url": "github.com"
            },
            {
                "uri": "https:\/\/github.com\/tomba-io\/generic-emails\/blame\/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9\/src\/lib\/validation\/hash.ts",
                "extracted_on": "2021-02-08T20:09:59+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true,
                "website_url": "github.com"
            }
        ]
    }
}
Attribute Type Description
email string The email address to look up.
first_name string First name of person (if found)
last_name string Last name of person (if found)
country string Two letter country code based on location
mx_records bool is true if we find MX records exist on the domain of the given email address.
smtp_server bool is true if we connect to the SMTP server successfully.
smtp_check bool is true if the email address doesn't bounce.
accept_all bool is true if the SMTP server accepts all the email addresses. It means you can have have false positives on SMTP checks.
block bool is true if the SMTP server prevented us to perform the SMTP check.
score int The deliverability score we give to the email address.
regex bool The email address passes our regular expression.
full_name string The person's full name.
status string returns the status of the email address. It takes 1 out of 6 possible values:valid,invalid,accept_all,webmail,disposable,unknown
result string returns the main status of the verification. It takes 1 out of 3 possible values: deliverable,undeliverable,risky
score int is the deliverability score we give to the email address. For webmail and disposable emails, we provide an arbitrary score of 50.
source array The given email address somewhere on the web

Email Sources

Find email address source somewhere on the web

curl --request GET \
  --url 'https://api.tomba.io/v1/email-sources/b.mohamed@tomba.io' \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ts_xxxx'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");

require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /email-sources/:email

The parameters are defined as follows

Parameter Default Description
email Required The email address you want to find sources.

Response Objects details

Full Response

{
    "email": "b.mohamed@tomba.io",
    "data": [
        {
            "uri": "https:\/\/github.com\/tomba-io\/generic-emails\/blob\/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9\/src\/lib\/validation\/hash.ts",
            "extracted_on": "2021-02-08T20:09:54+01:00",
            "last_seen_on": "2021-02-08T22:43:40+01:00",
            "still_on_page": true,
            "website_url": "github.com"
        },
        {
            "uri": "https:\/\/github.com\/tomba-io\/generic-emails\/blame\/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9\/src\/lib\/validation\/hash.ts",
            "extracted_on": "2021-02-08T20:09:59+01:00",
            "last_seen_on": "2021-02-08T22:43:40+01:00",
            "still_on_page": true,
            "website_url": "github.com"
        }
    ]
}
Attribute Type Description
email string The email address to look up.
source array The given email address somewhere on the web

Leads

List all your leads

Returns a list of leads.

curl --request GET \
  --url 'https://api.tomba.io/v1/leads/' \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /leads/

The parameters are defined as follows

Parameter Default Description
page optional Specifies the number of leads to skip. The default is 1.
list optional lead list ID default is null
limit optional Specifies the max number of email addresses to return. The default is 10.
sortby optional Filter lead by email,first_name,last_name,country,website_url...
direction optional Filter lead by desc,asc

Response Objects details

Attribute Type Description
id int Lead ID
email string The email address
first_name string First name of lead
last_name string Last name of lead
country string Two letter country code based on location
website_url string Company domain
position string The job title of lead
twitter string Twitter handle for the lead
linkedin string LinkedIn URL for the lead
phone_number string The phone number of lead
company string The company of lead
lead_source string The lead source default is null or one of the following values: domain, finder, verify, browser.
sync_status string The lead synchronization status default is null or one of the following values: success, pending, error.
sync object sync CRM integrations status
leads_list object List info
attributes object attributes value

Full Response

{
  "data": {
    "leads": [
      {
        "id": 84,
        "user_id": 1,
        "email": "xxx@mozilla.com",
        "first_name": "ed",
        "last_name": "lim",
        "country": "US",
        "website_url": "mozilla.com",
        "position": "senior system administrator",
        "twitter": null,
        "linkedin": "https:\/\/www.linkedin.com\/in\/edwardlim",
        "phone_number": null,
        "company": "Mozilla Toronto",
        "notes": "Notes",
        "score": 95,
        "lead_source": "domain",
        "sync_status": null,
        "sync": {
          "sync_airtable": null,
          "sync_hubspot": null,
          "sync_mailchimp": null,
          "sync_pipedrive": null
        },
        "leads_list": {
          "list_id": 10,
          "name": "test2"
        },
        "attributes": [],
        "created_at": "2021-02-02T23:04:43+01:00",
        "updated_at": "2021-02-09T23:57:41+01:00"
      },
      {
        "id": 83,
        "user_id": 1,
        "email": "xxxx@mozilla.com",
        "first_name": "nick",
        "last_name": "nguyen",
        "country": "US",
        "website_url": "mozilla.com",
        "position": "vp firefox product",
        "twitter": null,
        "linkedin": "https:\/\/www.linkedin.com\/in\/osunick",
        "phone_number": null,
        "company": "Mozilla Toronto",
        "notes": null,
        "score": 95,
        "lead_source": "domain",
        "sync_status": null,
        "sync": {
          "sync_airtable": null,
          "sync_hubspot": null,
          "sync_mailchimp": null,
          "sync_pipedrive": null
        },
        "leads_list": {
          "list_id": 10,
          "name": "test2"
        },
        "attributes": [],
        "created_at": "2021-02-02T23:04:43+01:00",
        "updated_at": "2021-02-09T23:57:41+01:00"
      }
    ],
    "meta": {
      "total": 2,
      "pageSize": 50,
      "current": 1,
      "total_pages": 1
    }
  }
}

Get a lead

Returns a lead.

curl --request GET \
  --url 'https://api.tomba.io/v1/leads/2' \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx' \
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /leads/:id

The parameters are defined as follows

Parameter Default Description
id Required lead ID .

Response Objects details

Attribute Type Description
id int Lead ID
email string The email address
first_name string First name of lead
last_name string Last name of lead
country string Two letter country code based on location
website_url string Company domain
position string The job title of lead
twitter string Twitter handle for the lead
linkedin string LinkedIn URL for the lead
phone_number string The phone number of lead
company string The company of lead
lead_source string The lead source default is null or one of the following values: domain, finder, verify, browser.
sync_status string The lead synchronization status default is null or one of the following values: success, pending, error.
sync object sync CRM integrations status
leads_list object List info
attributes object attributes value

Full Response

{
  "data": {
    "leads": [
      {
        "leads_list": {
          "list_id": 1,
          "name": "Lazaro Reichert"
        },
        "email": "test@rg.fr",
        "first_name": "Moskovitzs",
        "last_name": "Dustinx",
        "country": null,
        "website_url": "asana.com",
        "position": "CEO",
        "twitter": "moskov",
        "linkedin": "dmoskov",
        "phone_number": "",
        "company": "Asana",
        "notes": null,
        "lead_source": "1",
        "created_at": "2020-06-02 19:16:20",
        "updated_at": "0000-00-00 00:00:00",
        "id": 2
      }
    ]
  }
}

Create a lead

Create a new lead . If the email already exists, fails with 422 status code.

curl --request POST \
  --url 'https://api.tomba.io/v1/leads' \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx' \
  --data '{
    "list_id": 22,
    "email": "Grover12@hotmail.com",
    "first_name": "Jefferey Hoppe",
    "last_name": "Romaguera",
    "position": "Customer Data Executive",
    "company": "Branding",
    "score": 95,
    "website_url": "asana.com",
    "phone_number": "506-993-3955",
    "twitter": "moskov",
    "country": "UA",
    "linkedin": "ASD",
    "notes": "ASDDDDDDDDDDDD"
}'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

POST /leads

The parameters are defined as follows

Parameter Default Description
email Required The email address
list optional List ID
first_name optional First name of lead
last_name optional Last name of lead
country optional Two letter country code based on location
website_url optional Company domain
position optional The job title of lead
twitter optional Twitter handle for the lead
linkedin optional LinkedIn URL for the lead
phone_number optional The phone number of lead
company optional The company of lead
attributes optional attributes value

Response Objects details

Attribute Type Description
data -> id int Lead ID

Full Response

{
  "data": {
    "id": 117
  }
}

Update a lead

Update the fields of a lead using id.

curl --request PUT \
  --url 'https://api.tomba.io/v1/leads/278' \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --data '{
    "email": "mohamed@xasdasd.io",
    "first_name": "Mohamed",
    "last_name": "Mohamed",
    "country": null,
    "website_url": "google.com",
    "position": "CEO",
    "twitter": "moskov",
    "linkedin_url": "dmoskov",
    "phone_number": "",
    "company": "Asana",
    "attributes" :{
        "updatesdsad" : "mo",
        "wee" : "mo",
        "s": "6"

    }
}'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

PUT /leads/:id

The parameters are defined as follows

Parameter Default Description
id Required list ID .
email optional The email address
list optional List ID
first_name optional First name of lead
last_name optional Last name of lead
country optional Two letter country code based on location
website_url optional Company domain
position optional The job title of lead
twitter optional Twitter handle for the lead
linkedin optional LinkedIn URL for the lead
phone_number optional The phone number of lead
company optional The company of lead
attributes optional attributes value

Response Objects details

Attribute Type Description
status bool true if updated
message string note message

Full Response

{
  "status": true,
  "message": "The lead has been updated successfully."
}

Delete a lead

Delete a specific lead by passing id.

curl --request DELETE \
  --url 'https://api.tomba.io/v1/leads/275' \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

DELETE //v1/leads/:id

The parameters are defined as follows

Parameter Default Description
id Required list ID .

Response Objects details

Attribute Type Description
status bool true if deleted
message string note message

Full Response

{
  "status": true,
  "message": "The lead has been delete successfully."
}

Lead Attributes

List all your lead attributes

Returns a list of Lead Attributes.

curl --request GET \
  --url https://api.tomba.io/v1/leads/attributes \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /leads/attributes/

The parameters are defined as follows

Response Objects details

Attribute Type Description
attributes -> id int attribute ID
attributes -> name string Name of the custom attribute
attributes -> identifier string identifier of attribute read only It can't be edited
attributes -> type string type attributes string, date, number only.
attributes -> date_created string The date of creation
attributes -> date_modified string the date when the attr was updated

Full Response

{
  "data": {
    "attributes": [
      {
        "id": 48,
        "name": "ALLO",
        "identifier": "allo",
        "type": "string",
        "date_created": "2020-12-11T08:18:37+01:00",
        "date_modified": "2020-12-13T08:47:22+01:00"
      },
      {
        "id": 47,
        "name": "ASD ASD",
        "identifier": "asd_asd",
        "type": "date",
        "date_created": "2020-12-11T08:16:22+01:00",
        "date_modified": "2020-12-11T08:16:22+01:00"
      },
      {
        "id": 46,
        "name": "AS ASD",
        "identifier": "as-asd",
        "type": "number",
        "date_created": "2020-12-11T08:15:47+01:00",
        "date_modified": "2020-12-11T08:15:47+01:00"
      },
      {
        "id": 6,
        "name": "s",
        "identifier": "s",
        "type": "number",
        "date_created": "2020-12-09T03:35:41+01:00",
        "date_modified": "2020-12-09T03:35:55+01:00"
      },
      {
        "id": 5,
        "name": "swe",
        "identifier": "swe",
        "type": "date",
        "date_created": "2020-12-09T03:35:15+01:00",
        "date_modified": "2020-12-09T03:35:15+01:00"
      },
      {
        "id": 4,
        "name": "wee",
        "identifier": "wee",
        "type": "string",
        "date_created": "2020-12-09T03:34:24+01:00",
        "date_modified": "2020-12-09T03:34:24+01:00"
      },
      {
        "id": 3,
        "name": "xxx",
        "identifier": "xxx",
        "type": "string",
        "date_created": "2020-12-09T03:03:17+01:00",
        "date_modified": "2020-12-09T03:33:18+01:00"
      },
      {
        "id": 2,
        "name": "updatesdsad",
        "identifier": "updatesdsad",
        "type": "string",
        "date_created": "2020-12-09T03:02:55+01:00",
        "date_modified": "2020-12-12T09:20:19+01:00"
      },
      {
        "id": 1,
        "name": "ssssss",
        "identifier": "ssssss",
        "type": "date",
        "date_created": "2020-12-07T05:37:53+01:00",
        "date_modified": "2020-12-09T03:33:31+01:00"
      }
    ],
    "meta": {
      "total": 9,
      "pageSize": 50,
      "current": 1,
      "total_pages": 1
    }
  }
}

Get a attributes

Returns a Lead Attributes.

curl --request GET \
  --url 'https://api.tomba.io/v1/leads/attributes/38' \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /leads/attributes/:id

The parameters are defined as follows

Parameter Default Description
id Required attribute ID .

Response Objects details

Attribute Type Description
attributes -> id int attribute ID
attributes -> name string Name of the custom attribute
attributes -> identifier string identifier of attribute read only It can't be edited
attributes -> type string type attributes string, date, number only.
attributes -> date_created string The date of creation
attributes -> date_modified string the date when the attr was updated

Full Response

{
  "data": {
    "attributes": [
      {
        "id": 38,
        "name": "salary",
        "type": "number",
        "date_created": "2020-12-07T05:37:53+01:00",
        "date_modified": "2020-12-07T05:37:53+01:00"
      }
    ]
  }
}

Create a Lead Attributes

Create a new Attributes with the name and type request parameter. If the Attributes name already exists, fails with 422 status code.

curl --request POST \
  --url 'https://api.tomba.io/v1/leads/attributes' \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --data '{"name": "Millie","type": "date"}'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

POST /leads/attributes

The parameters are defined as follows

Parameter Default Description
name Required Name of the custom attribute
type Required type attributes string, date, number only.

Response Objects details

Attribute Type Description
data -> id int attribute ID

Full Response

{
  "data": {
    "id": 51
  }
}

Update a Lead Attributes

Update the fields of a Attributes using id.

curl --request PUT \
  --url 'https://api.tomba.io/v1/leads/attributes/41' \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --data '{"name": "total ","type": "string"}'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

PUT /leads/attributes/:id

The parameters are defined as follows

Parameter Default Description
id Required attribute ID .
name Required Name of the custom attribute
type Required type attributes string, date, number only.

Response Objects details

Attribute Type Description
status bool true if updated
message string note message

Full Response

{
  "status": true,
  "message": "The leads lists info has been updated successfully."
}

Delete a Lead Attributes

Delete a specific Attributes by passing id.

curl --request DELETE \
  --url 'https://api.tomba.io/v1/leads/attributes' \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

DELETE /leads/attributes/:id

The parameters are defined as follows

Parameter Default Description
id Required attribute ID .

Response Objects details

Attribute Type Description
status bool true if deleted
message string note message

Full Response

{
  "status": true,
  "message": "The attributes has been delete successfully."
}

Leads Lists

List all your leads lists

Returns a list of leads lists.

curl --request GET \
  --url 'https://api.tomba.io/v1/leads_lists/' \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /leads_lists

Response Objects details

Attribute Type Description
list_leads -> id int List ID
list_leads -> name string Name of the List
list_leads -> favorite bool is the List favorite true or false
list_leads -> type string The type is campaigns by default ,Soon we will add more Type
list_leads -> size int Total lead on this list
list_leads -> created_at string The date of creation
list_leads -> updated_at string the date when the list was updated

Full Response

{
  "data": {
    "list_leads": [
      {
        "id": 2,
        "name": "html",
        "favorite": false,
        "type": "campaigns",
        "size": 105,
        "created_at": "2020-12-13T07:59:36+01:00",
        "updated_at": "2020-12-13T07:59:36+01:00"
      },
      {
        "id": 3,
        "name": "tgevrt",
        "favorite": false,
        "type": "campaigns",
        "size": 34,
        "created_at": "2020-12-13T08:01:45+01:00",
        "updated_at": "2020-12-13T08:01:45+01:00"
      },
      {
        "id": 436,
        "name": "ce",
        "favorite": false,
        "type": "campaigns",
        "size": 4,
        "created_at": "2020-12-14T10:36:56+01:00",
        "updated_at": "2020-12-14T10:36:56+01:00"
      },
      {
        "id": 462,
        "name": "we",
        "favorite": false,
        "type": "campaigns",
        "size": 0,
        "created_at": "2020-12-14T10:29:17+01:00",
        "updated_at": "2020-12-14T10:29:17+01:00"
      }
    ]
  }
}

Get a leads list

Returns a leads list.

curl --request GET \
  --url 'https://api.tomba.io/v1/leads_lists/1' \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx' \
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /leads_lists/:id

The parameters are defined as follows

Parameter Default Description
id Required attribute ID .

Response Objects details

Attribute Type Description
list_leads -> id int List ID
list_leads -> name string Name of the List
list_leads -> favorite bool is the List favorite true or false
list_leads -> type string The type is campaigns by default ,Soon we will add more Type
list_leads -> size int Total lead on this list
list_leads -> created_at string The date of creation
list_leads -> updated_at string the date when the list was updated

Full Response

{
  "data": [
    {
      "id": 1,
      "name": "html",
      "favorite": false,
      "type": "campaigns",
      "size": 109,
      "created_at": "2020-12-13T07:59:36+01:00",
      "updated_at": "2020-12-21T12:46:35+01:00"
    }
  ]
}

Create a leads list

Create a new leads list with the name request parameter. If the list name already exists, fails with 422 status code.

curl --request POST \
  --url 'https://api.tomba.io/v1/leads_lists/' \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx' \
  --data '{
  "name": "Mario Monahan"
  }'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

POST /leads_lists

The parameters are defined as follows

Parameter Default Description
name Required Name of the list

Response Objects details

Attribute Type Description
data -> list_id int List ID
data -> name string list name

Full Response

{
  "data": {
    "list_id": 22,
    "name": "Nya Dicki"
  }
}

Update a leads list

Update the fields of a list using id.

curl --request PUT \
  --url 'https://api.tomba.io/v1/leads_lists/17' \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx' \
  --data '{
  "name": "update listsssssssssss"
  }'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

PUT /leads_lists/:id

The parameters are defined as follows

Parameter Default Description
id Required list ID .
name Required new name for the list

Response Objects details

Attribute Type Description
status bool true if updated
message string note message

Full Response

{
  "status": true,
  "message": "The leads list info has been updated successfully."
}

Delete a leads list

Delete a specific list by passing id.

curl --request DELETE \
  --url 'https://api.tomba.io/v1/leads_lists/5' \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx' \
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

DELETE /leads_lists/:id

The parameters are defined as follows

Parameter Default Description
id Required list ID .

Response Objects details

Attribute Type Description
status bool true if deleted
message string note message

Full Response

{
  "status": true,
  "message": "The leads list info has been delete successfully."
}

keys

List all your keys

Returns a list of your keys.

curl --request GET \
  --url https://api.tomba.io/v1/keys \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx'

<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /keys/

Response Objects details

Attribute Type Description
keys ->id string the key ID
keys ->key string your hash key always start with ta_
keys ->ip_addresses string IP address
keys ->creation_date string the date of creation of this key

Full Response

{
  "data": {
    "keys": [
      {
        "id": 432,
        "key": "ta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "ip_addresses": "127.0.0.1",
        "creation_date": "2021-01-13T01:00:41+01:00"
      },
      ...
      ...
      ...
      ...
    ]
  }
}

Get a key

Returns a key.

curl --request GET \
  --url 'https://api.tomba.io/v1/keys/241' \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx'

<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /keys/:id

The parameters are defined as follows

Parameter Default Description
id Required Key ID.

Response Objects details

Attribute Type Description
keys ->id string the key ID
keys ->key string your hash key
keys ->ip_addresses string IP address
keys ->creation_date string the date of creation of this key

Full Response

{
  "data": {
    "keys": [
      {
        "id": 241,
        "key": "ta_xxxxxxxxxxxxxxxxx",
        "ip_addresses": "1.0.0.1",
        "creation_date": "2021-01-13T00:45:05+01:00"
      }
    ]
  }
}

Create a key

curl --request POST \
  --url 'https://api.tomba.io/v1/keys' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx'

<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

POST /keys

Response Objects details

Attribute Type Description
id string the key ID
key string your hash key

Full Response

{
  "data": {
    "id": 399,
    "key": "ta_xxxxxx"
  }
}

Rest a key

curl --request PUT \
  --url 'https://api.tomba.io/v1/keys/2' \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx'

<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

PUT /keys/:id

The parameters are defined as follows

Parameter Default Description
id Required Key ID.

Response Objects details

Attribute Type
status bool
message string

Full Response

{
  "status": true,
  "message": "The keys has been Rest."
}

Delete a key

curl --request DELETE \
  --url 'https://api.tomba.io/v1/keys/259' \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

DELETE /keys/:id

The parameters are defined as follows

Parameter Default Description
id Required Key ID.

Response Objects details

Attribute Type
status bool
message string

Full Response

{
  "status": true,
  "message": "The keys has been delete successfully."
}

Usage

Returns a your monthly requests

curl --request GET \
  --url https://api.tomba.io/v1/usage \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");

require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /usage/

Response Objects details

Attribute Type Description
data ->usage int total usage on date
data ->created_at int usage date
data ->name int total usage on the name

Full Response

{
  "data": [
       {
      "usage": 2,
      "created_at": "2021-01-17",
      "domain": 0,
      "finder": 0,
      "verifier": 2,
      "technologies": 0,
      "ip": 0,
      "website": 0,
      "bulk": 0,
      "extension": 0,
      "api": 0,
      "mobile": 0,
      "desktop": 0,
      "sheets": 0
    },
    {
      "usage": 0,
      "created_at": "2021-01-19",
      "domain": 0,
      "finder": 0,
      "verifier": 0,
      "technologies": 0,
      "ip": 0,
      "website": 0,
      "bulk": 0,
      "extension": 0,
      "api": 0,
      "mobile": 0,
      "desktop": 0,
      "sheets": 0
    },
   ...
   ...
   ...
   ...
  ],
  "total": {
    "usage": 227,
    "domain": 0,
    "finder": 158,
    "verifier": 35,
    "socail": 0,
    "technologies": 0,
    "website": 0,
    "bulk": 0,
    "extension": 0,
    "api": 0,
    "mobile": 0,
    "desktop": 0,
    "sheets": 0
  }
}

Logs

Returns a your last 1,000 requests you made during the last 3 months.

curl --request GET \
  --url https://api.tomba.io/v1/logs \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx'
<?php
use tomba\Tomba;

import tomba

const Tomba = require("tomba");
require 'tomba'

import io.tomba.api.Tomba;

require(tomba)

import 'package:tomba/tomba.dart';


HTTP Request

GET /logs/

Response Objects details

Attribute Type Description
data -> uri string The url associated with the Request
data -> user_agent string The User Agent associated with the Request
data -> cost bool The cost false Free true 1 request
data -> ip_address string The IP address associated with the Request
data -> created_at string The date of creation
data -> country string The ISO 3166-1 alpha-2 country code

Full Response

{
  "data": [
    {
      "type": "Email Finder",
      "uri": "https:\/\/api.tomba\/v1\/email-finder\/asdasd.fr",
      "cost": false,
      "ip_address": "1.0.0.0",
      "created_at": "2020-10-14T13:26:58+11:00",
      "id": 1809,
      "user_agent": "Mozilla\/5.0 (X11; Linux x86_64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/85.0.4183.121 Safari\/537.36",
      "source": "Website",
      "http_method": "GET",
      "country" : "TN"
    },
    {
      "type": "Social Search",
      "uri": "https:\/\/api.tomba\/v1\/social\/sadasd",
      "cost": false,
      "ip_address": "1.0.0.0",
      "created_at": "2020-10-14T13:26:35+11:00",
      "id": 1799,
      "user_agent": "Mozilla\/5.0 (X11; Linux x86_64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/85.0.4183.121 Safari\/537.36",
      "source": "Website",
      "http_method": "GET",
      "country" : "TN"
    },
    {
      "type": "Email Finder",
      "uri": "https:\/\/api.tomba\/v1\/email-finder\/alacra.com",
      "cost": false,
      "ip_address": "1.0.0.0",
      "created_at": "2020-10-14T00:22:13+11:00",
      "id": 1724,
      "user_agent": "Mozilla\/5.0 (X11; Linux x86_64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/85.0.4183.121 Safari\/537.36",
      "source": "Website",
      "http_method": "GET",
      "country" : "TN"
    },
    {
      "type": "Email Finder",
      "uri": "https:\/\/api.tomba\/v1\/email-finder\/alacra.com",
      "cost": false,
      "ip_address": "1.0.0.0",
      "created_at": "2020-10-14T00:22:01+11:00",
      "id": 1723,
      "user_agent": "Mozilla\/5.0 (X11; Linux x86_64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/85.0.4183.121 Safari\/537.36",
      "source": "Website",
      "http_method": "GET",
      "country" : "TN"
    },
    {
      "type": "Email Verification",
      "uri": "https:\/\/api.tomba\/v1\/email-verifier\/sdsad@asdsad.fr",
      "cost": true,
      "ip_address": "1.0.0.0",
      "created_at": "2020-10-12T22:07:03+11:00",
      "id": 1633,
      "user_agent": "Mozilla\/5.0 (X11; Linux x86_64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/85.0.4183.121 Safari\/537.36",
      "source": "Website",
      "http_method": "GET",
       "country" : "TN"
    },
    {
      "type": "Geolocation API",
      "uri": "https:\/\/api.tomba\/v1\/ip\/1.0.0.0",
      "cost": false,
      "ip_address": "1.0.0.0",
      "created_at": "2020-10-12T14:44:57+11:00",
      "id": 1290,
      "user_agent": "tomba api",
      "source": "API",
      "http_method": "GET",
       "country" : "TN"
    },
    {
      "type": "Email Verification",
      "uri": "https:\/\/api.tomba\/v1\/email-verifier\/asdasd@asdasd.fr",
      "cost": false,
      "ip_address": "1.0.0.0",
      "created_at": "2020-10-11T00:06:57+11:00",
      "id": 767,
      "user_agent": "Mozilla\/5.0 (X11; Linux x86_64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/85.0.4183.121 Safari\/537.36",
      "source": "Website",
      "http_method": "GET",
       "country" : "TN"
    },
    ...
    ...
    ...
    ...
    ...
    ...
  ]
}

Email Count

Returns total email addresses we have for one domain.

curl --request GET \
  --url 'https://api.tomba.io/v1/email-count?domain=google.com' \
  --header 'content-type: application/json' \
  --header 'X-Tomba-Key: xxxxxxxxxxxxx'

HTTP Request

GET /email-count/?domain=:domain

The parameters are defined as follows

Parameter Default Description
domain Required Domain name from which you want to find the email addresses. For example, "stripe.com".

Response Objects details

Attribute Type Description
total int Total email
personal_emails int Total personal email
generic_emails int Total generic email
department > _key_name_ int Total email on department _key_name_
seniority > _key_name_ int Total email on seniority _key_name_

Full Response

{
  "data": {
    "total": 129283,
    "personal_emails": 129283,
    "generic_emails": 295,
    "department": {
      "engineering": 871,
      "finance": 692,
      "hr": 505,
      "it": 1040,
      "marketing": 4996,
      "operations": 2369,
      "management": 4208,
      "sales": 1455,
      "legal": 208,
      "support": 1414,
      "communication": 226
    },
    "seniority": {
      "junior": 3265,
      "senior": 20948,
      "executive": 4712
    }
  }
}

Domain status

Returns domain status if is webmail or disposable.

It's free and doesn't require authentication.

curl --request GET \
  --url 'https://api.tomba.io/v1/domain-status?domain=gmail.com' \
  --header 'content-type: application/json' \

HTTP Request

GET /domain-status/?domain=:domain

The parameters are defined as follows

Parameter Default Description
domain Required Domain name from which you want to check. For example, "gmail.com".
email Required Email address from which you want to check. For example, "me@gmail.com".

Response Objects details

Full Response

{
  "domain": "gmail.com",
  "webmail": true,
  "disposable": false
}
Attribute Type Description
webmail int is webmail email service
disposable int is disposable email service

Autocomplete

Company Autocomplete is an API that lets you auto-complete company names and retreive logo and domain information.

curl --request GET \
  --url 'https://api.tomba.io/v1/domains-suggestion?query=googl' \
  --header 'Content-Type: application/json' \

HTTP Request

GET /domains-suggestion?query=:query

The parameters are defined as follows

Parameter Default Description
query Required name of the company or website.

Response Objects details

Attribute Type Description
data -> email_count int Total email on company
data -> website_url string Domain website
data -> name string Domain name of company
data -> logo string URL to logo

Full Response

{
  "data": [
    {
      "website_url": "google.com",
      "name": "Google",
      "email_count": 336,
      "logo": "https:\/\/www.google.com\/s2\/favicons?sz=24&domain=google.com"
    },
    {
      "website_url": "txt.voice.google.com",
      "name": "Txt",
      "email_count": 2,
      "logo": "https:\/\/www.google.com\/s2\/favicons?sz=24&domain=txt.voice.google.com"
    },
    {
      "website_url": "googlegroups.com",
      "name": "Googlegroups",
      "email_count": 5,
      "logo": "https:\/\/www.google.com\/s2\/favicons?sz=24&domain=googlegroups.com"
    },
    {
      "website_url": "ooglesngoogles.com",
      "name": "Ooglesngoogles",
      "email_count": 1,
      "logo": "https:\/\/www.google.com\/s2\/favicons?sz=24&domain=ooglesngoogles.com"
    },
    {
      "website_url": "googlemail.con",
      "name": "Googlemail",
      "email_count": 2,
      "logo": "https:\/\/www.google.com\/s2\/favicons?sz=24&domain=googlemail.con"
    }
  ],
  "meta": {
    "limit": null,
    "query": "googl"
  }
}