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

# Table Query

`POST /table/query`

## Request

- Base URL: `https://trace.wandb.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://trace.wandb.ai/table/query`
- Auth: none declared

## 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

## Changes

- **2026-10-16** `dd89fadfe4e4`: 3 info
  - the endpoint scheme security `HTTPBasic` was removed from the API
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/changes/table/query/post.md)

---

[API](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api.md) - [All operations](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/revisions/f7643c49bf2e?raw)