Skip to main content
POST
Export chosen leads

Authorizations

Authorization
string
header
required

A ManyPI API key (mpi_...) from the profile menu → API Access in the dashboard, or an OAuth 2.1 access token obtained through the MCP consent flow.

Body

application/json
ids
string<uuid>[]

Export exactly these leads.

Maximum array length: 10000
status
string

A lifecycle status.

q
string
campaign
string<uuid>

The run id of a lead search: the run_id that POST /api/leads/research returns, or the id of any agent run that saved leads. Returns only the leads that search saved. A malformed id is ignored, so the request then returns every lead.

brand
string

Narrow to one brand by its id. Leads with no brand are always included.

subscribed
enum<string>

Opt-out state, separate from status.

Available options:
subscribed,
unsubscribed
archived
enum<string>
default:hide

hide leaves archived leads out, show includes them, only returns nothing else.

Available options:
hide,
show,
only
owner
string

unassigned, or a workspace member's user id.

list
string<uuid>

Only the leads in this lead list.

import
string<uuid>

Only the leads one import created (import_id from POST /api/leads/import).

missing
string

Comma-separated keys, at most 20. Only leads where at least one of these core or custom fields is empty.

one_per_company
enum<string>

Keep only the best-ranked contact at each company. Leads with no company are always kept.

Available options:
true,
1
format
enum<string>
default:csv
Available options:
csv,
tsv,
json,
txt
columns
string

Comma-separated columns to include, from: company, full_name, title, email, phone, phone_e164, phone_type, phone_status, domain, category, subcategory, linkedin_url, location, source_url, score, status, email_provider, email_status, email_is_role, email_validated_at, unsubscribed_at, created_at. Leave it out for all of them.

Response

CSV file.

The response is of type string.