Skip to main content
Version: Next

Read query results (I/O API)

This endpoint reads the next batch of records for a query ID produced by POST /api/v1/io/:bucket_name/q. The query ID must be sent in the x-reduct-query-id request header.

The response uses Batch Protocol v2. See the Batch protocol v2 section for details.

GET
/api/v1/io/:bucket_name/read
Read the next batch of records for a query id

Response headers​

  • x-reduct-entries: comma-separated, percent-encoded entry names (index == position).
  • x-reduct-start-ts: the start timestamp for the batch (microseconds); record timestamp is start + delta.
  • x-reduct-labels (optional): comma-separated, percent-encoded label names (index == position).
  • x-reduct-<ENTRY-INDEX>-<TIME-DELTA-uS>: record metadata for each returned record (see Batch Protocol v2).
  • x-reduct-last: true if the returned batch includes the last record in the query; otherwise false.

The response body is the concatenation of record bodies in the same order as the per-record headers.