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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

The ID of a cursor

string

Offset into the result set for the page to begin at

string

The number of rows to return in the page

Headers
string
enum
Defaults to application/x-ndjson

Generated from available response content types

Allowed:
Responses

400

Invalid request.

Language
Credentials
Bearer
Authorization: Bearer <customerid> <apitoken>
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/x-ndjson
text/csv
*/*