Skip to main content
POST
/
datasets
/
{dataset_id}
/
rows:lookup
Look Up Dataset Rows
curl --request POST \
  --url https://api.woodwide.ai/datasets/{dataset_id}/rows:lookup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    0,
    3,
    17
  ]
}
'
{
  "headers": [
    "id",
    "feature_a",
    "feature_b",
    "label"
  ],
  "rows": [
    {
      "id": 0,
      "feature_a": 1.2,
      "feature_b": "A",
      "label": 0
    },
    {
      "id": 3,
      "feature_a": 2.1,
      "feature_b": "C",
      "label": 1
    },
    {
      "id": 17,
      "feature_a": 0.5,
      "feature_b": "D",
      "label": 0
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

dataset_id
string<uuid>
required

Body

application/json

Look up specific rows by their id column value.

Every dataset includes a 0-based id column assigned at ingest. Pass 1--256 integer IDs; duplicates are removed.

ids
integer[]
required

Row ids to fetch. Duplicates are de-duplicated.

Required array length: 1 - 256 elements

Response

Successful Response

Rows matching a DatasetRowsLookupRequest.

Returned rows follow the request ids order (duplicates removed). IDs not present in the dataset are omitted -- reconcile against the request to detect missing IDs.

headers
string[]
required

Column names.

rows
Rows · object[]
required

Found rows as {column: value} dicts, ordered to match the request.