List Employees

---

GET /services/api/v1/employees

Returns a list of employees.

Optional Query Parameters

Parameter	Type	Description
employee_status_id	string	Only return employees that have the passed status.
tax_number	string	Only return employees that have the specified case-sensitive tax number (italy).
social_security_number	string	Only return employees that have the specified case-sensitive social_security_number (austria).
tax_identification_number	string	Only return employees that have the specified case-sensitive tax identification number (germany).
employee_number	string	Only return employees that have the specified employee number.
has_active_employee_job	boolean	Filter by employees who either do, or do not have an active job.
has_active_or_future_employee_job	boolean	Filter by employees who either do, or do not have an active or future job.
created_at_since	timestamp	Only return employees that have been created since the specified timestamp.
updated_at_since	timestamp	Only return employees that have been updated since the specified timestamp.

Response

200

Results list.

Example

{
  "entries": [
    {
      "id": "7bBJMyz2",
      "employee_status_id": "1AayjkI2",
      "supervisor_id": null,
      "location_id": "29jLAnMs",
      "department_id": "3Bkl2jAH",
      "first_name": "John",
      "last_name": "Doe",
      "language": "en",
      "gender": "male",
      "email": "john.doe@privatemail.com",
      "company_email": "john.doe@companymail.org",
      "phone": "+39 1234567890",
      "company_phone": "+39 0471 234567"
      "photo_url": "https://www.onboard.org/assets/images/logo/onboard_logo_RGB-340.png",
      "birthday": "1992-06-15",
      "tax_number": "RSSMRA84A41F132U",
      "employee_number": "123",
      "nationality": "DE",
      "birthplace": "München",
      "street": "Dr. J. Köllensperger Str. 10/b",
      "city": "Lana",
      "postal_code": "39011",
      "region": "BZ",
      "country_code": "IT",
      "iban": "IT02930293209090",
      "swift": "BIC12345",
      "has_active_employee_job": true,
      "has_active_or_future_employee_job": true,
      "first_employee_job_from": "2024-01-01",
      "first_employee_job_to": null,
      "last_employee_job_from": "2024-01-01",
      "last_employee_job_to": null,
      "current_employee_job_from": "2024-01-01",
      "current_employee_job_to": null,
      "current_or_last_employee_job_from": "2024-01-01",
      "current_or_last_employee_job_to": null,
      "cf_110": null,
      "created_at": "2023-12-31T09:32:31.262Z",
      "updated_at": "2024-01-01T11:53:55.662Z"
    },
    {
      "id": "xy6q5M6d",
      "employee_status_id": "1AayjkI2",
      "supervisor_id": null,
      "location_id": "29jLAnMs",
      "department_id": "3Bkl2jAH",
      "first_name": "Jane",
      "last_name": "Doe",
      "language": "en",
      "gender": "male",
      "email": "jane.doe@privatemail.com",
      "company_email": "jane.doe@randomcompany.org",
      "phone": "+39 1234567890",
      "company_phone": "+39 0471 234567"
      "photo_url": "https://www.onboard.org/assets/images/logo/onboard_logo_RGB-340.png",
      "birthday": "1990-01-02",
      "tax_number": "RSSMRA84A41F132U",
      "employee_number": "123",
      "nationality": "IT",
      "birthplace": "Meran",
      "street": "Dr. J. Köllensperger Str. 10/b",
      "city": "Lana",
      "postal_code": "39011",
      "region": "BZ",
      "country_code": "IT",
      "iban": "IT02930293209090",
      "swift": "BIC12345",
      "has_active_employee_job": true,
      "has_active_or_future_employee_job": true,
      "first_employee_job_from": "2029-01-01",
      "first_employee_job_to": null,
      "last_employee_job_from": "2029-01-01",
      "last_employee_job_to": null,
      "current_employee_job_from": null,
      "current_employee_job_to": null,
      "current_or_last_employee_job_from": "2029-01-01",
      "current_or_last_employee_job_to": null,
      "cf_110": null,
      "created_at": "2023-12-31T09:32:31.262Z",
      "updated_at": "2024-01-01T11:53:55.662Z"
    }
  ],
  "current_page": 1,
  "per_page": 30,
  "total_entries": 2
}

Schema

Attribute	Type	Required	Description
id	string	readonly	Employee id.
created_at	datetime	readonly	Employee creation date.
updated_at	datetime	readonly	Employee last updated at.
language	string	false	Language of the employee as ISO 639-1 code. By default the language will be set to the preferred language of the business.
employee_status_id	string	false	Employee status id.
supervisor_id	string	readonly	Employee id of the supervisor.
location_id	string	readonly	Employee location id.
department_id	string	readonly	Employee department id.
has_active_employee_job	boolean	readonly	Describes if employee currently has an active employee job at the business.
has_active_or_future_employee_job	boolean	readonly	Describes if employee currently has an active employee job or will have one in the future.
first_employee_job_from	date	readonly	The start date of the employees first employee job.
first_employee_job_to	date	readonly	The end date of the employees first employee job.
last_employee_job_from	date	readonly	The start date of the employees last employee job (can be in the future).
last_employee_job_to	date	readonly	The end date of the employees last employee job (can be in the future).
current_employee_job_from	date	readonly	The start date of the employees current employee job.
current_employee_job_to	date	readonly	The end date of the employees current job.
current_or_last_employee_job_from	date	readonly	The start date of the employees current or last employee job (if employee has no active job, but has one in the future, this can be a future date).
current_or_last_employee_job_to	date	readonly	The end of the employees current or last employee job.

Note that the fields above are only the fixed fields. All custom fields are provided by the Employee Fields API endpoint.