---
title: "List rows"
method: POST
path: "/public/v1/objects/{name}/rows/list"
tags: ["Object rows"]
---

# List rows

`POST /public/v1/objects/{name}/rows/list`

Returns a paginated, filterable list of rows.

## Path parameters

- `name` string, required

## Request body

- object
  - `query` object — Dynamic-table query. Either a single `{ path, operator, value }` condition, or a nested group `{ operator: 'and' | 'or', conditions: [...] }`.
  - `search` string, nullable
  - `sort` object[], nullable
  - `record_type` union
    - string
    - number
    - union[]
      - union
        - string
        - number
    - object, nullable
  - `page` integer
  - `page_size` integer

## Response `200`

Rows page

- object
  - `ok` true, required
  - `data` object, required
    - `rows` object[], required
      - `id` string
      - `auto_id` number
      - `created_at` string, nullable
      - `updated_at` string, nullable
    - `total_count` number, required
    - `total_pages` number, required
    - `current_page` number, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

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