Welcome to Tomba Docs! Create a free Tomba accountand gain instant access to 400+ million contacts!
Tomba
Tomba

​Schemas

​Account

  • dataobject

​DomainSearch

  • organizationobject
  • emailsobject[]

​EmailFinder

  • emailstring
  • first_namestring
  • last_namestring
  • full_namestring
  • countrystring · nullable
  • positionstring · nullable
  • twitterstring · nullable
  • linkedinstring · nullable
  • phone_numberstring · nullable
  • accept_allboolean
  • website_urlstring
  • companystring
  • scoreinteger · int32
  • verificationobject
  • sourcesobject[]

​EmailVerifier

  • emailobject
  • sourcesobject[]

​EnrichmentPersonAPI

  • nameobject
  • emailstring
  • locationstring
  • timeZonestring
  • utcOffsetnumber
  • geoobject
  • biostring
  • sitestring
  • avatarstring
  • employmentobject
  • facebookobject
  • githubobject
  • twitterobject
  • linkedinobject
  • gravatarobject
  • fuzzyboolean
  • emailProviderboolean
  • indexedAtstring
  • phonestring
  • activeAtstring
  • inactiveAtstring

​EnrichmentCompanyAPI

  • idstring
  • namestring
  • legalNamestring
  • domainstring
  • domainAliasesstring[]
  • siteobject
  • categoryobject
  • tagsstring[]
  • descriptionstring
  • foundedYearnumber
  • locationstring
  • timeZonestring
  • utcOffsetnumber
  • geoobject
  • logostring
  • facebookobject
  • linkedinobject
  • twitterobject
  • crunchbaseobject
  • emailProviderboolean
  • typestring
  • ticker
  • identifiersobject
  • phone
  • metricsobject
  • indexedAtstring
  • techstring[]
  • techCategoriesstring[]
  • parentobject
  • ultimateParentobject

​EnrichmentCombinedAPI

  • personobject
  • companyobject

​EmailCount

  • dataobject

​Location

  • dataobject[]

​EmailSources

  • emailstring
  • dataobject[]

​Format

  • dataobject[]

​DomainSimilar

  • dataobject[]

​DomainTechnology

  • domainstring
  • dataobject[]

​PhoneFinder

  • dataobject

​Lead

  • idstring · required
  • emailstring · required
  • firstNamestring
  • lastNamestring
  • companystring
  • titlestring
  • attributesobject[]

​LeadAttribute

  • idstring · required
  • namestring · required
  • valuestring · required

​LeadsList

  • idstring · required
  • namestring · required
  • descriptionstring
  • leadsobject[]

​Key

  • idstring · required
  • keystring · required
  • createdAtstring · date-time

​Usage

  • requestsinteger · required
  • limitinteger · required
  • resetAtstring · date-time · required

​Log

  • idstring · required
  • endpointstring · required
  • methodstring · required
  • statusinteger · required
  • timestampstring · date-time · required

​Success

  • dataobject

​Errors

  • errorsobject · required

​BulkDef

  • namestring · minLength: 3 · maxLength: 200 · required

    Name of the bulk operation

  • liststring

    List of items to process (domains, emails, etc.)

  • sourcesboolean

    Include sources in results

  • notifieboolean

    Send notifications

  • verifyboolean

    Enable verification

  • totalinteger

    Total number of items

  • delimiterstring

    CSV delimiter character

  • validboolean

    Valid flag

  • columninteger

    Column number for processing

​BulkPutRename

  • namestring · minLength: 3 · maxLength: 200 · required

    New name for the bulk operation

​BulkPostSearch

  • maximumstring · enum · required

    Maximum results per domain

    Enum values:
    1
    5
    10
    20
    50
    100
  • email_typestring · required

    Type of emails to search for

  • departmentstring · required

    Department filter

​BulkPostFinder

  • column_firstinteger

    First name column number

  • column_lastinteger

    Last name column number

  • column_nameinteger

    Full name column number

  • column_domaininteger

    Domain column number (required)

  • skipboolean

    Skip first row (header)

​BulkPhoneValidator

  • column_phoneinteger

    Phone number column

  • column_countryinteger

    Country column

​BulkItem

  • bulk_idinteger · int64

    Unique identifier for the bulk operation

  • namestring

    Name of the bulk operation

  • maximumstring

    Maximum results setting

  • email_typestring

    Email type filter

  • departmentstring

    Department filter

  • sourcesboolean

    Sources included

  • file_namestring

    Generated filename

  • totalinteger

    Total results

  • total_listinteger

    Total items in list

  • statusboolean

    Completion status

  • chartobject

    Chart data

  • tableobject

    Table data

  • created_atstring · date-time

    Creation timestamp

  • user_idinteger · int64

    User ID who created the bulk

  • launchedboolean

    Whether the bulk has been launched

  • usedboolean

    Whether results have been downloaded

  • time_trackstring

    Time tracking information

  • progressinteger · max: 100

    Progress percentage

  • verifyboolean

    Verification enabled

  • verify_costinteger

    Verification cost

  • total_emailsinteger

    Total emails found

  • processedinteger

    Number of items processed

  • expired_atstring · date-time

    Expiration timestamp

  • expiredboolean

    Whether the bulk has expired

  • bulk_typestring

    Type of bulk operation

​BulkProgress

  • statusboolean

    Current status

  • progressinteger · max: 100

    Progress percentage

  • processedinteger

    Number of items processed

​PaginationMeta

  • totalinteger

    Total number of items

  • pageSizeinteger

    Items per page

  • currentinteger

    Current page number

  • total_pagesnumber

    Total number of pages

​DataID

  • idinteger · int64

    Created resource ID

​Data

  • statusboolean

    Operation status

  • messagestring

    Status message

  • codeinteger

    HTTP status code

​Error

  • typestring · enum

    Error type

    Enum values:
    params_invalid
    unknown_record
    unknown_route
    queued
    rate_limit
    api_error
    ip_blocked
    authentication_failed
  • messagestring

    Error message

  • codeinteger

    HTTP status code