Personnel Data
    Personnel Data
    • /company/attendances
      GET
    • /company/attendances
      POST
    • /company/attendances/{id}
      DELETE
    • /company/attendances/{id}
      PATCH
    • /company/employees
      GET
    • Create an employee
      POST
    • /company/employees/{employee_id}
      GET
    • /company/employees/{employee_id}/profile-picture/{width}
      GET
    • /company/time-off-types
      GET
    • /company/time-offs
      GET
    • /company/time-offs
      POST
    • /company/time-offs/{id}
      DELETE
    • /company/time-offs/{id}
      GET

      /company/employees

      GET
      /company/employees
      List Employees

      Request

      None

      Responses

      🟢200Success
      application/json
      Body

      Request Request Example
      Shell
      JavaScript
      Java
      Swift
      curl --location --request GET 'https://api.personio.de/v1/company/employees'
      Response Response Example
      {
          "data": [
              {
                  "attributes": {
                      "absence_entitlement": {
                          "label": "Absence entitlement",
                          "value": [
                              {
                                  "attributes": {
                                      "entitlement": 30,
                                      "id": 12345,
                                      "name": "Paid Vacation"
                                  },
                                  "type": "TimeOffType"
                              },
                              {
                                  "attributes": {
                                      "entitlement": 0,
                                      "id": 12346,
                                      "name": "Parental leave"
                                  },
                                  "type": "TimeOffType"
                              },
                              {
                                  "attributes": {
                                      "entitlement": 0,
                                      "id": 12347,
                                      "name": "Sick days"
                                  },
                                  "type": "TimeOffType"
                              }
                          ]
                      },
                      "contract_end_date": {
                          "label": "Contract ends",
                          "value": {
                              "$ref": "#/components/schemas/UpdateAttendancePeriodRequest/example/comment"
                          }
                      },
                      "cost_centers": {
                          "label": "Cost center",
                          "value": [
                              {
                                  "attributes": {
                                      "id": 320,
                                      "name": "Cost Center One",
                                      "percentage": 50
                                  },
                                  "type": "CostCenter"
                              },
                              {
                                  "attributes": {
                                      "id": 321,
                                      "name": "Cost Center Two",
                                      "percentage": 50
                                  },
                                  "type": "CostCenter"
                              }
                          ]
                      },
                      "created_at": {
                          "label": "created_at",
                          "value": "2016-10-20T16:15:55+0200"
                      },
                      "department": {
                          "label": "Department",
                          "value": {
                              "attributes": {
                                  "name": "Marketing"
                              },
                              "type": "Department"
                          }
                      },
                      "dynamic_21827": {
                          "label": "IBAN",
                          "value": "DE98 8989 9898 0000 8989 00"
                      },
                      "dynamic_24407": {
                          "label": "Titel",
                          "value": "Dr"
                      },
                      "email": {
                          "label": "Email",
                          "value": "andreas.anderson@demo.com"
                      },
                      "employment_type": {
                          "label": "Employment type",
                          "value": "internal"
                      },
                      "first_name": {
                          "label": "First name",
                          "value": "Andreas"
                      },
                      "fix_salary": {
                          "label": "Fix salary",
                          "value": 4000
                      },
                      "gender": {
                          "label": "Gender",
                          "value": "male"
                      },
                      "hire_date": {
                          "label": "Hire date",
                          "value": "2012-02-01T00:00:00+0100"
                      },
                      "holiday_calendar": {
                          "label": "Holiday Calendar",
                          "value": {
                              "attributes": {
                                  "country": "DE",
                                  "id": 931,
                                  "name": "DE (Hamburg) Feiertage",
                                  "state": "Hamburg"
                              },
                              "type": "HolidayCalendar"
                          }
                      },
                      "hourly_salary": {
                          "label": "Hourly salary",
                          "value": 0
                      },
                      "id": {
                          "label": "id",
                          "value": 83752
                      },
                      "last_modified_at": {
                          "label": "Last modified",
                          "value": "2016-10-22T16:15:55+0200"
                      },
                      "last_name": {
                          "label": "Last name",
                          "value": "Anderson"
                      },
                      "last_working_day": {
                          "label": "Last working day",
                          "value": "2017-02-28T00:00:00+0200"
                      },
                      "office": {
                          "label": "Office",
                          "value": {
                              "attributes": {
                                  "name": "Munich"
                              },
                              "type": "Office"
                          }
                      },
                      "position": {
                          "label": "Position",
                          "value": "Online Marketing Specialist"
                      },
                      "probation_period_end": {
                          "label": "Probation period end",
                          "value": "2012-07-31T00:00:00+0200"
                      },
                      "profile_picture": {
                          "label": "Profile Picture",
                          "value": "http://api.dev.personio.de/v1/company/employees/2/profile-picture"
                      },
                      "status": {
                          "label": "Status",
                          "value": "active"
                      },
                      "supervisor": {
                          "label": "Supervisor",
                          "value": {
                              "attributes": {
                                  "email": {
                                      "label": "Email",
                                      "value": "max.mustermann@example.org"
                                  },
                                  "first_name": {
                                      "label": "First name",
                                      "value": "Max"
                                  },
                                  "id": {
                                      "label": "id",
                                      "value": 423506
                                  },
                                  "last_name": {
                                      "label": "Last name",
                                      "value": "Mustermann"
                                  }
                              },
                              "type": "Employee"
                          }
                      },
                      "termination_date": {
                          "label": "Termination date",
                          "value": {
                              "$ref": "#/components/schemas/UpdateAttendancePeriodRequest/example/comment"
                          }
                      },
                      "termination_reason": {
                          "label": "Termination reason",
                          "value": ""
                      },
                      "termination_type": {
                          "label": "Termination type",
                          "value": ""
                      },
                      "vacation_day_balance": {
                          "label": "Vacation day balance",
                          "value": 28.5
                      },
                      "weekly_working_hours": {
                          "label": "Weekly hours",
                          "value": "40"
                      },
                      "work_schedule": {
                          "label": "Work Schedule",
                          "value": {
                              "attributes": {
                                  "friday": "06:00",
                                  "id": 123,
                                  "monday": "08:30",
                                  "name": "Standard Hours",
                                  "saturday": "00:00",
                                  "sunday": "00:00",
                                  "thursday": "08:30",
                                  "tuesday": "08:30",
                                  "wednesday": "08:30"
                              },
                              "type": "WorkSchedule"
                          }
                      }
                  },
                  "type": "Employee"
              }
          ],
          "success": true
      }
      Modified at 2023-08-22 06:28:03
      Previous
      /company/attendances/{id}
      Next
      Create an employee
      Built with