<- Object

Object

All versions ->

ScheduledShiftFilterBeta

Multiple filters in a query are combined as an AND operation.

Link to section

Properties

Link to section

location_ids

string [ ]

Return shifts for the specified locations. When omitted, shifts for all locations are returned. If needed, call ListLocations to get location IDs.

Link to section

start

Return shifts whose start_at time is within the specified time range (inclusive).

Link to section

end

Return shifts whose end_at time is within the specified time range (inclusive).

Link to section

workday

Return shifts based on a workday date range.

Link to section

team_member_ids

string [ ]

Return shifts assigned to specified team members. If needed, call SearchTeamMembers to get team member IDs.

To return only the shifts assigned to the specified team members, include the assignment_status filter in the query. Otherwise, all unassigned shifts are returned along with shifts assigned to the specified team members.

Link to section

assignment_status

string

Return shifts based on whether a team member is assigned. A shift is assigned if the team_member_id field is populated in the draft_shift_details or published_shift details field of the shift.

To return only draft or published shifts, include the scheduled_shift_statuses filter in the query.

Link to section

scheduled_shift_statuses

Return shifts based on the draft or published status of the shift. A shift is published if the published_shift_details field is present.

Note that shifts with draft_shift_details.is_deleted set to true are ignored with the DRAFT filter.