Passa al contenuto principale

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​

Responses​

Successful Response