---
title: "Preview Criteria"
method: POST
path: "/api/v1/lists/preview-criteria"
tags: ["lists"]
---

# Preview Criteria

`POST /api/v1/lists/preview-criteria`

Compile a natural-language audience into criteria + a live match count.

## Request body

- CriteriaPreviewRequest — Natural-language description to compile into criteria.
  - `description` string, required

## Response `200`

Successful Response

- CriteriaPreviewResult — Compiled criteria + a human summary + how many contacts match now.
  - `criteria` Criteria, required — A versioned dynamic-list definition.
    - `version` integer
    - `match` 'all' | 'any'
    - `clauses` Clause[]
      - `field` string, required
      - `op` 'eq' | 'neq' | 'in' | 'gte' | 'lte' | 'is_true' | 'is_false', required
      - `value` union
        - string
        - integer
        - number
        - boolean
        - union[]
          - union
            - string
            - integer
            - number
            - boolean
    - `last_interaction_within_days` integer, nullable
    - `arriving_within_hours` integer, nullable
    - `in_house` boolean, nullable
    - `property_ids` string[], nullable
  - `summary` string, required
  - `match_count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getanana/cleon-api/revisions/c0f54348e251/schema)