Shift lookup

Next shift

GET /nextshift

Retrieves the next shift for a specified worker from a given date and time.

All three parameters are mandatory and case-sensitive (CarerId, Date and Time are rejected). A missing or malformed parameter returns HTTP 200 with an error object such as {"status":"error","message":"Error: carerId is required"}.

Example: GET /nextshift?carerId=1096&date=2025-01-01&time=12:00 Parameters:

Parameter	Required	Description
`carerId`	Yes	Integer. Worker ID
`date`	Yes	Format: `YYYY-MM-DD`
`time`	Yes	Format: `HH:MM`, zero-padded (for example `09:05`). Seconds are rejected

Response: a single shift object, not an array.

{
  "CarerId": 1096,
  "DateOfService": "2025-01-03",
  "StartTime": "07:00:00",
  "FinishTime": "08:00:00",
  "IsSleepover": "false"
}

Response fields:

Field	Type	Notes
`CarerId`	integer
`DateOfService`	string	Date
`StartTime`	string	Time (HH:MM:SS)
`FinishTime`	string	Time (HH:MM:SS)
`IsSleepover`	string	`"true"` / `"false"` (string, not boolean)

Previous shift

GET /prevshift

Retrieves the previous shift for a specified worker from a given date and time.

Example: GET /prevshift?carerId=1096&date=2025-01-01&time=12:00 Parameters:

Parameter	Required	Description
`carerId`	Yes	Integer. Worker ID
`date`	Yes	Format: `YYYY-MM-DD`
`time`	Yes	Format: `HH:MM`, zero-padded (for example `09:05`). Seconds are rejected

Response: a single shift object, not an array.

{
  "CarerId": 1096,
  "DateOfService": "2025-01-01",
  "StartTime": "07:00:00",
  "FinishTime": "08:00:00",
  "IsSleepover": "false"
}

Response fields: Same as Next shift.

Overview

Clients

Workers

Categories

Organisation

Scheduling

People

Incidents

Records

Next shift

GET /nextshift

Previous shift

GET /prevshift

​Next shift

​GET /nextshift

​Previous shift

​GET /prevshift

Next shift

GET /nextshift

Previous shift

GET /prevshift