Fetch a page of query results

Fetch the results of a paginated "/v1/meta/export/query" request.

Note that paginate must be set to true and rowCount should be set high enough to contain the total expected result set.

This endpoint uses long polling behavior. If a query is in progress when a request is made, the server will delay responding for up to 30 seconds. If the query completes in that time period, the results will be returned with a 200 response code. Otherwise a 202 response code will be returned, and the client should retry the request. The endpoint will also return an error if the query failed.

Queries for paginated data will return an X-Observe-Total-Rows header and an X-Observe-Next-Page header with a URL for the next page, as long as one is needed. You can use the X-Observe-Cursor-Id and the offset and numRows parameters to construct your own next page URL with different page sizes.

The results can be returned as CSV or NDJSON. The query parameters are used to specify which page of results to fetch.

  • Set Accept header to text/csv or application/x-ndjson
  • Default: CSV

The number of rows in the full result set is returned in the X-Observe-Total-Rows response header.

Language
Credentials
Bearer
Authorization: Bearer <customerid> <apitoken>
URL
Click Try It! to start a request and see the response here!