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

# Dry-run a segment query (count only)

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

## Request

- Base URL: `https://hub.suprsend.com`
- URL: `https://hub.suprsend.com/v1/subscriber_list/~/dry_run/count/`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/suprsend/apis/suprsend-api/docs/v1/subscriber_list/~/dry_run/count/post.ts> (a function with typed inputs; its response is checked against the schema)

Return the total number of users a [Segment List](/docs/segment-lists) SQL query would match, without returning the rows. Use this when you only need to size the audience.

## Request body

- object
  - `query` string, required: The SQL query to count. Must return a `distinct_id` column and reference only the `users` and `events` tables.

## Response `200`

200

- object
  - `count` integer: Number of rows the query returns.

## Other responses

- `400`: 400

## Changes

- **2026-08-10** `a686fddb4e0c`: 1 breaking, 1 warning
  - added the new required request property `query`
  - removed the request property `query_text`
- **2026-07-26** `8bd2574bd2c3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/suprsend/apis/suprsend-api/changes/v1/subscriber_list/~/dry_run/count/post.md)

---

[API](https://skmtc.dev/suprsend/apis/suprsend-api.md) - [All operations](https://skmtc.dev/suprsend/apis/suprsend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/suprsend/apis/suprsend-api/revisions/9e64cbe802a5?raw)