EVevolia
Public
Events

Get an event (shift) by uid or externalId

get/v1/public/events/{eventId}

Request

Path parameters

eventIdstring required

Query parameters

localestring

Possible values are "en", "es" or "fr". This locale is use to return multilingual data like teamName, locationName and positionName

Response

uidstring required

unique event id

externalIdstring

The unique event externalId. The externalId is often used as a mapping value between Evolia and an external system

startsAtstring required

date and time of the start of the event. In ISO-8601 format.

endsAtstring required

date and time of the end of the event. In ISO-8601 format.

hideEndsAtboolean required

if true the event has an undetermined end time. endsAt is still initialised but represent more a suggested end time

timeZonestring required

event time zone, ex: America/New_York

memberFirstNamestring

when assigned, contains the member (employee) first name

memberLastNamestring

when assigned, contains the member (employee) first name

memberIdstring

when assigned, contains the member (employee) UID

memberCodestring

when assigned, contains the member (employee) code

memberHourlyWagenumber

when assigned, contains the member hourly wage specific to the skill of the shift

openShiftCountnumber

a shift is considered open when memberId is undefined. When a shift is open, openShiftCount indicates the number of places available

skillIdstring required

the event skill UID (position)

skillNamestring required

the event skill name (position)

skillCodestring

the event skill code (position)

locationIdstring

the event location UID

locationNamestring

the event location name

locationCodestring

the event location code

subLocationIdstring

the event sub-location UID

subLocationNamestring

the event sub-location name

subLocationCodestring

the event sub-location code

divisionIdstring

the event division UID

teamIdstring required

the event team UID

teamCodestring

the event team code

teamNamestring

the event team name

isStandbyboolean

if true this event is in stand-by

isCancelledboolean

if true this event is cancelled

cancelledReasonstring

the reason of the cancellation

isDraftboolean required

if true this event is draft

notestring

This note is visible to the assigned employee and to shift team managers

internalNotestring

The internalNote field is a private property restricted to shift team managers. This information is never visible to the assigned employee.

paidPreparationTimeInMnumber required

The paid preparation time in minutes.

assignedByobject required

when assigned, member (employee) UID that assigned the event.

assignedAtstring required

when assigned, date and time of the assignment of the event. In ISO-8601 format.

splitFromEventIdstring required

when event is split from another event, contains the source event UID

Example response

{
  "premiums": [
    {
      "names": {
        "en": "night bonus",
        "fr": "prime de nuit"
      },
      "calculationType": "AMOUNT: flat amount (+ 15$), HOURS: flat amount of hours (+ 1h), HOURLY_MULTIPLIER: multiply hourly rate (x 1.5/h), HOURLY_BONUS: flat hourly bonus (+ 1$/h)",
      "code": "241"
    }
  ]
}

Changes

No recorded changes to this operation across all 8 revisions of this API.