Jump to Content
API Reference
Changelog
Changelog Policy
Webhooks
API Support
v1.0
Home
API Reference
Home
Moon (Dark Mode)
Sun (Light Mode)
v1.0
API Reference
Changelog
Changelog Policy
Webhooks
API Support
v2/positions
Search
JUMP TO
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
v1/absences
get
v1/absences
post
v1/absences/{id}
delete
v1/absences/{id}
get
v1/absences/{id}
put
v1/absences/{id}/approve
post
v1/absences/{id}/attachment
post
v1/absences/{id}/decline
post
v1/absences/{id}/withdraw
post
v1/absences/employments
get
v1/absences/employments/{id}
get
v1/absences/employments/{id}/absence_info
get
v2/absences/employments/{id}/absence_info
get
v1/absences/employments/{id}/carry_over_info
get
v1/absences/locations
get
v1/absences/stats
get
absence_entitlements
v2/absence_entitlements
get
v2/absence_entitlements
put
absence_reasons
v1/absence_reasons
get
v1/absence_reasons
post
v2/absence_reasons
post
v1/absence_reasons/{id}
delete
v1/absence_reasons/{id}
get
v1/absence_reasons/{id}
put
v2/absence_reasons/{id}
patch
v1/absence_reasons/stats
get
assignment_groups
v1/assignment_groups
get
v1/assignment_groups
post
v1/assignment_groups/{id}
delete
v1/assignment_groups/{id}
get
v1/assignment_groups/{id}
put
v1/assignment_groups/{id}/add_shift
put
v1/assignment_groups/{id}/assign_employment
post
v1/assignment_groups/{id}/remove_shift
put
v1/assignment_groups/{id}/unassign_employment
post
availabilities
v1/availabilities
get
v1/availabilities
post
v1/availabilities/{availability_id}
delete
v1/availabilities/{availability_id}
get
v1/availabilities/{availability_id}
put
v1/availabilities/{availability_id}/exceptions
get
v1/availabilities/{availability_id}/exceptions
post
v1/availabilities/exceptions
get
v1/availabilities/exceptions/{exception_id}
delete
v1/availabilities/exceptions/{exception_id}
get
availability_aggregations
v1/availability_aggregations
get
available_global_qualifications
v1/available_global_qualifications
get
background_jobs
v1/background_jobs
get
v1/background_jobs/{id}
get
bulk_requests
v1/bulk_requests
post
v1/bulk_requests/{id}
get
calendar
v1/calendar/aggregations
get
chat_messages
v1/chat_messages
get
v1/chat_messages
post
v1/chat_messages/chats
get
v1/chat_messages/employments
get
companies
v1/companies
get
v1/companies/{id}
get
v1/companies/{id}/shift_schedule_settings
get
v1/companies/{id}/ui_settings
get
v1/companies/{id}/ui_settings
post
custom_fields
v1/custom_fields
get
v1/custom_fields
post
v1/custom_fields/{id}
delete
v1/custom_fields/{id}
get
v1/custom_fields/{id}
put
employee_evaluations
v1/employee_evaluations/{evaluation_id}/tags
get
v1/employee_evaluations/{evaluation_id}/tags
post
v1/employee_evaluations/{evaluation_id}/tags/{evaluation_tag_id}
delete
v1/employee_evaluations/{staff_shift_id}
delete
v1/employee_evaluations/{staff_shift_id}
get
v1/employee_evaluations/{staff_shift_id}
post
v1/employee_evaluations/{staff_shift_id}/accept
post
v1/employee_evaluations/{staff_shift_id}/evaluation_break
post
v1/employee_evaluations/{staff_shift_id}/evaluation_break/{evaluation_break_id}
delete
v1/employee_evaluations/{staff_shift_id}/evaluation_break/{evaluation_break_id}
put
v1/employee_evaluations/{staff_shift_id}/payments
get
v1/employee_evaluations/{staff_shift_id}/payments
post
v1/employee_evaluations/{staff_shift_id}/payments/{payment_id}
get
v1/employee_evaluations/{staff_shift_id}/payments/{payment_id}
put
employments
v1/employments
get
v2/employments
get
v2/employments
post
v1/employments/available_for_qualification_matrix
get
v1/employments/info
get
v1/employments/my
get
v1/employments/potential_conflicts
get
v1/employments/{id}
delete
v1/employments/{id}
get
v1/employments/{id}/availabilities
get
v1/employments/{id}/destroy_employment
post
v1/employments/{id}/live_info
get
v1/employments/{id}/notifications
get
v1/employments/{employment_id}/master_location_position
put
v1/employments/{id}/yearly_bring_shifts
get
v1/employments/{id}/yearly_bring_shifts/for_year
put
v1/employments/{id}/restore_employment
post
v1/employments/{id}/rights
get
v1/employments/{id}/paygrades
get
v1/employments/{id}/paygrades
post
v1/employments/{id}/paygrades/{paygrade_id}
delete
v1/employments/{id}/paygrades/{paygrade_id}
get
v1/employments/{id}/paygrades/{paygrade_id}
put
v1/employments/{id}/ui_settings
get
v1/employments/{id}/ui_settings
post
employments_paygrades
v1/employments_paygrades
get
employments_positions
v1/employments_positions
get
v1/employments_positions
post
v1/employments_positions/{id}
delete
v1/employments_positions/{id}
get
employments_qualifications
v1/employments_qualifications
get
v1/employments_qualifications
post
v1/employments_qualifications
put
v1/employments_qualifications/{id}
delete
v1/employments_qualifications/{id}/approve_planned
post
employments_rotation_groups
v1/employments_rotation_groups
get
v1/employments_rotation_groups
post
v1/employments_rotation_groups/{id}
delete
v1/employments_rotation_groups/{id}
put
employments_surveys
v1/employments_surveys/{id}
get
v1/employments_surveys/{id}
post
employment_time_accounts
v1/employment_time_accounts
get
v1/employment_time_accounts
patch
evaluations
v1/evaluations
get
v1/evaluations/{staff_shift_id}
get
v1/evaluations/{staff_shift_id}
post
v1/evaluations/{staff_shift_id}/did_not_show
post
v1/evaluations/{staff_shift_id}/did_show
post
v1/evaluations/{staff_shift_id}/evaluation_breaks
post
v1/evaluations/{staff_shift_id}/evaluation_breaks/{evaluation_break_id}
delete
v1/evaluations/{staff_shift_id}/evaluation_breaks/{evaluation_break_id}
put
v1/evaluations/{staff_shift_id}/payments
get
v1/evaluations/{staff_shift_id}/payments
post
v1/evaluations/{staff_shift_id}/payments_calculation
get
v1/evaluations/{staff_shift_id}/payments/{payment_id}
delete
v1/evaluations/{staff_shift_id}/payments/{payment_id}
get
v1/evaluations/{staff_shift_id}/payments/{payment_id}
put
evaluation_breaks
v1/evaluation_breaks
get
evaluation_tags
v1/evaluation_tags
get
v1/evaluation_tags
post
v1/evaluation_tags/{id}
delete
v1/evaluation_tags/{id}
put
external_record_mappings
v1/external_record_mappings
get
v1/external_record_mappings
post
v1/external_record_mappings/{id}
delete
v1/external_record_mappings/{id}
get
v1/external_record_mappings/{id}
put
hour_accounts
v1/hour_accounts
get
v1/hour_accounts
post
v1/hour_accounts/corrections
post
v1/hour_accounts/corrections/{id}
put
v1/hour_accounts/corrections/{id}
delete
v1/hour_accounts/employments
get
v1/hour_accounts/export
get
v1/hour_accounts/{employment_id}
delete
v1/hour_accounts/{employment_id}/breakdown
get
v1/hour_accounts/{employment_id}/export
get
v1/hour_accounts/{employment_id}/previous_months
get
v1/hour_accounts/{employment_id}/stats
get
individual_rotations
v1/individual_rotations
get
v1/individual_rotations
post
v1/individual_rotations/{id}
delete
v1/individual_rotations/{id}
get
v1/individual_rotations/{id}
put
languages
v1/languages
get
live_staff_shifts
v1/live_staff_shifts
get
locations
v1/locations
get
v1/locations
post
v1/locations/{id}
delete
v1/locations/{id}
get
v1/locations/{id}
put
v1/locations/{id}/destroy_location
post
v1/locations/{id}/shiftplan_publish_settings
get
v1/locations/{id}/shiftplan_publish_settings
put
locations_positions
v1/locations_positions
get
v1/locations_positions
post
v1/locations_positions/{id}
delete
v1/locations_positions/{id}
get
v1/locations_positions/{id}
put
locations_position_qualifications
v1/locations_position_qualifications
post
v1/locations_position_qualifications
put
v1/locations_position_qualifications/{id}
delete
login
v1/login
post
newsfeeds
v1/newsfeeds
get
v1/newsfeeds
post
notification_configurations
v1/notification_configurations
get
v1/notification_configurations/notification_filter
get
v1/notification_configurations/notification_filter
put
v1/notification_configurations/{id}
get
v1/notification_configurations/{id}
put
paygrade_types
v1/paygrade_types
get
v1/paygrade_types/{id}
get
payments
v1/payments/{staff_shift_id}
get
payslips
v1/payslips
get
v1/payslips
post
positions
v1/positions
get
v1/positions
post
v1/positions/{id}
delete
v1/positions/{id}
get
v1/positions/{id}
put
v2/positions
get
v1/positions/{id}/add_employment
put
v1/positions/{id}/destroy_position
post
v1/positions/{id}/remove_employment
put
punch_timings
v1/punch_timings
get
v1/punch_timings/fetch_locations_positions
get
v1/punch_timings/punch_time
get
v1/punch_timings/record
get
v1/punch_timings/shift_create
post
v1/punch_timings/start
post
v1/punch_timings/{id}
put
v1/punch_timings/{punch_timing_id}/punch_breaks
post
v1/punch_timings/{punch_timing_id}/punch_breaks/{id}
put
qualifications
v1/qualifications
get
v1/qualifications/categories
get
v1/qualifications/categories/employments_qualifications
put
v1/qualifications/categories/rotation_groups/stats
get
v1/qualifications/categories/stats
get
v1/qualifications/employments
get
v1/qualifications/expirations
get
v1/qualifications/grouped_by_category
get
v1/qualifications/inheritances
get
v1/qualifications/inheritances
post
v1/qualifications/inheritances/available_locations_positions
get
v1/qualifications/inheritances/{id}
delete
v1/qualifications/locations_positions
get
v1/qualifications/locations_positions
post
v1/qualifications/locations_positions/available_qualifications
get
v1/qualifications/locations_positions/stats
get
v1/qualifications/positions/rotation_groups/stats
get
v1/qualifications/positions/stats
get
replaced_evaluations
v1/replaced_evaluations
get
replace_requests
v1/replace_requests/{id}
delete
requests
v1/requests
get
v1/requests/accept_swap_shift
post
v1/requests/apply_shift
post
v1/requests/change_shift
post
v1/requests/confirm_apply_shift
post
v1/requests/confirm_swap_shift
post
v1/requests/join
post
v1/requests/swap_shift
post
v1/requests/replace
post
v1/requests/replace/accept
post
v1/requests/replace/confirm
post
v1/requests/{id}
get
v1/requests/{id}
delete
rights
v1/rights
get
v1/rights/locations_position_payment_manage_right
put
v1/rights/locations_position_payment_manage_right
delete
v1/rights/locations_position_payment_show_right
delete
v1/rights/locations_position_payment_show_right
put
v1/rights/locations_position_shift_manage_right
delete
v1/rights/locations_position_shift_manage_right
put
v1/rights/locations_position_shift_show_right
delete
v1/rights/locations_position_shift_show_right
put
v1/rights/location_payment_manage_right
delete
v1/rights/location_payment_manage_right
put
v1/rights/location_payment_show_right
delete
v1/rights/location_payment_show_right
put
v1/rights/location_shift_manage_right
delete
v1/rights/location_shift_manage_right
put
v1/rights/location_shift_show_right
delete
v1/rights/location_shift_show_right
put
v1/rights/my
get
v1/rights/{id}
delete
v1/rights/{id}
put
sessions
v1/sessions/refresh
post
shiftplans
v1/shiftplans
get
v1/shiftplans
post
v1/shiftplans/assign_employments_to_open_shifts
post
v1/shiftplans/{id}
delete
v1/shiftplans/{id}
get
v1/shiftplans/{id}
patch
v1/shiftplans/{id}/assign_rotation
post
v1/shiftplans/{id}/copy
post
v1/shiftplans/{shiftplan_id}/copy_to_existing
post
v1/shiftplans/{shiftplan_id}/day_notes
get
v1/shiftplans/{shiftplan_id}/day_notes
post
v1/shiftplans/{shiftplan_id}/day_notes/{id}
delete
v1/shiftplans/{shiftplan_id}/day_notes/{id}
put
v1/shiftplans/{id}/employments_info
get
v1/shiftplans/{shiftplan_id}/messages
post
v1/shiftplans/{shiftplan_id}/notifications
get
v1/shiftplans/{shiftplan_id}/notifications_messages
post
v1/shiftplans/{id}/publish
post
shifts
v1/shifts
get
v1/shifts
post
v2/shifts
get
v1/shifts/automation
post
v1/shifts/connect
post
v1/shifts/{id}
delete
v1/shifts/{id}
get
v1/shifts/{id}
patch
v1/shifts/{id}
put
v1/shifts/{id}/available_employments
get
v1/shifts/{id}/clone
post
v1/shifts/{id}/disconnect
post
v1/shifts/{id}/evaluations
get
v1/shifts/{shift_id}/evaluation_tags
delete
v1/shifts/{shift_id}/evaluation_tags
get
v1/shifts/{shift_id}/evaluation_tags
post
v2/shifts/{id}/paygrades
put
v1/shifts/{shift_id}/paygrades
get
v1/shifts/{shift_id}/paygrades
post
v1/shifts/{shift_id}/paygrades/{id}
delete
v1/shifts/{shift_id}/paygrades/{id}
put
v1/shifts/{shift_id}/shift_breaks
post
v1/shifts/{shift_id}/shift_breaks/{id}
delete
v1/shifts/{shift_id}/shift_breaks/{id}
patch
shifts_tags
v1/shifts_tags
get
v1/shifts_tags/{id}
get
shift_assignment_groups
v1/shift_assignment_groups
get
shift_breaks
v1/shift_breaks
get
shift_presets
v1/shift_presets
get
v1/shift_presets
post
shift_rotations
v1/shift_rotations
get
v1/shift_rotations
post
v1/shift_rotations/{id}
delete
v1/shift_rotations/{id}
get
v1/shift_rotations/{id}
put
v1/shift_rotations/{id}/shiftplan
post
shift_rotation_groups
v1/shift_rotation_groups
get
v1/shift_rotation_groups
post
v1/shift_rotation_groups/{id}
delete
v1/shift_rotation_groups/{id}
put
v1/shift_rotation_groups/{id}/assign_employee
post
v1/shift_rotation_groups/{id}/assign_to_shifts
post
v1/shift_rotation_groups/{id}/unassign_employee
post
v1/shift_rotation_groups/{id}/unassign_from_shifts
post
v1/shift_rotation_groups/required_fully_qualified_employees
put
v1/shift_rotation_groups/required_fully_qualified_employees/{id}
delete
special_dates
v1/special_dates
get
v1/special_dates
post
v1/special_dates/{id}
delete
v1/special_dates/{id}
get
v1/special_dates/{id}
put
sso_settings
v1/sso_settings/sso_target_url
get
staff_shifts
v1/staff_shifts
get
v1/staff_shifts
post
v1/staff_shifts/move_staff
post
v1/staff_shifts/replace
post
v1/staff_shifts/{id}
delete
v1/staff_shifts/{id}
get
staff_shifts_tags
v1/staff_shifts_tags
delete
v1/staff_shifts_tags
get
v1/staff_shifts_tags
post
v1/staff_shifts_tags/{id}
get
tags
v1/tags
get
v1/tags
post
v1/tags/{id}
delete
v1/tags/{id}
get
v1/tags/{id}
put
v1/tags/{id}/add_to_shift
put
v1/tags/{id}/remove_from_shift
put
users
v1/users
get
v1/users
post
v1/users/change_locale
post
v1/users/update_password
post
v1/users/{id}
get
v1/users/{id}
put
Powered by
v2/positions
get
https://shyftplan.com/api/v2/positions
List all Positions.
Language
Shell
Node
Ruby
PHP
Python
RESPONSE
Click
Try It!
to start a request and see the response here!