---
title: "Table Query"
method: POST
path: "/table/query"
tags: ["Tables"]
---

# Table Query

`POST /table/query`

## Request body

- TableQueryReq
  - `project_id` string, required — The ID of the project
  - `digest` string, required — The digest of the table to query
  - `filter` TableRowFilter
    - `row_digests` string[], nullable — List of row digests to filter by
  - `limit` integer, nullable — Maximum number of rows to return
  - `offset` integer, nullable — Number of rows to skip before starting to return rows
  - `sort_by` SortBy[], nullable — List of fields to sort by. Fields can be dot-separated to access dictionary values. No sorting uses the default table order (insertion order).
    - `field` string, required
    - `direction` 'asc' | 'desc', required

## Response `200`

Successful Response

- TableQueryRes
  - `rows` TableRowSchema[], required
    - `digest` string, required
    - `val` unknown, required
    - `original_index` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/wandb/apis/fastapi.md) · [All operations](https://skmtc.net/wandb/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wandb/fastapi/versions/56745769989b/schema)