List shifts in a date range (up to 62 days). Shift planners see every shift in the departments they may see; other members see shifts they lead or work on
GET
https://app.softsolz.uk/api/v1/services/tasks/shiftsRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Headers
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Query Params
fromstringStart of the range.
tostringEnd of the range.
org_unit_idintegerOne department.
statusstringplanned, open, closed, cancelled
minestringSend 1 for the shifts of the connected member only.
limitintegerHow many to return, from 1 to 200. Defaults to 50.
offsetintegerHow many to skip, for paging. Defaults to 0.
Response
Response Body · array of objects
idintegerShift id.namestringShift name.org_unitobject | nullDepartment or location, or null when there is none.starts_atstring | nullWhen the shift starts.ends_atstring | nullWhen the shift ends.statusstringWhere the shift is.leadobject | nullMember who leads the shift, or null.membersarray of objectsPeople on the shift.open_countintegerOpen work on this shift the caller can see.handover_statusstring | nullwaiting or acknowledged once the shift is closed, otherwise null.Request
curl --request GET \ --url https://app.softsolz.uk/api/v1/services/tasks/shifts \ --header 'Authorization: Bearer sk_live_your_key'Credentials
Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.
Response · 200
{ "data": [ { "id": 7, "name": "Morning", "org_unit": { "id": 1, "name": "your-name" }, "starts_at": "2026-01-01T09:00:00.000Z", "ends_at": "2026-01-01T09:00:00.000Z", "status": "planned", "lead": { "id": 12, "name": "Sam Lee" }, "members": [ { "id": 1, "name": "your-name", "role": "your-role" } ], "open_count": 1, "handover_status": "your-handover-status" } ], "meta": { "limit": 50, "offset": 0, "total": 1, "has_more": false }}