Read Employee

Retrieve information about an employee based on their ID or email address.

Input

Field Definition Type Required
Employee
ID or Email

Unique identifier of the user. You can find the identifier using the URL for the employee within your Personio instance.

For example, if the URL is https://example.personio.de/staff/details/1234567, the employee identifier is 1234567.

Text TRUE

Output

Field Definition Type
Result
ID Unique identifier for the employee Text
First Name Employee's first name Text
Last Name Employee's family name Text
Email Email address for the employee. This is predefined as the unique identifier used to assign employee data during import activity. Text
Gender Employee's gender Text
Status Employee status: Onboarding, Active, Inactive, Leave Text
Position Position currently held within the company Text
Supervisor

Employee's supervisor

  • ID (Text) - Supervisor's unique identifier

  • First Name (Text) - Supervisor's first name

  • Last Name (Text) - Supervisor's family name

  • Email (Text) - Supervisor's email

Object
Employment Type Indicates whether an employee is employed internally or externally Text
Weekly Hours An employee's contractually agreed weekly working hours. This value is linked to the employee salary. Text
Hire Date Date from which a work contract is effective Date & Time
Contract End Date Date on which a fixed-term work contract expires Date & Time
Termination Date Date on which the employment terminates. After this date, the employee status is automatically set to Inactive Date & Time
Termination Type Termination type Text
Termination Reason Reason for termination Text
Probation Period End Date End date of the probation period Date & Time
Created At Creation date for the employee record Date & Time
Last Modified Date when the employee record was last updated Date & Time
Subcompany

Subcompany that an employee works for if subcompanies have been set up

  • ID (Text) - Subcompany's unique identifier

  • Name (Text) - Subcompany name

Object
Office

Office where an employee works

  • ID (Text) - Office unique identifier

  • Name (Text) - Office name

Object
Department

Department where an employee works

  • ID (Text) - Department's unique identifier

  • Name (Text) - Department name

Object
Cost Center

The relevant cost center. You can select several cost centers and assign different charge percentages to each.

  • ID (Text) - Cost center unique identifier

  • Name (Text) - Cost center name

  • Percentage (Number) - Percentage of allocated cost

List of Objects
Public Holidays

Employee's public holidays

  • ID (Text) - Public holiday unique identifier

  • Name (Text) - Public holiday name

  • Country (Text) - Public holiday country

  • State (Text) - Public holiday state

Object
Absence Entitlements

Employee's absence entitlements

  • ID (Text) - Absence entitlement unique identifier

  • Name (Text) - Absence entitlement name

  • Category (Text) - Absence entitlement category

  • Entitlement (Text) - Absence entitlement type

List of Objects
Work Schedule

Employee's work schedule

  • ID (Text) - Work schedule unique identifier

  • Name (Text) - Work schedule name

  • Valid From (Text) - Work schedule start

  • Monday (Text) - Scheduled hours

  • Tuesday (Text) - Scheduled hours

  • Wednesday (Text) - Scheduled hours

  • Thursday (Text) - Scheduled hours

  • Friday (Text) - Scheduled hours

  • Saturday (Text) - Scheduled hours

  • Sunday (Text) - Scheduled hours

Object
Fixed Salary

Employee's fixed salary

  • Value (Number) - Employee's salary

  • Currency (Text) - Currency type

Object
Salary Interval Interval between salary payments Text
Hourly Salary

Employee's hourly salary

  • Value (Number) - Employee's salary

  • Currency (Text) - Currency type

Object
Vacation Day Balance Number of vacation days available Number
Last Day of Work Final day of employment Date & Time
Profile Picture URL for employee's profile picture Text
Team

Employee's team

  • ID (Text) - Team's unique identifier

  • Name (Text) - Team name

Object
Custom Fields User-defined employee fields. Dynamically generated per connection. Various

Related topics

Personio connector

Authorization

Workflow elements

Personio REST API