---
title: "Dry-run a segment query (sample rows)"
method: POST
path: "/v1/subscriber_list/~/dry_run/"
---

# Dry-run a segment query (sample rows)

`POST /v1/subscriber_list/~/dry_run/`

Preview the rows a [Segment List](/docs/segment-lists) SQL query would match, without committing it to a list. Returns up to the top 10 matched rows for the columns selected. Use this to spot-check a query before creating a Segment List or committing a new version.

## Request body

- object
  - `query_text` string, required — The SQL query to preview. Must return a `distinct_id` column and reference only the `users` and `events` tables. See the [Segment Lists doc](/docs/segment-lists) for the dialect, available columns, and query rules.

## Response `200`

200

- object
  - `data` object[] — Up to the top 10 matched rows, each containing `distinct_id` and any additional columns you selected.
    - `distinct_id` string — The user identifier.

## Other responses

- `400` — 400

---

[API](https://skmtc.net/suprsend/apis/suprsend-api.md) · [All operations](https://skmtc.net/suprsend/apis/suprsend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/suprsend/suprsend-api/versions/8bd2574bd2c3/schema)