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

​Finder Bulk

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

Bulk email finder operations

​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
Company BulkEnrich Bulk