---
title: "Queue a Combolist search export"
method: POST
path: "/search/combolist/export"
tags: ["Search Combolists"]
---

# Queue a Combolist search export

`POST /search/combolist/export`

Export every Combolist pair matching a search scope, as a background job.

**Scope**
Same body as `POST /search/combolist/unlock/task`: `scope` is one of `email`, `username`, `domain` or `advanced`, with `value` for the first three and `filters` for the last.

**What the file contains**
On a normal plan the export contains **only the pairs you have already unlocked** inside that scope, never the locked ones. To export a full result set, queue `POST /search/combolist/unlock/task` first and wait for it to finish. Plans that never spend points (Unlimited) get every matching pair directly.

**Limits**
- Formats: `csv`, `txt`, `json`.
- At most 5 exports pending or in progress per account, all types combined.
- An identical export already queued is refused rather than duplicated.

**Retrieval**
The response carries an `export_id`. Follow it and download the file from the Exports endpoints.

## Query parameters

- `format` 'csv' | 'txt' | 'json'

## Request body

- CombolistScopedRequest — Stable search contract persisted by Combo unlock/export jobs.
  - `scope` 'email' | 'username' | 'domain' | 'advanced', required — Which search the job replays: `email`, `username` and `domain` take `value`, `advanced` takes `filters`.
  - `value` string, nullable — Exact email, username or root email domain, per `scope`.
  - `search` string, nullable — Optional filter on username or password, applied on top of `value`. Not allowed on the advanced scope.
  - `filters` CombolistAdvancedSearchRequest — Combolist filters. Text is literal; only match_type adds operators. Characters such as *, ? and backslash are searched as written.
    - `username` string[], nullable
    - `username_not` string[], nullable
    - `username_match_type` 'contains' | 'starts_with' | 'ends_with'
    - `username_not_match_type` 'contains' | 'starts_with' | 'ends_with'
    - `password` string[], nullable
    - `password_not` string[], nullable
    - `password_match_type` 'contains' | 'starts_with' | 'ends_with'
    - `password_not_match_type` 'contains' | 'starts_with' | 'ends_with'
    - `email_domain` string[], nullable
    - `email_domain_not` string[], nullable
    - `email_domain_match_type` 'contains' | 'starts_with' | 'ends_with'
    - `email_domain_not_match_type` 'contains' | 'starts_with' | 'ends_with'
    - `username_hash` string[], nullable
    - `password_hash` string[], nullable
    - `is_email` boolean, nullable
    - `password_strength` 'too_weak' | 'weak' | 'medium' | 'strong'
    - `added_from` string, date-time, nullable
    - `added_to` string, date-time, nullable
    - `force_and` boolean

## Response `200`

Export queued.

- ExportResponse
  - `status` string, required — Export job status: 'queued', 'processing', 'completed', or 'failed'.
  - `message` string, required — Human-readable status message.
  - `export_id` integer, required — ID of the export job. Use this to check status or download the result.

## Other responses

- `400` — Too many exports already in progress.
- `401` — Authentication required, or invalid/expired API key.
- `403` — The Combolists dataset is not on your plan for this scope, or the search is blocked by one of your blacklist rules.
- `404` — Combolist search is not enabled on this deployment.
- `409` — An identical export is already queued.
- `422` — Validation error.
- `429` — Rate limit exceeded. See Retry-After / X-RateLimit-* headers.
- `503` — Combolist search under maintenance, or public API temporarily disabled.

## Changes

- **2026-09-04** `eb219e94d077` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/leakradar/apis/leakradar-io-api/changes/search/combolist/export/post.md)

---

[API](https://skmtc.dev/leakradar/apis/leakradar-io-api.md) · [All operations](https://skmtc.dev/leakradar/apis/leakradar-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/leakradar/apis/leakradar-io-api/revisions/99aaaa4fbeb1?raw)