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

Similar Bulk

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

Bulk similar domain operations


Get all similar bulk operations

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

Get all similar bulk operationsquery 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 operationsResponses

    • dataobject[]
    • metaobject

Create new similar bulk operation

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

Create new similar bulk operationRequest 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_typestring · required

    Type of emails to search for

  • departmentstring · required

    Department filter

Create new similar bulk operationResponses

    • dataobject

Get specific similar bulk operation

GET
https://api.tomba.io/v1
/bulk/similar/{id}

Get specific similar bulk operationpath Parameters

  • idinteger · int64 · required

    Bulk operation ID

Get specific similar bulk operationResponses

    • dataobject[]

Launch similar bulk operation

PUT
https://api.tomba.io/v1
/bulk/similar/{id}

Launch similar bulk operationpath Parameters

  • idinteger · int64 · required

    Bulk operation ID

Launch similar bulk operationResponses

    • dataobject

Delete similar bulk operation

DELETE
https://api.tomba.io/v1
/bulk/similar/{id}/delete

Delete similar bulk operationpath Parameters

  • idinteger · int64 · required

    Bulk operation ID

Delete similar bulk operationResponses

    • dataobject

Archive similar bulk operation

DELETE
https://api.tomba.io/v1
/bulk/similar/{id}/archive

Archive similar bulk operationpath Parameters

  • idinteger · int64 · required

    Bulk operation ID

Archive similar bulk operationResponses

    • dataobject

Get similar bulk operation progress

GET
https://api.tomba.io/v1
/bulk/similar/{id}/progress

Get similar bulk operation progresspath Parameters

  • idinteger · int64 · required

    Bulk operation ID

Get similar bulk operation progressResponses

    • 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 resultspath Parameters

  • idinteger · int64 · required

    Bulk operation ID

Download similar bulk resultsquery Parameters

  • typestring · enum

    Type of download file

    Enum values:
    full
    not_found
    valid
    Default: full

Download similar bulk resultsResponses

    string

Rename similar bulk operation

PUT
https://api.tomba.io/v1
/bulk/similar/{id}/rename

Rename similar bulk operationpath Parameters

  • idinteger · int64 · required

    Bulk operation ID

Rename similar bulk operationRequest Body

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

    New name for the bulk operation

Rename similar bulk operationResponses

    • dataobject