Get a cover request
GET
/v1/rotations/{rotationId}/cover-requests/{requestId}
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/cover-requests/example"), 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/cover-requests/example"
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/cover-requests/example") .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/cover-requests/example', 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/cover-requests/example';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/cover-requests/example \ --header 'Authorization: Bearer <token>'Requires read:oncall and a key whose workspace and rotation selector permit this rotation. Returns the request, read-only action capabilities and rotation ETag. Closed requests remain readable. An inaccessible request returns 404.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”rotationId
required
string
requestId
required
string
Responses
Section titled “Responses”OK
Media typeapplication/json
A permitted cover request, its rotation name and caller-specific capabilities.
object
request
required
Requested interval, selected audience and current cover lifecycle state.
object
id
required
string
rotationId
required
string
cellId
required
string
requesterUserId
required
string
recipientUserIds
required
Array<string>
declinedUserIds
required
Array<string>
from
required
string format: date-time
to
required
string format: date-time
reason
required
string
revision
required
integer | string format: int64
state
required
string
acceptedUserId
required
null | string
arrangementId
required
null | string
capability
required
Actions currently permitted for this caller. Mutations recheck these permissions.
object
canAccept
required
boolean
canDecline
required
boolean
canCancel
required
boolean
canEnd
required
boolean
reason
required
null | string
rotationName
required
string
Examplegenerated
{ "request": { "id": "example", "rotationId": "example", "cellId": "example", "requesterUserId": "example", "recipientUserIds": [ "example" ], "declinedUserIds": [ "example" ], "from": "2026-04-15T12:00:00Z", "to": "2026-04-15T12:00:00Z", "reason": "example", "revision": 1, "state": "example", "acceptedUserId": "example", "arrangementId": "example" }, "capability": { "canAccept": true, "canDecline": true, "canCancel": true, "canEnd": true, "reason": "example" }, "rotationName": "example"}