ListRowsBody

Body for List Rows. All fields optional. **Filtering** (browse mode only — `filters` / `status_filters` / `created_at` cannot combine with `row_ids`; the server returns 400 if you mix them): - `filters[]` — value filters on **sheet input columns**. Each entry: `{ variable, operator, values }`. `variable` is an `{{input.<column>}}` reference token. - `status_filters[]` — per-action cell-status filters. Each entry: `{ action_instance_id, is?, is_not? }` (exactly one of `is` / `is_not`). - `created_at` — single time filter on the row's creation timestamp. `{ operator, values }`.

Properties

row_idsarray of

Filter to specific rows. Omit to return all rows on the sheet (paginated). Max 200 IDs per call — if you have more than 200 to poll, chunk your IDs across multiple calls. Mutually exclusive with `filters` / `status_filters` / `created_at`.

string <uuid>

page_nointegermin 1

Page number (1-indexed). Only meaningful when browsing (no `row_ids`) or when `row_ids` count exceeds `page_size`.

page_sizeintegermin 1 · max 200

Rows per page. Defaults to 20. Maximum 200.

filtersarray of

Value filters on sheet input columns. Each entry has `variable` (an `{{input.<column>}}` reference), `operator` (one of `is equal to`, `not equal to`, `is empty`, `not empty`, `contains`, `does not contain`, `contains any of`, `not contains any of`, `greater than`, `less than`), and `values` (array of strings — single value for most operators; multiple for `contains any of` / `not contains any of`; empty for `is empty` / `not empty`).

variablestringrequired

Public reference token for the input column to filter on. Must match `{{input.<column>}}`.

operatorstringrequired

Comparison operator. See the description above for the full list.

valuesarray of

Values to compare against. Single-value operators take one item; `contains any of` / `not contains any of` take one or more; `is empty` / `not empty` ignore values.

string

status_filtersarray of

Per-action cell-status filters. Each entry specifies an `action_instance_id` and exactly one of `is` (status matches one of) or `is_not` (status matches none of). Status values use the public vocabulary (`queued | running | complete | failed | error | condition_not_met`).

action_instance_idstringrequired

Action instance ID (public form) whose per-row cell status to filter on.

isarray of

Match rows whose cell on this action is in one of these statuses.

string

is_notarray of

Match rows whose cell on this action is NOT in any of these statuses.

string

created_atobject

Filter rows by creation timestamp. `operator` is one of `equals to`, `greater than`, `greater than or equals to`, `less than`, `less than or equals to`, `is between`. `values` is `[ISO timestamp]` for single-value operators or `[start, end]` for `is between`.

operatorstringrequired

valuesarray ofrequired

string

Example

ListRowsBody example

{
  "row_ids": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "page_no": 0,
  "page_size": 0,
  "filters": [
    {
      "variable": "{{input.email}}",
      "operator": "contains",
      "values": [
        ".com"
      ]
    }
  ],
  "status_filters": [
    {
      "action_instance_id": "enrich_company_linkedin_profile_1",
      "is": [
        "complete"
      ],
      "is_not": [
        "failed",
        "error"
      ]
    }
  ],
  "created_at": {
    "operator": "greater than",
    "values": [
      "2026-05-07T22:14:00Z"
    ]
  }
}