Jump to Content

API Reference Changelog Changelog Policy Webhooks API Support

v1.0

API Reference

v1.0API Reference Changelog Changelog Policy Webhooks API Support

Introduction

Getting started with the shyftplan API
Which method do I want? (Get, Post, Put, Delete)
GraphQL Guide

Use Cases

API Structure and Object Map
Absences Data Sync
Attendances Data Sync
Demand-driven shift updates
HR Master Data Sync

shyftplan API

absences
absence_entitlements
- v2/absence_entitlementsget
- v2/absence_entitlementsput
absence_reasons
assignment_groups
availabilities
availability_aggregations
- v1/availability_aggregationsget
background_jobs
- v1/background_jobsget
- v1/background_jobs/{id}get
bulk_requests
- v1/bulk_requestspost
- v1/bulk_requests/{id}get
calendar
- v1/calendar/aggregationsget
chat_messages
companies
custom_fields
employee_evaluations
employments
employments_paygrades
- v1/employments_paygradesget
employments_positions
employments_rotation_groups
employments_surveys
- v1/employments_surveys/{id}get
- v1/employments_surveys/{id}post
employment_time_accounts
- v1/employment_time_accountsget
- v1/employment_time_accountspatch
evaluations
evaluation_breaks
- v1/evaluation_breaksget
evaluation_tags
external_record_mappings
individual_rotations
languages
- v1/languagesget
live_staff_shifts
- v1/live_staff_shiftsget
locations
locations_positions
login
- v1/loginpost
newsfeeds
- v1/newsfeedsget
- v1/newsfeedspost
notification_configurations
paygrade_types
- v1/paygrade_typesget
- v1/paygrade_types/{id}get
payments
- v1/payments/{staff_shift_id}get
payslips
- v1/payslipsget
- v1/payslipspost
positions
punch_timings
qualifications
- v1/qualificationsget
replaced_evaluations
- v1/replaced_evaluationsget
replace_requests
- v1/replace_requests/{id}delete
requests
rights
sessions
- v1/sessions/refreshpost
shiftplans
shifts
shifts_tags
- v1/shifts_tagsget
- v1/shifts_tags/{id}get
shift_assignment_groups
- v1/shift_assignment_groupsget
shift_breaks
- v1/shift_breaksget
shift_presets
- v1/shift_presetsget
- v1/shift_presetspost
shift_rotations
shift_rotation_groups
special_dates
sso_settings
- v1/sso_settings/sso_target_urlget
staff_shifts
staff_shifts_tags
tags
users

Powered by

Introduction

Getting started with the shyftplan API
Which method do I want? (Get, Post, Put, Delete)
GraphQL Guide

Use Cases

API Structure and Object Map
Absences Data Sync
Attendances Data Sync
Demand-driven shift updates
HR Master Data Sync

shyftplan API

absences
absence_entitlements
- v2/absence_entitlementsget
- v2/absence_entitlementsput
absence_reasons
assignment_groups
availabilities
availability_aggregations
- v1/availability_aggregationsget
background_jobs
- v1/background_jobsget
- v1/background_jobs/{id}get
bulk_requests
- v1/bulk_requestspost
- v1/bulk_requests/{id}get
calendar
- v1/calendar/aggregationsget
chat_messages
companies
custom_fields
employee_evaluations
employments
employments_paygrades
- v1/employments_paygradesget
employments_positions
employments_rotation_groups
employments_surveys
- v1/employments_surveys/{id}get
- v1/employments_surveys/{id}post
employment_time_accounts
- v1/employment_time_accountsget
- v1/employment_time_accountspatch
evaluations
evaluation_breaks
- v1/evaluation_breaksget
evaluation_tags
external_record_mappings
individual_rotations
languages
- v1/languagesget
live_staff_shifts
- v1/live_staff_shiftsget
locations
locations_positions
login
- v1/loginpost
newsfeeds
- v1/newsfeedsget
- v1/newsfeedspost
notification_configurations
paygrade_types
- v1/paygrade_typesget
- v1/paygrade_types/{id}get
payments
- v1/payments/{staff_shift_id}get
payslips
- v1/payslipsget
- v1/payslipspost
positions
punch_timings
qualifications
- v1/qualificationsget
replaced_evaluations
- v1/replaced_evaluationsget
replace_requests
- v1/replace_requests/{id}delete
requests
rights
sessions
- v1/sessions/refreshpost
shiftplans
shifts
shifts_tags
- v1/shifts_tagsget
- v1/shifts_tags/{id}get
shift_assignment_groups
- v1/shift_assignment_groupsget
shift_breaks
- v1/shift_breaksget
shift_presets
- v1/shift_presetsget
- v1/shift_presetspost
shift_rotations
shift_rotation_groups
special_dates
sso_settings
- v1/sso_settings/sso_target_urlget
staff_shifts
staff_shifts_tags
tags
users

Powered by

v1/employments/{id}

get https://shyftplan.com/api/v1/employments/{id}

Return a Employment.

Language

Click Try It! to start a request and see the response here!