# Read Refreshes

```
GET 
/v1/refreshes
```

List the account's refresh schedules.

`datasetId` and `projectId` are ADDITIVE optional filters (2026-09-18). A schedule targets exactly one of the two, so naming both can only ever match nothing — the filters AND, and that is the honest answer rather than a 422 for a query that is merely empty.

They exist because the only way to answer "when does THIS dashboard's data refresh?" used to be draining every schedule on the account and filtering in the browser. The dashboard freshness card asks per dataset and per project; the server is where that filter belongs.

Cursor-paginated. The wire query parameter is `exclusiveStartKey` (what the cURL tab and the parameter table show); the TypeScript SDK takes it as the `exclusiveStartKey` option and the Python SDK as the `exclusive_start_key` keyword — one parameter, spelled per language. Pass the previous page's `nextKey` and stop when it comes back `null` — or let `iterAll()` / `iter_all()` drive the cursor for you (see the SDKs page, "Pagination").

## Request[​](#request "Link diretto a request")

## Responses[​](#responses "Link diretto a Responses")

* 200
* 404
* 422

Successful Response

Not found

Validation Error