Get a rotation's projected schedule
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Get, RequestUri = new Uri("https://api.roundrobinbot.eu/v1/rotations/example/schedule?from=2026-04-15T12%3A00%3A00Z&to=2026-04-15T12%3A00%3A00Z"), Headers = { { "Authorization", "Bearer <token>" }, },};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}package main
import ( "fmt" "net/http" "io")
func main() {
url := "https://api.roundrobinbot.eu/v1/rotations/example/schedule?from=2026-04-15T12%3A00%3A00Z&to=2026-04-15T12%3A00%3A00Z"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close() body, _ := io.ReadAll(res.Body)
fmt.Println(res) fmt.Println(string(body))
}OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder() .url("https://api.roundrobinbot.eu/v1/rotations/example/schedule?from=2026-04-15T12%3A00%3A00Z&to=2026-04-15T12%3A00%3A00Z") .get() .addHeader("Authorization", "Bearer <token>") .build();
Response response = client.newCall(request).execute();import axios from 'axios';
const options = { method: 'GET', url: 'https://api.roundrobinbot.eu/v1/rotations/example/schedule', params: {from: '2026-04-15T12:00:00Z', to: '2026-04-15T12:00:00Z'}, headers: {Authorization: 'Bearer <token>'}};
try { const { data } = await axios.request(options); console.log(data);} catch (error) { console.error(error);}const url = 'https://api.roundrobinbot.eu/v1/rotations/example/schedule?from=2026-04-15T12%3A00%3A00Z&to=2026-04-15T12%3A00%3A00Z';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.roundrobinbot.eu/v1/rotations/example/schedule?from=2026-04-15T12%3A00%3A00Z&to=2026-04-15T12%3A00%3A00Z' \ --header 'Authorization: Bearer <token>'The shifts the rotation’s rules produce inside a window you name. from and to are both required and no more than 90 days apart. No ETag: the answer is computed forward from the rules and the clock, so no stored version stands behind it.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Query Parameters
Section titled “Query Parameters”Responses
Section titled “Responses”OK
The envelope every /v1 collection comes back in.
object
One shift in a rotation’s projected schedule.
object
Which place in the grid this shift fills, and the lane and window that cross there.
When it ends, or null for a shift with no computed end (a manual rotation waiting to be advanced by hand).
The list this shift was dealt from, where the grid names one.
Members the plan would otherwise have named, passed over because they were absent. The userId above is who holds the shift instead.
A member skipped because of an absence at assignment time.
object
Absence start in UTC, when known.
Absence source: googleCalendar or internalAvailability. Null when the source is unknown.
Absence end in UTC, when known.
Slack user ID of the skipped member.
Either scheduled, when the rotation’s own rules produced this shift, or manual, when somebody put a person on it by hand. There is no third value.
When the shift starts.
Their position in the turn order of the list this shift was dealt from.
The Slack user id of whoever actually holds the shift.
Examplegenerated
{ "data": [ { "cellId": "example", "end": "2026-04-15T12:00:00Z", "laneId": "example", "laneName": "example", "rosterId": "example", "skippedForAbsence": [ { "from": "2026-04-15T12:00:00Z", "source": "example", "until": "2026-04-15T12:00:00Z", "userId": "example" } ], "source": "example", "start": "2026-04-15T12:00:00Z", "turn": 1, "userId": "example", "windowId": "example", "windowName": "example" } ], "page": 1, "pageSize": 1, "totalItems": 1, "totalPages": 1}Bad Request
object
Examplegenerated
{ "detail": "example", "instance": "example", "status": 1, "title": "example", "type": "example"}Unauthorized
object
Examplegenerated
{ "detail": "example", "instance": "example", "status": 1, "title": "example", "type": "example"}Forbidden
object
Examplegenerated
{ "detail": "example", "instance": "example", "status": 1, "title": "example", "type": "example"}Not Found
object
Examplegenerated
{ "detail": "example", "instance": "example", "status": 1, "title": "example", "type": "example"}