Export result sets

Use the export service when you need a complete result set as a file instead of paginated API responses. The export service is asynchronous: you create a job, poll it, then download the file when it is complete.

Export service IDs are not fixed. Each environment assigns them when the catalog is seeded, so always call list_export_services first and use the id returned there. Match the service by stable fields such as name, alias, or slug.

When to use it

Use this flow for result sets that appear in the export catalog. The source guide tells you which result identifier to pass in args — for example a search ID, task ID, analysis ID, or another source-specific key. Do not use this for original leak source files. Those use the separate Download leak files flow and are limited to files under 10 MB. Also check the source guide for specialized export endpoints: Filtered credentials, monitoring matches, Telegram, and reports each document their own file flow.

Export a result set

List export services

list_export_services returns the export catalog.

curl https://client-api.leak.center/api/service/list_export_services/ \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Each entry carries the fields you need for the next step:

{
  "id": 12,
  "name": "StealerLogs",
  "alias": "stealer_logs",
  "slug": "stealer-logs",
  "is_active": true,
  "allowed_types": ["json", "csv", "xlsx"],
  "args": {
    "params": [
      {
        "name": "search_id",
        "type": "Int",
        "required": true,
        "description": "Stealer log search id to enrich and export"
      }
    ]
  }
}

Read allowed_types before choosing a format. Read args before creating the export; those parameters are different per service.

Create the export

create_export starts the job. Pass:

service — the service id from the catalog.
type — one of the service’s allowed_types, usually json, csv, or xlsx.
args — the service-specific arguments from the catalog.

curl https://client-api.leak.center/api/service/create_export/ \
  -X POST \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"service": 12, "type": "csv", "args": {"search_id": 4471}}'

The response includes the export id, service, type, status, created_at, and organization.

Poll until complete

get_export reads the job by query parameter id.

curl "https://client-api.leak.center/api/service/get_export/?id=9876" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Status moves through:

Status	Meaning
`IN_PROGRESS`	The file is still being prepared. Poll again.
`COMPLETE`	The file is ready to download.
`FAILED`	The export did not finish. Check the arguments and create a new job if needed.

Download

download_export returns the file once the job is COMPLETE.

curl -L "https://client-api.leak.center/api/service/download_export/?id=9876" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -OJ

List previous exports

list_exports returns your export jobs. Filter by status, type, services, from_date, and to_date.

curl "https://client-api.leak.center/api/service/list_exports/?status=COMPLETE&page_size=20" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Use this when you need to pick up an export created earlier, or when a workflow creates exports on behalf of several users in the same organization.

Common mistakes

Mistake	Fix
Hard-coding a service ID	Call `list_export_services` and match by `name`, `alias`, or `slug`.
Passing the wrong `args` key	Read the service’s `args` schema from the catalog. The export service does not guess source-specific parameters.
Calling `download_export` while the job is still running	Poll `get_export` until `status` is `COMPLETE`.
Exporting when you only need a few rows	Page the source results and keep the filtered rows you actually need.
Trying to export an original leak source file	Use Download leak files, and only for files under 10 MB.

Get started

Search

Leaked credentials

Assess & report

Monitor

Downloads & exports

Changelog

When to use it

Export a result set

List previous exports

Common mistakes

​When to use it

​Export a result set

​List previous exports

​Common mistakes

When to use it

Export a result set

List previous exports

Common mistakes