Unlocked Leaks

Export your unlocked leaks to CSV/TXT/JSON (advanced filters)

Changed on

Queue an export of your unlocked leaks filtered by the same fields supported by LeakSearchFilters. Provide advanced filters in the JSON request body. The job runs asynchronously and the file will appear in the Exports section when ready.

Request body

  • JSON payload following the LeakSearchFilters schema.
  • The four scope fields below may also be sent as keys of this same flat body. A value given in the query string wins over the body one.

Scope, as query parameters or body keys

  • unlocked_at_min optional ISO 8601 timestamp with timezone to include items unlocked at or after this instant.
  • list_id optional list id filter.
  • list_none optional boolean to only include leaks without list.
  • status optional remediation status: new, in_progress, fixed or accepted_risk. Omit it to export every status.
  • format optional output format: csv (default), txt, or json.

Limits

  • At least one advanced filter is required.
  • You can have at most 5 exports with status PENDING or IN_PROGRESS.

Response ExportResponse with status, message, and export_id.

post/profile/unlocked/advanced/export

Request

Query parameters

list_idinteger nullable

Filter by list id

list_noneboolean nullable

Only leaks without list

status'new' | 'in_progress' | 'fixed' | 'accepted_risk' nullable

Remediation status filter. Omit to export every status.

format'csv' | 'txt' | 'json'

Output format: csv (default), txt, or json.

unlocked_at_minstring date-time nullable

Only include items unlocked at or after this ISO 8601 timestamp (with timezone).

Request body

usernamestring[] nullable

Username values to match.

username_notstring[] nullable

Username values to exclude.

username_match_type'contains' | 'starts_with' | 'ends_with'
username_not_match_type'contains' | 'starts_with' | 'ends_with'
passwordstring[] nullable

Password values to match.

password_notstring[] nullable

Password values to exclude.

password_match_type'contains' | 'starts_with' | 'ends_with'
password_not_match_type'contains' | 'starts_with' | 'ends_with'
urlstring[] nullable

URL values to match.

url_notstring[] nullable

URL values to exclude.

url_match_type'contains' | 'starts_with' | 'ends_with'
url_not_match_type'contains' | 'starts_with' | 'ends_with'
url_domainstring[] nullable

URL domain values to match.

url_domain_notstring[] nullable

URL domain values to exclude.

url_domain_match_type'contains' | 'starts_with' | 'ends_with'
url_domain_not_match_type'contains' | 'starts_with' | 'ends_with'
url_hoststring[] nullable

URL host values to match.

url_host_notstring[] nullable

URL host values to exclude.

url_host_match_type'contains' | 'starts_with' | 'ends_with'
url_host_not_match_type'contains' | 'starts_with' | 'ends_with'
username_hashstring[] nullable

Username SHA-1 hash prefix (hex).

password_hashstring[] nullable

Password SHA-1 hash prefix (hex).

url_schemestring[] nullable

URL scheme(s) to include (multi).

url_scheme_notstring[] nullable

URL scheme(s) to exclude (multi).

url_portinteger[] nullable

URL port(s) to include (multi).

url_port_notinteger[] nullable

URL port(s) to exclude (multi).

url_tldstring[] nullable

URL TLD(s) to include (multi).

url_tld_notstring[] nullable

URL TLD(s) to exclude (multi).

is_emailboolean nullable

Identifier type filter: true=email only, false=username only, null=both.

email_domainstring[] nullable

Email domain values to match.

email_domain_notstring[] nullable

Email domain values to exclude.

email_domain_match_type'contains' | 'starts_with' | 'ends_with'
email_domain_not_match_type'contains' | 'starts_with' | 'ends_with'
email_hoststring[] nullable

Email host values to match.

email_host_notstring[] nullable

Email host values to exclude.

email_host_match_type'contains' | 'starts_with' | 'ends_with'
email_host_not_match_type'contains' | 'starts_with' | 'ends_with'
email_tldstring[] nullable

Email TLD(s) to include (multi).

email_tld_notstring[] nullable

Email TLD(s) to exclude (multi).

password_strength'too_weak' | 'weak' | 'medium' | 'strong'
added_fromstring date-time nullable

Only include leaks indexed on/after this UTC datetime.

added_tostring date-time nullable

Only include leaks indexed on/before this UTC datetime.

force_andboolean nullable

When true, require all values within each field (AND within field).

unlocked_at_minstring date-time nullable

Only items unlocked at or after this instant. Needs a timezone.

list_idinteger nullable

Filter by list id.

list_noneboolean nullable

Only items that belong to no list.

status'new' | 'in_progress' | 'fixed' | 'accepted_risk' nullable

Remediation status filter. Omit to export every status.

Example request

{
  "password": [
    "123456"
  ],
  "url_domain": [
    "example.com"
  ]
}

Response

Export queued successfully.

statusstring required

Export job status: 'queued', 'processing', 'completed', or 'failed'.

messagestring required

Human-readable status message.

export_idinteger required

ID of the export job. Use this to check status or download the result.

Example response

{
  "export_id": 1234,
  "message": "Your export request has been queued. Check the Exports page for progress.",
  "status": "queued"
}

Changes

    • breaking

      for the query request parameter list_none, default value false was removed

    • info

      added the new optional query request parameter status

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      endpoint added