Skip to main content

Get records

GET 
/api/v1/orgs/:orgID/datasets/:datasetID/records

Retrieve records from a dataset with optional time window filtering and sort direction.

Filtering:

  • Use createdAfter / createdBefore to filter by creation time window
  • Use updatedAfter / updatedBefore to filter by update time window
  • Created and updated filters are mutually exclusive groups

Sort direction:

  • Use sortDirection to control ordering (asc or desc, default asc)

Pagination:

  • Results are paginated with a default limit of 100 records
  • Maximum limit is 1000 records per request
  • The response includes an opaque cursor in metadata for fetching the next page
  • Pass the cursor value as-is to retrieve the next page; do not combine with time filters or sortDirection

Response formats:

  • json (default) returns structured records with pagination metadata
  • csv returns a downloadable CSV with column headers for configured dataset fields

Request​

Responses​

Records retrieved successfully (JSON response)