RIriveterhq
Dataset CRUD

list rows

Changed on

The dataset's rows in position order, each with its input values, its cells by output column name (value, state, sources), and the credits spent on it. Page with limit (max 1,000) and cursor; updated_since returns only rows changed since then.

Two parameters make a read small enough to take a whole dataset in a few calls: columns (comma-separated names) keeps only those columns in input and cells, and compact=true answers the values-only shape (CompactDatasetRow: position, input, cells as { "<column>": value }, a cell without a value null). A 1,000-row page of one column in that shape is a few tens of kilobytes. For counts over a column, GET /datasets/{id}/summary needs no rows at all.

get/datasets/{id}/rows

Request

  • Base URL
    https://api.riveterhq.com/v1
  • Auth
    HTTP bearer

Path parameters

idstring required

The dataset id (ds_...)

Query parameters

limitinteger
cursorinteger

The next_cursor of the previous page

updated_sincestring date-time

Only rows updated at or after this time (ISO 8601)

columnsstring

Column names, comma-separated (input or output columns; Company,CEO). Only those columns are answered. Absent: every column. An unknown name is a 400 that lists the dataset's columns.

compactboolean

true answers the values-only row shape: position, input, and cells as { "<column>": value } (no id, states, sources, credits, or timestamps).

Response

One page of rows

next_cursorinteger nullable

Pass back as cursor for the next page; null on the last page

row_countinteger

Example response

{
  "rows": [
    {
      "id": "row_018f6a70-aaaa-7abc-89ab-0123456789ab",
      "position": 1,
      "input": {
        "Company": "Apple",
        "Website": "apple.com"
      },
      "cells": {
        "CEO": {
          "value": "Tim Cook",
          "state": "ok",
          "sources": [
            "https://www.apple.com/leadership/"
          ]
        },
        "HQ city": {
          "value": null,
          "state": "pending"
        }
      },
      "credits": 1.2,
      "not_found_reason": null,
      "created_at": "2026-10-01T12:00:00Z",
      "updated_at": "2026-10-01T12:07:00Z"
    }
  ]
}

Changes

  • fac56b649559Revision changes
    • info

      api tag Dataset CRUD added

    • info

      api tag Datasets removed

  • dcb4d45ade1aRevision changes
    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status