Shift Swaps

Requests from one caregiver to hand a visit to another, which the other caregiver and then the office approve.

Endpoints

The ShiftSwap object

object
stringread-only

String representing the object's type. Always shift_swap.

id
stringread-only

Unique identifier of the shift swap.

visitId
string | nullmax length 64

The visit to hand over.

requestingCaregiverId
string | nullmax length 64

The caregiver giving up the visit. With a caregiver's API key this is always that caregiver (leave it out), and the visit must be assigned to them; office staff must send it.

requestingCaregiverName
string | nullread-onlymax length 2000

Display name of the requesting caregiver, taken from the caregiver's record.

targetCaregiverId
string | nullmax length 64

The caregiver asked to take the visit.

targetCaregiverName
string | nullmax length 200

Display name of the target caregiver.

reason
string | nullmax length 20000

Why the swap is requested.

status
string | null

Where the swap stands. With a caregiver's key: new swaps are Pending; the asked caregiver changes a Pending swap to Accepted or Declined; the requesting caregiver can change it to Cancelled. AdminApproved and AdminDenied are for office staff.

One ofPendingAcceptedDeclinedCancelledAdminApprovedAdminDeniednull
requestDate
string · date-time | null

When the swap was requested.

responseDate
string · date-time | nullread-only

When the target caregiver answered.

adminResponseDate
string · date-time | nullread-only

When the office answered.

createdAt
string · date-time | nullread-only

When the shift swap was created.

updatedAt
string · date-time | nullread-only

When the shift swap was last changed.