Grava Docs

List dataset rows

GET/v1/datasets/{datasetId}/rows

Lists current rows ordered by updatedAt descending, then id descending. This is a current-state view. Use the changes endpoint for durable history. Repeat the status parameter to include multiple statuses.

AuthorizationBearer <token>

API key shown once at creation and stored as a SHA-256 hash.

In: header

Path Parameters

datasetId*string

Dataset UUID.

Formatuuid

Query Parameters

since?string

Include rows updated at or after this instant.

Formatdate-time
status?array<>

Row status to include. May be repeated.

cursor?string

Opaque cursor returned as nextCursor by the previous page.

limit?integer

Maximum rows to return.

Range1 <= value <= 500
Default100

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/datasets/497f6eca-6276-4993-bfeb-53cbbbba6f08/rows"
{  "data": [    {      "identity": {        "version": 1,        "key": "string",        "kind": "company",        "anchor": "string",        "aliases": [          "string"        ]      },      "revisionId": "bae12d01-48af-47b3-9304-b09ef0081cd6",      "presence": "present",      "missingReasons": {        "property1": "unknown",        "property2": "unknown"      },      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "rowKey": "string",      "data": {        "property1": "string",        "property2": "string"      },      "status": "new",      "firstSeenRunId": "9a1d3c76-8da0-464a-bffa-dd5dc15b04ba",      "lastSeenRunId": "5f6867a2-7ecb-43a3-b039-cec14ba14445",      "sourceUrl": "http://example.com",      "observedAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    }  ],  "nextCursor": "string"}