Skip to main content
GET
/
v1
/
shifts
List shifts
curl --request GET \
  --url https://api.rootly.com/v1/shifts \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "47c82c7a-c99b-4537-bc20-bb6f4c2f356b",
      "type": "shifts",
      "attributes": {
        "schedule_id": "a893bac4-5ffc-4ccb-bf44-6af7ec6cab11",
        "rotation_id": "c67ded5e-9120-4220-bdef-64c20884e1b5",
        "user_id": 1102,
        "starts_at": "2024-07-02T21:00:00.000-07:00",
        "ends_at": "2024-07-02T23:00:00.000-07:00",
        "is_override": true
      },
      "relationships": {
        "shift_override": {
          "data": null
        },
        "user": {
          "data": {
            "id": "1102",
            "type": "users"
          }
        }
      }
    },
    {
      "id": "e3b7e2ed-afde-55e6-b17e-82c0fd61fa1a",
      "type": "shifts",
      "attributes": {
        "schedule_id": "a893bac4-5ffc-4ccb-bf44-6af7ec6cab11",
        "rotation_id": "6ede2fa0-67f2-470e-ad6a-1fbe06a9369b",
        "user_id": 1102,
        "starts_at": "2024-07-02T19:00:00.000-07:00",
        "ends_at": "2024-07-02T21:00:00.000-07:00",
        "is_override": false
      },
      "relationships": {
        "shift_override": {
          "data": null
        },
        "user": {
          "data": {
            "id": "1102",
            "type": "users"
          }
        }
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
include
enum<string>

comma separated if needed. eg: shift_override,user. Note: user is deprecated, use assignee instead.

Available options:
shift_override,
user,
assignee
​
from
string

Start range for shifts in ISO-8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01T00:00:00+00:00)

​
to
string

End range for shifts in ISO-8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01T00:00:00+00:00)

​
user_ids[]
integer[]
​
schedule_ids[]
string[]

Response

success

​
data
object[]
required