List route reading rounds
LogsGET /reading-rounds
Returns a cursor-paginated page of reading rounds, each being one scheduled pass over a route for a cycle, with its status and the times it was opened, completed or cancelled. Use limit (default 20, maximum 100) and after to page. Requires business:reading-rounds:read.
Parameters
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
route_idReturns only rounds that walk this reading route ID.
cycle_idReturns only rounds that belong to this reading cycle ID.
statusReturns only rounds in this status: planned, open, in_progress, completed or cancelled; any other value returns 400.
one of
planned,open,in_progress,completed,cancelled
Returns
200 Filtered reading rounds
Permissions business:reading-rounds:read · Roles: admin, analyst, field_reader, field_supervisor, operations, owner
curl -X GET "$BUSINESS_API/reading-rounds" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$BUSINESS_API/reading-rounds", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/reading-rounds",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/reading-rounds", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
Filtered reading rounds