---
title: "Retrieves the collection of Employee resources."
method: GET
path: "/employees"
tags: ["Employee"]
---

# Retrieves the collection of Employee resources.

`GET /employees`

## Request

- Base URL: `https://example.myintranetapps.com/api`
- URL: `https://example.myintranetapps.com/api/employees`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/bossinsights/apis/boss-insights/docs/employees/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the collection of Employee resources.

## Query parameters

- `page` integer
- `itemsPerPage` integer

## Response `200`

Employee collection

- Employee[]
  - `id` string
  - `integration` string: The key of the integration source e.g. "quickbooks", or "xero"
  - `srcId` string
  - `firstName` string, nullable: First name of employee
  - `lastName` string, nullable: Last name of employee
  - `fullName` string, nullable
  - `active` boolean
  - `primaryPhone` string, nullable
  - `primaryAddr` string, nullable
  - `primaryAddrCity` string, nullable
  - `primaryAddrPostalcode` string, nullable
  - `primaryAddrState` string, nullable
  - `created` string, date-time, nullable
  - `modified` string, date-time, nullable
  - `link` string, nullable: Link to an external resource of the employee
  - `email` string, nullable
  - `mobilePhone` string, nullable
  - `payRate` string, nullable
  - `title` string, nullable
  - `gender` string, nullable
  - `birthDate` string, date-time, nullable
  - `hiredDate` string, date-time, nullable
  - `employeeNumber` string, nullable

---

[API](https://skmtc.dev/bossinsights/apis/boss-insights.md) - [All operations](https://skmtc.dev/bossinsights/apis/boss-insights/llms.txt) - [OpenAPI document](https://skmtc.dev/bossinsights/apis/boss-insights/revisions/d08a107895ad?raw)