Welcome to Tomba Docs! Create a free Tomba accountand gain instant access to 400+ million contacts!
Tomba
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 › Responses

    • 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 › 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

  • 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

​Create new search bulk operation › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • statusboolean

      Current status

    • progressinteger · 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 › Responses

    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 › Request Body

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

    New name for the bulk operation

​Rename search bulk operation › Responses

    • 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 › Responses

    • dataobject[]
    • metaobject

​Create new similar bulk operation

POST
https://api.tomba.io/v1
/bulk/similar

​Create new similar 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

  • 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

​Create new similar bulk operation › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • statusboolean

      Current status

    • progressinteger · 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 › Responses

    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 › Request Body

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

    New name for the bulk operation

​Rename similar bulk operation › Responses

    • 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 › Responses

    • dataobject[]
    • metaobject

​Create new company bulk operation

POST
https://api.tomba.io/v1
/bulk/company

​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

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • statusboolean

      Current status

    • progressinteger · 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 › Responses

    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 › Request Body

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

    New name for the bulk operation

​Rename company bulk operation › Responses

    • 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 › Responses

    • dataobject[]
    • metaobject

​Create new finder bulk operation

POST
https://api.tomba.io/v1
/bulk/finder

​Create new 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

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

  • filestring · required

    CSV file for bulk processing

​Create new finder bulk operation › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • statusboolean

      Current status

    • progressinteger · 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 › Responses

    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 › Request Body

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

    New name for the bulk operation

​Rename finder bulk operation › Responses

    • 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 › Responses

    • dataobject[]
    • metaobject

​Create new enrich bulk operation

POST
https://api.tomba.io/v1
/bulk/enrich

​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

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • statusboolean

      Current status

    • progressinteger · 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 › Responses

    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 › Request Body

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

    New name for the bulk operation

​Rename enrich bulk operation › Responses

    • 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 › Responses

    • dataobject[]
    • metaobject

​Create new LinkedIn bulk operation

POST
https://api.tomba.io/v1
/bulk/linkedin

​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

    • 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 › Responses

    • 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 › Responses

    • 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) › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • statusboolean

      Current status

    • progressinteger · 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 › Responses

    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 › Request Body

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

    New name for the bulk operation

​Rename LinkedIn bulk operation › Responses

    • 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 › Responses

    • dataobject[]
    • metaobject

​Create new author bulk operation

POST
https://api.tomba.io/v1
/bulk/author

​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

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • statusboolean

      Current status

    • progressinteger · 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 › Responses

    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 › Request Body

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

    New name for the bulk operation

​Rename author bulk operation › Responses

    • 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 › Responses

    • dataobject[]
    • metaobject

​Create new verifier bulk operation

POST
https://api.tomba.io/v1
/bulk/verifier

​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

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • statusboolean

      Current status

    • progressinteger · 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 › Responses

    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 › Request Body

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

    New name for the bulk operation

​Rename verifier bulk operation › Responses

    • 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 › Responses

    • dataobject[]
    • metaobject

​Create new phone finder bulk operation

POST
https://api.tomba.io/v1
/bulk/phone-finder

​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

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • statusboolean

      Current status

    • progressinteger · 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 › Responses

    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 › Request Body

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

    New name for the bulk operation

​Rename phone finder bulk operation › Responses

    • 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 › Responses

    • dataobject[]
    • metaobject

​Create new phone validator bulk operation

POST
https://api.tomba.io/v1
/bulk/phone-validator

​Create new phone validator 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

  • column_phoneinteger

    Phone number column

  • column_countryinteger

    Country column

  • filestring · required

    CSV file for phone validation

​Create new phone validator bulk operation › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • 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 › Responses

    • statusboolean

      Current status

    • progressinteger · 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 › Responses

    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 › Request Body

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

    New name for the bulk operation

​Rename phone validator bulk operation › Responses

    • dataobject
PhoneEnrichment