Read Employee

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


Field Definition Type Required
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, the employee identifier is 1234567.



Field Definition Type
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

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

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 that an employee works for if subcompanies have been set up

  • ID (Text) - Subcompany's unique identifier

  • Name (Text) - Subcompany name


Office where an employee works

  • ID (Text) - Office unique identifier

  • Name (Text) - Office name


Department where an employee works

  • ID (Text) - Department's unique identifier

  • Name (Text) - Department name

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

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

Fixed Salary

Employee's fixed salary

  • Value (Number) - Employee's salary

  • Currency (Text) - Currency type

Salary Interval Interval between salary payments Text
Hourly Salary

Employee's hourly salary

  • Value (Number) - Employee's salary

  • Currency (Text) - Currency type

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

Employee's team

  • ID (Text) - Team's unique identifier

  • Name (Text) - Team name

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

Related topics

Personio connector


Workflow elements

Personio REST API