Skip to main content

Overview

Encrata supports two bulk operation modes:
  1. Inline bulk Send an array of queries in a single POST request (up to 100 items)
  2. Async bulk jobs Upload a CSV file for background processing (up to 10,000 rows)

Inline Bulk Endpoints

These endpoints accept an array of queries and return results synchronously. Best for smaller batches (≤100 items).

Bulk Email Lookup

emails
string[]
required
Array of email addresses to enrich (max 1,000).
Example:
Results are streamed via Server-Sent Events (SSE) for real-time progress.
queries
string[]
required
Array of search queries (max 100).

queries
string[]
required
Array of company names or domains (max 100).

queries
string[]
required
Array of domain names (max 100).

queries
string[]
required
Array of IP addresses (max 100).

Async Bulk Jobs

For large-scale operations (100–10,000 records), use async bulk jobs. Upload a CSV, and results are processed in the background.

Create Bulk Job

Upload a CSV file with a column of queries. The job processes in the background and notifies you when complete. Form fields: Example:
Response:

Get Bulk Job Status

Returns current progress and status. Response:
Statuses: queued, processing, completed, failed, cancelled

Download Results

Downloads the enriched results as a CSV file once the job is complete.

Cancel Bulk Job

Cancels a running bulk job. Already-processed rows are kept.

Credits

Each row in a bulk operation consumes credits at the standard rate for that lookup type. Failed lookups (invalid input) do not consume credits.

Webhooks

When a bulk job completes, the bulk_job.completed webhook event is fired if you have webhooks configured.