Bulk Email Search: Create with File Upload

Use this API endpoint to create a Bulk Email Search by uploading a file (CSV or Excel). The system determines the type of email search to perform based on the fields you map.

Endpoint

POST

https://api.anymailfinder.com
/v5.1/bulk/multipart

Pricing

This endpoint is free to use.

Credits are only charged when you download the results for the first time.

Authentication

Include your API key using the Authorization header.
Refer to the Authentication page for setup instructions.

Code example

curl -X POST "https://api.anymailfinder.com/v5.1/bulk/multipart" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@your-leads-file.csv" \
  -F "domain_field_index=0" \
  -F "first_name_field_index=1" \
  -F "last_name_field_index=2" \
  -F "file_name=tech_ceos"

Download sample file

Request parameters

Send as "multipart/form-data" in the POST body:

Parameter	Example value	Description
`file` file	`"your-leads-file.csv"`	A CSV or Excel file containing your data. The first row should contain headers.
`company_name_field_index` integer - optional	`null`	The zero-based index of the column containing the company name.
`decision_maker_category` string - optional	`null`	The category of the decision maker to search for. Possible values: ceo, engineering, finance, hr, it, logistics, marketing, operations, buyer, sales.
`domain_field_index` integer - optional	`0`	The zero-based index of the column containing the domain.
`email_field_index` integer - optional	`null`	The zero-based index of the column containing the emails to validate.
`file_name` string - optional	`null`	A label to identify the bulk search.
`first_name_field_index` integer - optional	`1`	The zero-based index of the column containing the first name.
`full_name_field_index` integer - optional	`null`	The zero-based index of the column containing the full name.
`last_name_field_index` integer - optional	`2`	The zero-based index of the column containing the last name.
`linkedin_url_field_index` integer - optional	`null`	The zero-based index of the column containing the LinkedIn URL.
`webhook_url` string - optional	`null`	URL to receive a webhook notification when processing completes.

Notes:

The type of email search performed depends on the fields you map:

Email Search by Name:
- map domain_field_index or company_name_field_index (domain_field_index is recommended for better accuracy).
- map full_name_field_index or first_name_field_index and last_name_field_index (full_name_field_index is recommended for better accuracy).
Email Search by Decision Maker:
- map domain_field_index or company_name_field_index (domain_field_index is recommended for better accuracy).
- specify a decision_maker_category.
Email Search by LinkedIn URL:
- map linkedin_url_field_index.
Email Search by Company:
- map domain_field_index or company_name_field_index (domain_field_index is recommended for better accuracy).
Email Verification:
- map email_field_index.

Response

200OK

The search has been successfully created and will process asynchronously.

If you specified a webhook URL, you will receive a notification when the search is completed.
Otherwise, use the Bulk Search Detail API endpoint to check the search status.

{
  "counts": {
    "failed": 0,
    "found_unknown": 0,
    "found_valid": 0,
    "not_found": 0,
    "total": 0
  },
  "created_at": "2025-01-08T13:25:36.457Z",
  "credits_needed": 0,
  "decision_maker_category": "string",
  "file_name": "string",
  "id": "string",
  "paid": true,
  "started_running_at": "2025-01-08T13:25:36.457Z",
  "status": "queued"
}

Property	Type	Description
`status`	string	The current status of the bulk search. Possible values: `on_deck`: Bulk file uploaded but columns not mapped yet (internal status). `queued`: Bulk search is queued and awaiting processing. `running`: Bulk search is currently being processed. `paused`: Bulk search processing is temporarily paused. `completed`: Bulk search processing is complete. `failed`: Bulk search processing failed due to an error.
`counts.failed`	integer	Number of rows where the search failed.
`counts.found_unknown`	integer	Number of rows with risky emails found.
`counts.found_valid`	integer	Number of rows with valid emails found.
`counts.not_found`	integer	Number of rows where no email was found.
`counts.total`	integer	Total number of rows in the search.
`created_at`	string	The datetime when the search was created.
`credits_needed`	integer	The maximum credits required to download the results. Duplicate searches within a month are not charged.
`decision_maker_category`	string \| null	The decision maker category specified during search creation (e.g., "ceo").
`file_name`	string	The label provided to identify this search.
`id`	string	Unique identifier for this bulk search.
`paid`	boolean	Indicates whether this search was paid for.
`started_running_at`	string \| null	The datetime when the search started processing.

400Bad Request

401Unauthorized

Need Help?

Our team is experienced with APIs and is here to help. Contact us via chat or email at team@anymailfinder.com.