Tomba

Enrichment

Endpointhttps://api.tomba.io/v1

Company API

GET

https://api.tomba.io/v1

/companies/find

Our Company API lets you lookup company data via a domain

Company API › query Parameters

domain

string · required

The domain name for which you to find associated information.

Company API › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Company API › Responses

Company object to be returned

id

string

name

string

legalName

string

domain

string

domainAliases

string[]

object

tags

string[]

description

string

foundedYear

number

location

string

timeZone

string

utcOffset

number

object

logo

string

object

emailProvider

boolean

type

string

ticker

object

phone

object

indexedAt

string

tech

string[]

techCategories

string[]

object

GET/companies/find

curl --request GET \
  --url 'https://api.tomba.io/v1/companies/find?domain=tomba.io' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "id": "id",
  "name": "name",
  "legalName": "legalName",
  "domain": "domain",
  "domainAliases": [
    "string"
  ],
  "site": {
    "phoneNumbers": [
      "string"
    ],
    "emailAddresses": [
      "string"
    ]
  },
  "category": {
    "sector": "sector",
    "industryGroup": "industryGroup",
    "industry": "industry",
    "subIndustry": "subIndustry",
    "sicCode": "sicCode",
    "sic4Codes": [
      "string"
    ],
    "naicsCode": "naicsCode",
    "naics6Codes": [
      "string"
    ]
  },
  "tags": [
    "string"
  ],
  "description": "description",
  "foundedYear": 0,
  "location": "location",
  "timeZone": "timeZone",
  "utcOffset": 0,
  "geo": {
    "streetNumber": "streetNumber",
    "streetName": "streetName",
    "subPremise": {},
    "streetAddress": "streetAddress",
    "city": "city",
    "postalCode": "postalCode",
    "state": "state",
    "stateCode": "stateCode",
    "country": "country",
    "countryCode": "countryCode",
    "lat": 0,
    "lng": 0
  },
  "logo": "logo",
  "facebook": {
    "handle": "handle",
    "likes": 0
  },
  "linkedin": {
    "handle": "handle"
  },
  "twitter": {
    "handle": "handle",
    "id": "id",
    "bio": "bio",
    "followers": 0,
    "following": 0,
    "location": "location",
    "site": "site",
    "avatar": "avatar"
  },
  "crunchbase": {
    "handle": "handle"
  },
  "emailProvider": true,
  "type": "type",
  "ticker": {},
  "identifiers": {
    "usEIN": {}
  },
  "phone": {},
  "metrics": {
    "alexaUsRank": 0,
    "alexaGlobalRank": 0,
    "trafficRank": "trafficRank",
    "employees": 0,
    "employeesRange": "employeesRange",
    "marketCap": {},
    "raised": 0,
    "annualRevenue": {},
    "estimatedAnnualRevenue": "estimatedAnnualRevenue",
    "fiscalYearEnd": {}
  },
  "indexedAt": "indexedAt",
  "tech": [
    "string"
  ],
  "techCategories": [
    "string"
  ],
  "parent": {
    "domain": {}
  },
  "ultimateParent": {
    "domain": {}
  }
}

json

application/json

Person API

GET

https://api.tomba.io/v1

/people/find

The Person API enables you to fetch social details tied to an email address—everything from the individual’s name and location to their Twitter handle.

Person API › query Parameters

email

string · required

The email address to find data.

Person API › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Person API › Responses

Person object to be returned

object

email

string

location

string

timeZone

string

utcOffset

number

object

bio

string

site

string

avatar

string

object

fuzzy

boolean

emailProvider

boolean

indexedAt

string

phone

string

activeAt

string

inactiveAt

string

GET/people/find

curl --request GET \
  --url 'https://api.tomba.io/v1/people/find?email=m%40wordpress.org' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "name": {
    "fullName": "fullName",
    "givenName": "givenName",
    "familyName": "familyName"
  },
  "email": "email",
  "location": "location",
  "timeZone": "timeZone",
  "utcOffset": 0,
  "geo": {
    "city": "city",
    "state": "state",
    "stateCode": "stateCode",
    "country": "country",
    "countryCode": "countryCode",
    "lat": 0,
    "lng": 0
  },
  "bio": "bio",
  "site": "site",
  "avatar": "avatar",
  "employment": {
    "domain": "domain",
    "name": "name",
    "title": "title",
    "role": "role",
    "subRole": "subRole",
    "seniority": "seniority"
  },
  "facebook": {
    "handle": "handle"
  },
  "github": {
    "handle": "handle",
    "id": "id",
    "avatar": "avatar",
    "company": "company",
    "blog": "blog",
    "followers": 0,
    "following": 0
  },
  "twitter": {
    "handle": "handle",
    "id": "id",
    "bio": "bio",
    "followers": 0,
    "following": 0,
    "statuses": 0,
    "favorites": 0,
    "location": "location",
    "site": "site",
    "avatar": "avatar"
  },
  "linkedin": {
    "handle": "handle"
  },
  "gravatar": {
    "handle": "handle",
    "urls": [
      {
        "value": "value",
        "title": "title"
      }
    ],
    "avatar": "avatar",
    "avatars": [
      {
        "url": "url",
        "type": "type"
      }
    ]
  },
  "fuzzy": true,
  "emailProvider": true,
  "indexedAt": "indexedAt",
  "phone": "phone",
  "activeAt": "activeAt",
  "inactiveAt": "inactiveAt"
}

json

application/json

Combined API

GET

https://api.tomba.io/v1

/combined/find

This endpoint expects an email address, and will return an object containing both the person and company (if found).

Combined API › query Parameters

email

string · required

The email address to find data.

Combined API › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Combined API › Responses

Combined person and company data retrieved successfully

object

GET/combined/find

curl --request GET \
  --url 'https://api.tomba.io/v1/combined/find?email=m%40wordpress.org' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "person": {
    "name": {
      "fullName": "fullName",
      "givenName": "givenName",
      "familyName": "familyName"
    },
    "email": "email",
    "location": "location",
    "timeZone": "timeZone",
    "utcOffset": 0,
    "geo": {
      "city": "city",
      "state": "state",
      "stateCode": "stateCode",
      "country": "country",
      "countryCode": "countryCode",
      "lat": 0,
      "lng": 0
    },
    "bio": "bio",
    "site": "site",
    "avatar": "avatar",
    "employment": {
      "domain": "domain",
      "name": "name",
      "title": "title",
      "role": "role",
      "subRole": "subRole",
      "seniority": "seniority"
    },
    "facebook": {
      "handle": "handle"
    },
    "github": {
      "handle": "handle",
      "id": "id",
      "avatar": "avatar",
      "company": "company",
      "blog": "blog",
      "followers": 0,
      "following": 0
    },
    "twitter": {
      "handle": "handle",
      "id": "id",
      "bio": "bio",
      "followers": 0,
      "following": 0,
      "statuses": 0,
      "favorites": 0,
      "location": "location",
      "site": "site",
      "avatar": "avatar"
    },
    "linkedin": {
      "handle": "handle"
    },
    "gravatar": {
      "handle": "handle",
      "urls": [
        {
          "value": "value",
          "title": "title"
        }
      ],
      "avatar": "avatar",
      "avatars": [
        {
          "url": "url",
          "type": "type"
        }
      ]
    },
    "fuzzy": true,
    "emailProvider": true,
    "indexedAt": "indexedAt",
    "phone": "phone",
    "activeAt": "activeAt",
    "inactiveAt": "inactiveAt"
  },
  "company": {
    "id": "id",
    "name": "name",
    "legalName": "legalName",
    "domain": "domain",
    "domainAliases": [
      "string"
    ],
    "site": {
      "phoneNumbers": [
        "string"
      ],
      "emailAddresses": [
        "string"
      ]
    },
    "category": {
      "sector": "sector",
      "industryGroup": "industryGroup",
      "industry": "industry",
      "subIndustry": "subIndustry",
      "sicCode": "sicCode",
      "sic4Codes": [
        "string"
      ],
      "naicsCode": "naicsCode",
      "naics6Codes": [
        "string"
      ]
    },
    "tags": [
      "string"
    ],
    "description": "description",
    "foundedYear": 0,
    "location": "location",
    "timeZone": "timeZone",
    "utcOffset": 0,
    "geo": {
      "streetNumber": "streetNumber",
      "streetName": "streetName",
      "subPremise": {},
      "streetAddress": "streetAddress",
      "city": "city",
      "postalCode": "postalCode",
      "state": "state",
      "stateCode": "stateCode",
      "country": "country",
      "countryCode": "countryCode",
      "lat": 0,
      "lng": 0
    },
    "logo": "logo",
    "facebook": {
      "handle": "handle",
      "likes": 0
    },
    "linkedin": {
      "handle": "handle"
    },
    "twitter": {
      "handle": "handle",
      "id": "id",
      "bio": "bio",
      "followers": 0,
      "following": 0,
      "location": "location",
      "site": "site",
      "avatar": "avatar"
    },
    "crunchbase": {
      "handle": "handle"
    },
    "emailProvider": true,
    "type": "type",
    "ticker": {},
    "identifiers": {
      "usEIN": {}
    },
    "phone": {},
    "metrics": {
      "alexaUsRank": 0,
      "alexaGlobalRank": 0,
      "trafficRank": "trafficRank",
      "employees": 0,
      "employeesRange": "employeesRange",
      "marketCap": {},
      "raised": 0,
      "annualRevenue": {},
      "estimatedAnnualRevenue": "estimatedAnnualRevenue",
      "fiscalYearEnd": {}
    },
    "indexedAt": "indexedAt",
    "tech": [
      "string"
    ],
    "techCategories": [
      "string"
    ],
    "parent": {
      "domain": {}
    },
    "ultimateParent": {
      "domain": {}
    }
  }
}

json

application/json

Bulks Leads

Company API

GET

https://api.tomba.io/v1

/companies/find

Our Company API lets you lookup company data via a domain

Company API › query Parameters

domain

string · required

The domain name for which you to find associated information.

Company API › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Company API › Responses

Company object to be returned

id

string

name

string

legalName

string

domain

string

domainAliases

string[]

object

tags

string[]

description

string

foundedYear

number

location

string

timeZone

string

utcOffset

number

object

logo

string

object

emailProvider

boolean

type

string

ticker

object

phone

object

indexedAt

string

tech

string[]

techCategories

string[]

object

{ "id": "id", "name": "name", "legalName": "legalName", "domain": "domain", "domainAliases": [ "string" ], "site": { "phoneNumbers": [ "string" ], "emailAddresses": [ "string" ] }, "category": { "sector": "sector", "industryGroup": "industryGroup", "industry": "industry", "subIndustry": "subIndustry", "sicCode": "sicCode", "sic4Codes": [ "string" ], "naicsCode": "naicsCode", "naics6Codes": [ "string" ] }, "tags": [ "string" ], "description": "description", "foundedYear": 0, "location": "location", "timeZone": "timeZone", "utcOffset": 0, "geo": { "streetNumber": "streetNumber", "streetName": "streetName", "subPremise": {}, "streetAddress": "streetAddress", "city": "city", "postalCode": "postalCode", "state": "state", "stateCode": "stateCode", "country": "country", "countryCode": "countryCode", "lat": 0, "lng": 0 }, "logo": "logo", "facebook": { "handle": "handle", "likes": 0 }, "linkedin": { "handle": "handle" }, "twitter": { "handle": "handle", "id": "id", "bio": "bio", "followers": 0, "following": 0, "location": "location", "site": "site", "avatar": "avatar" }, "crunchbase": { "handle": "handle" }, "emailProvider": true, "type": "type", "ticker": {}, "identifiers": { "usEIN": {} }, "phone": {}, "metrics": { "alexaUsRank": 0, "alexaGlobalRank": 0, "trafficRank": "trafficRank", "employees": 0, "employeesRange": "employeesRange", "marketCap": {}, "raised": 0, "annualRevenue": {}, "estimatedAnnualRevenue": "estimatedAnnualRevenue", "fiscalYearEnd": {} }, "indexedAt": "indexedAt", "tech": [ "string" ], "techCategories": [ "string" ], "parent": { "domain": {} }, "ultimateParent": { "domain": {} } }

Person API

GET

https://api.tomba.io/v1

/people/find

The Person API enables you to fetch social details tied to an email address—everything from the individual’s name and location to their Twitter handle.

Person API › query Parameters

email

string · required

The email address to find data.

Person API › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Person API › Responses

Person object to be returned

object

email

string

location

string

timeZone

string

utcOffset

number

object

bio

string

site

string

avatar

string

object

fuzzy

boolean

emailProvider

boolean

indexedAt

string

phone

string

activeAt

string

inactiveAt

string

{ "name": { "fullName": "fullName", "givenName": "givenName", "familyName": "familyName" }, "email": "email", "location": "location", "timeZone": "timeZone", "utcOffset": 0, "geo": { "city": "city", "state": "state", "stateCode": "stateCode", "country": "country", "countryCode": "countryCode", "lat": 0, "lng": 0 }, "bio": "bio", "site": "site", "avatar": "avatar", "employment": { "domain": "domain", "name": "name", "title": "title", "role": "role", "subRole": "subRole", "seniority": "seniority" }, "facebook": { "handle": "handle" }, "github": { "handle": "handle", "id": "id", "avatar": "avatar", "company": "company", "blog": "blog", "followers": 0, "following": 0 }, "twitter": { "handle": "handle", "id": "id", "bio": "bio", "followers": 0, "following": 0, "statuses": 0, "favorites": 0, "location": "location", "site": "site", "avatar": "avatar" }, "linkedin": { "handle": "handle" }, "gravatar": { "handle": "handle", "urls": [ { "value": "value", "title": "title" } ], "avatar": "avatar", "avatars": [ { "url": "url", "type": "type" } ] }, "fuzzy": true, "emailProvider": true, "indexedAt": "indexedAt", "phone": "phone", "activeAt": "activeAt", "inactiveAt": "inactiveAt" }

Combined API

GET

https://api.tomba.io/v1

/combined/find

This endpoint expects an email address, and will return an object containing both the person and company (if found).

Combined API › query Parameters

email

string · required

The email address to find data.

Combined API › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Combined API › Responses

Combined person and company data retrieved successfully

object

{ "person": { "name": { "fullName": "fullName", "givenName": "givenName", "familyName": "familyName" }, "email": "email", "location": "location", "timeZone": "timeZone", "utcOffset": 0, "geo": { "city": "city", "state": "state", "stateCode": "stateCode", "country": "country", "countryCode": "countryCode", "lat": 0, "lng": 0 }, "bio": "bio", "site": "site", "avatar": "avatar", "employment": { "domain": "domain", "name": "name", "title": "title", "role": "role", "subRole": "subRole", "seniority": "seniority" }, "facebook": { "handle": "handle" }, "github": { "handle": "handle", "id": "id", "avatar": "avatar", "company": "company", "blog": "blog", "followers": 0, "following": 0 }, "twitter": { "handle": "handle", "id": "id", "bio": "bio", "followers": 0, "following": 0, "statuses": 0, "favorites": 0, "location": "location", "site": "site", "avatar": "avatar" }, "linkedin": { "handle": "handle" }, "gravatar": { "handle": "handle", "urls": [ { "value": "value", "title": "title" } ], "avatar": "avatar", "avatars": [ { "url": "url", "type": "type" } ] }, "fuzzy": true, "emailProvider": true, "indexedAt": "indexedAt", "phone": "phone", "activeAt": "activeAt", "inactiveAt": "inactiveAt" }, "company": { "id": "id", "name": "name", "legalName": "legalName", "domain": "domain", "domainAliases": [ "string" ], "site": { "phoneNumbers": [ "string" ], "emailAddresses": [ "string" ] }, "category": { "sector": "sector", "industryGroup": "industryGroup", "industry": "industry", "subIndustry": "subIndustry", "sicCode": "sicCode", "sic4Codes": [ "string" ], "naicsCode": "naicsCode", "naics6Codes": [ "string" ] }, "tags": [ "string" ], "description": "description", "foundedYear": 0, "location": "location", "timeZone": "timeZone", "utcOffset": 0, "geo": { "streetNumber": "streetNumber", "streetName": "streetName", "subPremise": {}, "streetAddress": "streetAddress", "city": "city", "postalCode": "postalCode", "state": "state", "stateCode": "stateCode", "country": "country", "countryCode": "countryCode", "lat": 0, "lng": 0 }, "logo": "logo", "facebook": { "handle": "handle", "likes": 0 }, "linkedin": { "handle": "handle" }, "twitter": { "handle": "handle", "id": "id", "bio": "bio", "followers": 0, "following": 0, "location": "location", "site": "site", "avatar": "avatar" }, "crunchbase": { "handle": "handle" }, "emailProvider": true, "type": "type", "ticker": {}, "identifiers": { "usEIN": {} }, "phone": {}, "metrics": { "alexaUsRank": 0, "alexaGlobalRank": 0, "trafficRank": "trafficRank", "employees": 0, "employeesRange": "employeesRange", "marketCap": {}, "raised": 0, "annualRevenue": {}, "estimatedAnnualRevenue": "estimatedAnnualRevenue", "fiscalYearEnd": {} }, "indexedAt": "indexedAt", "tech": [ "string" ], "techCategories": [ "string" ], "parent": { "domain": {} }, "ultimateParent": { "domain": {} } } }