# listRows

## HTTP Request

```http
GET /api/v1/queries/:queryId/rows
```

## Path parameters

| Parameter |                     |
| --------- | ------------------- |
| queryId   | The id of the query |

## Query parameters

| Parameter  |                                                                                                         |
| ---------- | ------------------------------------------------------------------------------------------------------- |
| format     | The response format. Either `csv` , `jsonl`, or `arrow`. Defaults to `jsonl` for the JSON-lines format. |
| maxResults | Optional. Maximum number of rows to return. Defaults to 100 if not specified.                           |

{% hint style="info" %}
This endpoint extends the [general API structure](https://docs.redivis.com/api/rest-api/general-structure).
{% endhint %}

## Authorization

Data access to the all tables referenced by the query is required. If a table's data is not public, your access token must have one of the following scopes:

* data.data
* data.edit

[Learn more about authorization.](https://docs.redivis.com/api/rest-api/authorization)

## Request body

The request body must be empty.

## Response body

The response body follows the [table.listRows specification](https://docs.redivis.com/api/tables/listrows#response-body).