Tomba

Bulks

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

Get all search bulk operations

GET

https://api.tomba.io/v1

/bulk/search

Get all search bulk operations › query Parameters

pageinteger · min: 1
Page number for pagination
Default: 1
limitinteger · min: 1 · max: 50
Number of items per page (max 50)
Default: 10
directionstring · enum
Sort direction
Enum values:
desc
asc
Default: desc
filterstring · enum
Filter results
Enum values:
archived
all

Get all search bulk operations › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get all search bulk operations › Responses

List of bulk operations

dataobject[]
metaobject

Create new search bulk operation

POST

https://api.tomba.io/v1

/bulk/search

Create a new search bulk operation to find email addresses based on a list of domains.

You can provide the list of domains directly in the request body or upload a CSV file containing the domains.

Each domain should be on a new line in the CSV file.

The API will process the list and return a bulk operation ID that you can use to track the progress and retrieve the results once the operation is complete.

Create new search bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Create new search bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
Name of the bulk operation
maximumstring · enum · required
Maximum results per domain
Enum values:
1
5
10
20
50
100
email_typeobject · required
Type of emails to search for
departmentobject · required
Department filter

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

Create new search bulk operation › Responses

Bulk operation created successfully

dataobject

Get specific search bulk operation

GET

https://api.tomba.io/v1

/bulk/search/{id}

Get specific search bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Get specific search bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get specific search bulk operation › Responses

Bulk operation details

dataobject[]

Launch search bulk operation

PUT

https://api.tomba.io/v1

/bulk/search/{id}

Launch search bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Launch search bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Launch search bulk operation › Responses

Operation completed successfully

dataobject

Delete search bulk operation

DELETE

https://api.tomba.io/v1

/bulk/search/{id}/delete

Delete search bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Delete search bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Delete search bulk operation › Responses

Operation completed successfully

dataobject

Archive search bulk operation

DELETE

https://api.tomba.io/v1

/bulk/search/{id}/archive

Archive search bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Archive search bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Archive search bulk operation › Responses

Operation completed successfully

dataobject

Get search bulk operation progress

GET

https://api.tomba.io/v1

/bulk/search/{id}/progress

Get search bulk operation progress › path Parameters

idinteger · int64 · required
Bulk operation ID

Get search bulk operation progress › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get search bulk operation progress › Responses

Bulk operation progress

statusboolean
Current status
progressinteger · min: 0 · max: 100
Progress percentage
processedinteger
Number of items processed

Download search bulk results

GET

https://api.tomba.io/v1

/bulk/search/{id}/download

Download search bulk results › path Parameters

idinteger · int64 · required
Bulk operation ID

Download search bulk results › query Parameters

typestring · enum
Type of download file
Enum values:
full
not_found
valid
Default: full

Download search bulk results › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Download search bulk results › Responses

CSV file download

string

Rename search bulk operation

PUT

https://api.tomba.io/v1

/bulk/search/{id}/rename

Rename search bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Rename search bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Rename search bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
New name for the bulk operation

Rename search bulk operation › Responses

Operation completed successfully

dataobject

Get all similar bulk operations

GET

https://api.tomba.io/v1

/bulk/similar

Get all similar bulk operations › query Parameters

pageinteger · min: 1
Page number for pagination
Default: 1
limitinteger · min: 1 · max: 50
Number of items per page (max 50)
Default: 10
directionstring · enum
Sort direction
Enum values:
desc
asc
Default: desc
filterstring · enum
Filter results
Enum values:
archived
all

Get all similar bulk operations › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get all similar bulk operations › Responses

List of bulk operations

dataobject[]
metaobject

Create new similar bulk operation

POST

https://api.tomba.io/v1

/bulk/similar

Create new similar bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Create new similar bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
Name of the bulk operation
maximumstring · enum · required
Maximum results per domain
Enum values:
1
5
10
20
50
100
email_typeobject · required
Type of emails to search for
departmentobject · required
Department filter

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

Create new similar bulk operation › Responses

Bulk operation created successfully

dataobject

Get specific similar bulk operation

GET

https://api.tomba.io/v1

/bulk/similar/{id}

Get specific similar bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Get specific similar bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get specific similar bulk operation › Responses

Bulk operation details

dataobject[]

Launch similar bulk operation

PUT

https://api.tomba.io/v1

/bulk/similar/{id}

Launch similar bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Launch similar bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Launch similar bulk operation › Responses

Operation completed successfully

dataobject

Delete similar bulk operation

DELETE

https://api.tomba.io/v1

/bulk/similar/{id}/delete

Delete similar bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Delete similar bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Delete similar bulk operation › Responses

Operation completed successfully

dataobject

Archive similar bulk operation

DELETE

https://api.tomba.io/v1

/bulk/similar/{id}/archive

Archive similar bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Archive similar bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Archive similar bulk operation › Responses

Operation completed successfully

dataobject

Get similar bulk operation progress

GET

https://api.tomba.io/v1

/bulk/similar/{id}/progress

Get similar bulk operation progress › path Parameters

idinteger · int64 · required
Bulk operation ID

Get similar bulk operation progress › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get similar bulk operation progress › Responses

Bulk operation progress

statusboolean
Current status
progressinteger · min: 0 · max: 100
Progress percentage
processedinteger
Number of items processed

Download similar bulk results

GET

https://api.tomba.io/v1

/bulk/similar/{id}/download

Download similar bulk results › path Parameters

idinteger · int64 · required
Bulk operation ID

Download similar bulk results › query Parameters

typestring · enum
Type of download file
Enum values:
full
not_found
valid
Default: full

Download similar bulk results › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Download similar bulk results › Responses

CSV file download

string

Rename similar bulk operation

PUT

https://api.tomba.io/v1

/bulk/similar/{id}/rename

Rename similar bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Rename similar bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Rename similar bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
New name for the bulk operation

Rename similar bulk operation › Responses

Operation completed successfully

dataobject

Get all company bulk operations

GET

https://api.tomba.io/v1

/bulk/company

Get all company bulk operations › query Parameters

pageinteger · min: 1
Page number for pagination
Default: 1
limitinteger · min: 1 · max: 50
Number of items per page (max 50)
Default: 10
directionstring · enum
Sort direction
Enum values:
desc
asc
Default: desc
filterstring · enum
Filter results
Enum values:
archived
all

Get all company bulk operations › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get all company bulk operations › Responses

List of bulk operations

dataobject[]
metaobject

Create new company bulk operation

POST

https://api.tomba.io/v1

/bulk/company

Create new company bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Create new company bulk operation › Request Body

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

Create new company bulk operation › Responses

Bulk operation created successfully

dataobject

Get specific company bulk operation

GET

https://api.tomba.io/v1

/bulk/company/{id}

Get specific company bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Get specific company bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get specific company bulk operation › Responses

Bulk operation details

dataobject[]

Launch company bulk operation

PUT

https://api.tomba.io/v1

/bulk/company/{id}

Launch company bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Launch company bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Launch company bulk operation › Responses

Operation completed successfully

dataobject

Delete company bulk operation

DELETE

https://api.tomba.io/v1

/bulk/company/{id}/delete

Delete company bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Delete company bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Delete company bulk operation › Responses

Operation completed successfully

dataobject

Archive company bulk operation

DELETE

https://api.tomba.io/v1

/bulk/company/{id}/archive

Archive company bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Archive company bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Archive company bulk operation › Responses

Operation completed successfully

dataobject

Get company bulk operation progress

GET

https://api.tomba.io/v1

/bulk/company/{id}/progress

Get company bulk operation progress › path Parameters

idinteger · int64 · required
Bulk operation ID

Get company bulk operation progress › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get company bulk operation progress › Responses

Bulk operation progress

statusboolean
Current status
progressinteger · min: 0 · max: 100
Progress percentage
processedinteger
Number of items processed

Download company bulk results

GET

https://api.tomba.io/v1

/bulk/company/{id}/download

Download company bulk results › path Parameters

idinteger · int64 · required
Bulk operation ID

Download company bulk results › query Parameters

typestring · enum
Type of download file
Enum values:
full
not_found
valid
Default: full

Download company bulk results › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Download company bulk results › Responses

CSV file download

string

Rename company bulk operation

PUT

https://api.tomba.io/v1

/bulk/company/{id}/rename

Rename company bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Rename company bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Rename company bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
New name for the bulk operation

Rename company bulk operation › Responses

Operation completed successfully

dataobject

Get all finder bulk operations

GET

https://api.tomba.io/v1

/bulk/finder

Get all finder bulk operations › query Parameters

pageinteger · min: 1
Page number for pagination
Default: 1
limitinteger · min: 1 · max: 50
Number of items per page (max 50)
Default: 10
directionstring · enum
Sort direction
Enum values:
desc
asc
Default: desc
filterstring · enum
Filter results
Enum values:
archived
all

Get all finder bulk operations › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get all finder bulk operations › Responses

List of bulk operations

dataobject[]
metaobject

Create new finder bulk operation

POST

https://api.tomba.io/v1

/bulk/finder

Create new finder bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Create new finder bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
Name of the bulk operation
filestring · required

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
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)

Create new finder bulk operation › Responses

Bulk operation created successfully

dataobject

Get specific finder bulk operation

GET

https://api.tomba.io/v1

/bulk/finder/{id}

Get specific finder bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Get specific finder bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get specific finder bulk operation › Responses

Bulk operation details

dataobject[]

Launch finder bulk operation

PUT

https://api.tomba.io/v1

/bulk/finder/{id}

Launch finder bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Launch finder bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Launch finder bulk operation › Responses

Operation completed successfully

dataobject

Delete finder bulk operation

DELETE

https://api.tomba.io/v1

/bulk/finder/{id}/delete

Delete finder bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Delete finder bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Delete finder bulk operation › Responses

Operation completed successfully

dataobject

Archive finder bulk operation

DELETE

https://api.tomba.io/v1

/bulk/finder/{id}/archive

Archive finder bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Archive finder bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Archive finder bulk operation › Responses

Operation completed successfully

dataobject

Get finder bulk operation progress

GET

https://api.tomba.io/v1

/bulk/finder/{id}/progress

Get finder bulk operation progress › path Parameters

idinteger · int64 · required
Bulk operation ID

Get finder bulk operation progress › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get finder bulk operation progress › Responses

Bulk operation progress

statusboolean
Current status
progressinteger · min: 0 · max: 100
Progress percentage
processedinteger
Number of items processed

Download finder bulk results

GET

https://api.tomba.io/v1

/bulk/finder/{id}/download

Download finder bulk results › path Parameters

idinteger · int64 · required
Bulk operation ID

Download finder bulk results › query Parameters

typestring · enum
Type of download file
Enum values:
full
not_found
valid
Default: full

Download finder bulk results › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Download finder bulk results › Responses

CSV file download

string

Rename finder bulk operation

PUT

https://api.tomba.io/v1

/bulk/finder/{id}/rename

Rename finder bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Rename finder bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Rename finder bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
New name for the bulk operation

Rename finder bulk operation › Responses

Operation completed successfully

dataobject

Get all enrich bulk operations

GET

https://api.tomba.io/v1

/bulk/enrich

Get all enrich bulk operations › query Parameters

pageinteger · min: 1
Page number for pagination
Default: 1
limitinteger · min: 1 · max: 50
Number of items per page (max 50)
Default: 10
directionstring · enum
Sort direction
Enum values:
desc
asc
Default: desc
filterstring · enum
Filter results
Enum values:
archived
all

Get all enrich bulk operations › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get all enrich bulk operations › Responses

List of bulk operations

dataobject[]
metaobject

Create new enrich bulk operation

POST

https://api.tomba.io/v1

/bulk/enrich

Create new enrich bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Create new enrich bulk operation › Request Body

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

Create new enrich bulk operation › Responses

Bulk operation created successfully

dataobject

Get specific enrich bulk operation

GET

https://api.tomba.io/v1

/bulk/enrich/{id}

Get specific enrich bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Get specific enrich bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get specific enrich bulk operation › Responses

Bulk operation details

dataobject[]

Launch enrich bulk operation

PUT

https://api.tomba.io/v1

/bulk/enrich/{id}

Launch enrich bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Launch enrich bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Launch enrich bulk operation › Responses

Operation completed successfully

dataobject

Delete enrich bulk operation

DELETE

https://api.tomba.io/v1

/bulk/enrich/{id}/delete

Delete enrich bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Delete enrich bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Delete enrich bulk operation › Responses

Operation completed successfully

dataobject

Archive enrich bulk operation

DELETE

https://api.tomba.io/v1

/bulk/enrich/{id}/archive

Archive enrich bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Archive enrich bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Archive enrich bulk operation › Responses

Operation completed successfully

dataobject

Get enrich bulk operation progress

GET

https://api.tomba.io/v1

/bulk/enrich/{id}/progress

Get enrich bulk operation progress › path Parameters

idinteger · int64 · required
Bulk operation ID

Get enrich bulk operation progress › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get enrich bulk operation progress › Responses

Bulk operation progress

statusboolean
Current status
progressinteger · min: 0 · max: 100
Progress percentage
processedinteger
Number of items processed

Download enrich bulk results

GET

https://api.tomba.io/v1

/bulk/enrich/{id}/download

Download enrich bulk results › path Parameters

idinteger · int64 · required
Bulk operation ID

Download enrich bulk results › query Parameters

typestring · enum
Type of download file
Enum values:
full
not_found
valid
Default: full

Download enrich bulk results › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Download enrich bulk results › Responses

CSV file download

string

Rename enrich bulk operation

PUT

https://api.tomba.io/v1

/bulk/enrich/{id}/rename

Rename enrich bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Rename enrich bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Rename enrich bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
New name for the bulk operation

Rename enrich bulk operation › Responses

Operation completed successfully

dataobject

Get all LinkedIn bulk operations

GET

https://api.tomba.io/v1

/bulk/linkedin

Get all LinkedIn bulk operations › query Parameters

pageinteger · min: 1
Page number for pagination
Default: 1
limitinteger · min: 1 · max: 50
Number of items per page (max 50)
Default: 10
directionstring · enum
Sort direction
Enum values:
desc
asc
Default: desc
filterstring · enum
Filter results
Enum values:
archived
all

Get all LinkedIn bulk operations › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get all LinkedIn bulk operations › Responses

List of bulk operations

dataobject[]
metaobject

Create new LinkedIn bulk operation

POST

https://api.tomba.io/v1

/bulk/linkedin

Create new LinkedIn bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Create new LinkedIn bulk operation › Request Body

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

Create new LinkedIn bulk operation › Responses

Bulk operation created successfully

dataobject

Get specific LinkedIn bulk operation

GET

https://api.tomba.io/v1

/bulk/linkedin/{id}

Get specific LinkedIn bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Get specific LinkedIn bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get specific LinkedIn bulk operation › Responses

Bulk operation details

dataobject[]

Launch LinkedIn bulk operation

PUT

https://api.tomba.io/v1

/bulk/linkedin/{id}

Launch LinkedIn bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Launch LinkedIn bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Launch LinkedIn bulk operation › Responses

Operation completed successfully

dataobject

Delete LinkedIn bulk operation (alternative endpoint)

DELETE

https://api.tomba.io/v1

/bulk/linkedin/{id}

Delete LinkedIn bulk operation (alternative endpoint) › path Parameters

idinteger · int64 · required
Bulk operation ID

Delete LinkedIn bulk operation (alternative endpoint) › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Delete LinkedIn bulk operation (alternative endpoint) › Responses

Operation completed successfully

dataobject

Delete LinkedIn bulk operation

DELETE

https://api.tomba.io/v1

/bulk/linkedin/{id}/delete

Delete LinkedIn bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Delete LinkedIn bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Delete LinkedIn bulk operation › Responses

Operation completed successfully

dataobject

Archive LinkedIn bulk operation

DELETE

https://api.tomba.io/v1

/bulk/linkedin/{id}/archive

Archive LinkedIn bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Archive LinkedIn bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Archive LinkedIn bulk operation › Responses

Operation completed successfully

dataobject

Get LinkedIn bulk operation progress

GET

https://api.tomba.io/v1

/bulk/linkedin/{id}/progress

Get LinkedIn bulk operation progress › path Parameters

idinteger · int64 · required
Bulk operation ID

Get LinkedIn bulk operation progress › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get LinkedIn bulk operation progress › Responses

Bulk operation progress

statusboolean
Current status
progressinteger · min: 0 · max: 100
Progress percentage
processedinteger
Number of items processed

Download LinkedIn bulk results

GET

https://api.tomba.io/v1

/bulk/linkedin/{id}/download

Download LinkedIn bulk results › path Parameters

idinteger · int64 · required
Bulk operation ID

Download LinkedIn bulk results › query Parameters

typestring · enum
Type of download file
Enum values:
full
not_found
valid
Default: full

Download LinkedIn bulk results › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Download LinkedIn bulk results › Responses

CSV file download

string

Rename LinkedIn bulk operation

PUT

https://api.tomba.io/v1

/bulk/linkedin/{id}/rename

Rename LinkedIn bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Rename LinkedIn bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Rename LinkedIn bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
New name for the bulk operation

Rename LinkedIn bulk operation › Responses

Operation completed successfully

dataobject

Get all author bulk operations

GET

https://api.tomba.io/v1

/bulk/author

Get all author bulk operations › query Parameters

pageinteger · min: 1
Page number for pagination
Default: 1
limitinteger · min: 1 · max: 50
Number of items per page (max 50)
Default: 10
directionstring · enum
Sort direction
Enum values:
desc
asc
Default: desc
filterstring · enum
Filter results
Enum values:
archived
all

Get all author bulk operations › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get all author bulk operations › Responses

List of bulk operations

dataobject[]
metaobject

Create new author bulk operation

POST

https://api.tomba.io/v1

/bulk/author

Create new author bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Create new author bulk operation › Request Body

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

Create new author bulk operation › Responses

Bulk operation created successfully

dataobject

Get specific author bulk operation

GET

https://api.tomba.io/v1

/bulk/author/{id}

Get specific author bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Get specific author bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get specific author bulk operation › Responses

Bulk operation details

dataobject[]

Launch author bulk operation

PUT

https://api.tomba.io/v1

/bulk/author/{id}

Launch author bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Launch author bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Launch author bulk operation › Responses

Operation completed successfully

dataobject

Delete author bulk operation

DELETE

https://api.tomba.io/v1

/bulk/author/{id}/delete

Delete author bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Delete author bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Delete author bulk operation › Responses

Operation completed successfully

dataobject

Archive author bulk operation

DELETE

https://api.tomba.io/v1

/bulk/author/{id}/archive

Archive author bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Archive author bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Archive author bulk operation › Responses

Operation completed successfully

dataobject

Get author bulk operation progress

GET

https://api.tomba.io/v1

/bulk/author/{id}/progress

Get author bulk operation progress › path Parameters

idinteger · int64 · required
Bulk operation ID

Get author bulk operation progress › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get author bulk operation progress › Responses

Bulk operation progress

statusboolean
Current status
progressinteger · min: 0 · max: 100
Progress percentage
processedinteger
Number of items processed

Download author bulk results

GET

https://api.tomba.io/v1

/bulk/author/{id}/download

Download author bulk results › path Parameters

idinteger · int64 · required
Bulk operation ID

Download author bulk results › query Parameters

typestring · enum
Type of download file
Enum values:
full
not_found
valid
Default: full

Download author bulk results › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Download author bulk results › Responses

CSV file download

string

Rename author bulk operation

PUT

https://api.tomba.io/v1

/bulk/author/{id}/rename

Rename author bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Rename author bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Rename author bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
New name for the bulk operation

Rename author bulk operation › Responses

Operation completed successfully

dataobject

Get all verifier bulk operations

GET

https://api.tomba.io/v1

/bulk/verifier

Get all verifier bulk operations › query Parameters

pageinteger · min: 1
Page number for pagination
Default: 1
limitinteger · min: 1 · max: 50
Number of items per page (max 50)
Default: 10
directionstring · enum
Sort direction
Enum values:
desc
asc
Default: desc
filterstring · enum
Filter results
Enum values:
archived
all

Get all verifier bulk operations › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get all verifier bulk operations › Responses

List of bulk operations

dataobject[]
metaobject

Create new verifier bulk operation

POST

https://api.tomba.io/v1

/bulk/verifier

Create new verifier bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Create new verifier bulk operation › Request Body

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

Create new verifier bulk operation › Responses

Bulk operation created successfully

dataobject

Get specific verifier bulk operation

GET

https://api.tomba.io/v1

/bulk/verifier/{id}

Get specific verifier bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Get specific verifier bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get specific verifier bulk operation › Responses

Bulk operation details

dataobject[]

Launch verifier bulk operation

PUT

https://api.tomba.io/v1

/bulk/verifier/{id}

Launch verifier bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Launch verifier bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Launch verifier bulk operation › Responses

Operation completed successfully

dataobject

Delete verifier bulk operation

DELETE

https://api.tomba.io/v1

/bulk/verifier/{id}/delete

Delete verifier bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Delete verifier bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Delete verifier bulk operation › Responses

Operation completed successfully

dataobject

Archive verifier bulk operation

DELETE

https://api.tomba.io/v1

/bulk/verifier/{id}/archive

Archive verifier bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Archive verifier bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Archive verifier bulk operation › Responses

Operation completed successfully

dataobject

Get verifier bulk operation progress

GET

https://api.tomba.io/v1

/bulk/verifier/{id}/progress

Get verifier bulk operation progress › path Parameters

idinteger · int64 · required
Bulk operation ID

Get verifier bulk operation progress › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get verifier bulk operation progress › Responses

Bulk operation progress

statusboolean
Current status
progressinteger · min: 0 · max: 100
Progress percentage
processedinteger
Number of items processed

Download verifier bulk results

GET

https://api.tomba.io/v1

/bulk/verifier/{id}/download

Download verifier bulk results › path Parameters

idinteger · int64 · required
Bulk operation ID

Download verifier bulk results › query Parameters

typestring · enum
Type of download file
Enum values:
full
not_found
valid
Default: full

Download verifier bulk results › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Download verifier bulk results › Responses

CSV file download

string

Rename verifier bulk operation

PUT

https://api.tomba.io/v1

/bulk/verifier/{id}/rename

Rename verifier bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Rename verifier bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Rename verifier bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
New name for the bulk operation

Rename verifier bulk operation › Responses

Operation completed successfully

dataobject

Get all phone finder bulk operations

GET

https://api.tomba.io/v1

/bulk/phone-finder

Get all phone finder bulk operations › query Parameters

pageinteger · min: 1
Page number for pagination
Default: 1
limitinteger · min: 1 · max: 50
Number of items per page (max 50)
Default: 10
directionstring · enum
Sort direction
Enum values:
desc
asc
Default: desc
filterstring · enum
Filter results
Enum values:
archived
all

Get all phone finder bulk operations › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get all phone finder bulk operations › Responses

List of bulk operations

dataobject[]
metaobject

Create new phone finder bulk operation

POST

https://api.tomba.io/v1

/bulk/phone-finder

Create new phone finder bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Create new phone finder bulk operation › Request Body

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

Create new phone finder bulk operation › Responses

Bulk operation created successfully

dataobject

Get specific phone finder bulk operation

GET

https://api.tomba.io/v1

/bulk/phone-finder/{id}

Get specific phone finder bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Get specific phone finder bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get specific phone finder bulk operation › Responses

Bulk operation details

dataobject[]

Launch phone finder bulk operation

PUT

https://api.tomba.io/v1

/bulk/phone-finder/{id}

Launch phone finder bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Launch phone finder bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Launch phone finder bulk operation › Responses

Operation completed successfully

dataobject

Delete phone finder bulk operation

DELETE

https://api.tomba.io/v1

/bulk/phone-finder/{id}/delete

Delete phone finder bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Delete phone finder bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Delete phone finder bulk operation › Responses

Operation completed successfully

dataobject

Archive phone finder bulk operation

DELETE

https://api.tomba.io/v1

/bulk/phone-finder/{id}/archive

Archive phone finder bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Archive phone finder bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Archive phone finder bulk operation › Responses

Operation completed successfully

dataobject

Get phone finder bulk operation progress

GET

https://api.tomba.io/v1

/bulk/phone-finder/{id}/progress

Get phone finder bulk operation progress › path Parameters

idinteger · int64 · required
Bulk operation ID

Get phone finder bulk operation progress › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get phone finder bulk operation progress › Responses

Bulk operation progress

statusboolean
Current status
progressinteger · min: 0 · max: 100
Progress percentage
processedinteger
Number of items processed

Download phone finder bulk results

GET

https://api.tomba.io/v1

/bulk/phone-finder/{id}/download

Download phone finder bulk results › path Parameters

idinteger · int64 · required
Bulk operation ID

Download phone finder bulk results › query Parameters

typestring · enum
Type of download file
Enum values:
full
not_found
valid
Default: full

Download phone finder bulk results › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Download phone finder bulk results › Responses

CSV file download

string

Rename phone finder bulk operation

PUT

https://api.tomba.io/v1

/phone-finder/{id}/rename

Rename phone finder bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Rename phone finder bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Rename phone finder bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
New name for the bulk operation

Rename phone finder bulk operation › Responses

Operation completed successfully

dataobject

Get all phone validator bulk operations

GET

https://api.tomba.io/v1

/bulk/phone-validator

Get all phone validator bulk operations › query Parameters

pageinteger · min: 1
Page number for pagination
Default: 1
limitinteger · min: 1 · max: 50
Number of items per page (max 50)
Default: 10
directionstring · enum
Sort direction
Enum values:
desc
asc
Default: desc
filterstring · enum
Filter results
Enum values:
archived
all

Get all phone validator bulk operations › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get all phone validator bulk operations › Responses

List of bulk operations

dataobject[]
metaobject

Create new phone validator bulk operation

POST

https://api.tomba.io/v1

/bulk/phone-validator

Create new phone validator bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Create new phone validator bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
Name of the bulk operation
filestring · required

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
column_phoneinteger
Phone number column
column_countryinteger
Country column

Create new phone validator bulk operation › Responses

Bulk operation created successfully

dataobject

Get specific phone validator bulk operation

GET

https://api.tomba.io/v1

/bulk/phone-validator/{id}

Get specific phone validator bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Get specific phone validator bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get specific phone validator bulk operation › Responses

Bulk operation details

dataobject[]

Launch phone validator bulk operation

PUT

https://api.tomba.io/v1

/bulk/phone-validator/{id}

Launch phone validator bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Launch phone validator bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Launch phone validator bulk operation › Responses

Operation completed successfully

dataobject

Delete phone validator bulk operation

DELETE

https://api.tomba.io/v1

/bulk/phone-validator/{id}/delete

Delete phone validator bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Delete phone validator bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Delete phone validator bulk operation › Responses

Operation completed successfully

dataobject

Archive phone validator bulk operation

DELETE

https://api.tomba.io/v1

/bulk/phone-validator/{id}/archive

Archive phone validator bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Archive phone validator bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Archive phone validator bulk operation › Responses

Operation completed successfully

dataobject

Get phone validator bulk operation progress

GET

https://api.tomba.io/v1

/bulk/phone-validator/{id}/progress

Get phone validator bulk operation progress › path Parameters

idinteger · int64 · required
Bulk operation ID

Get phone validator bulk operation progress › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get phone validator bulk operation progress › Responses

Bulk operation progress

statusboolean
Current status
progressinteger · min: 0 · max: 100
Progress percentage
processedinteger
Number of items processed

Download phone validator bulk results

GET

https://api.tomba.io/v1

/bulk/phone-validator/{id}/download

Download phone validator bulk results › path Parameters

idinteger · int64 · required
Bulk operation ID

Download phone validator bulk results › query Parameters

typestring · enum
Type of download file
Enum values:
full
not_found
valid
Default: full

Download phone validator bulk results › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Download phone validator bulk results › Responses

CSV file download

string

Rename phone validator bulk operation

PUT

https://api.tomba.io/v1

/bulk/phone-validator/{id}/rename

Rename phone validator bulk operation › path Parameters

idinteger · int64 · required
Bulk operation ID

Rename phone validator bulk operation › Headers

X-Tomba-Keystring · required
Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY
X-Tomba-Secretstring · required
Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Rename phone validator bulk operation › Request Body

namestring · minLength: 3 · maxLength: 200 · required
New name for the bulk operation

Rename phone validator bulk operation › Responses

Operation completed successfully

dataobject

Phone Enrichment