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

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

Read Employee

Input

Output

Related topics