Returns a sample of rows from a single table.
Equivalent to running
{table} | take {limit}. An unknown table name or any
execution failure returns 400 Bad Request with the reason in the problem detail.
Requires the Edx feature flag.
Request Headers
| Header | Value | Required | Description |
|---|---|---|---|
| ECI-ApiKey | string | Yes | Your API key. See Authentication. |
| Content-Type | application/json | Yes | All requests must specify JSON content type. |
Path Parameters
| Name | Description | Type | Required |
|---|---|---|---|
| table | Name of the table to preview; must be a queryable EDX table. | string | Required |
Query Parameters
| Name | Description | Type | Required |
|---|---|---|---|
| limit | Maximum number of rows to return. Defaults to 100 and is capped at 500. | integer (int32) | Optional |
Responses
200
Sample rows from the requested table.
The request succeeded and the response body contains the requested data.
Response Body Parameters
EdxQueryResultV202606
| Property | Description | Type | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| columns | EdxColumnV202606[] | ||||||||||
|
EdxColumnV202606 properties
|
|||||||||||
| queryTimeMs | integer (int64) | ||||||||||
| rowCount | integer (int32) | ||||||||||
| rows | Rows, each an array of cell values aligned positionally to EnergyCap.DTO.V202606.EdxQueryResultDto.Columns. | array[] | |||||||||
| truncated | True when results were capped and more rows exist. | boolean | |||||||||
Example Response
{ "columns": [
{ "dataType": "string", "name": "string"
}
], "queryTimeMs": 1, "rowCount": 1, "rows": [
[
{}
]
], "truncated": false
}
400
The table name is unknown or the preview failed; see the problem detail.
The request was malformed or contains invalid parameters. Check the request body and query parameters.
Response Body Parameters
ProblemDetails
| Property | Description | Type |
|---|---|---|
| detail | string | |
| instance | string | |
| status | integer (int32) | |
| title | string | |
| type | string |
Example Response
{ "detail": "string", "instance": "string", "status": 1, "title": "string", "type": "string"
}