Enrichment

Download schema

Enrich people and company data with additional signals

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

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Company API › Responses

Company object to be returned

EnrichmentCompanyAPI

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

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Person API › Responses

Person object to be returned

EnrichmentPersonAPI

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

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Combined API › Responses

Combined person and company data retrieved successfully

EnrichmentCombinedAPI

EnrichmentPersonAPI

EnrichmentCompanyAPI

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

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Company API › Responses

Company object to be returned

EnrichmentCompanyAPI

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

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

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Person API › Responses

Person object to be returned

EnrichmentPersonAPI

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

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

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Combined API › Responses

Combined person and company data retrieved successfully

EnrichmentCombinedAPI

EnrichmentPersonAPI

EnrichmentCompanyAPI