---
search:
  tags:
    - employees
    - GET
seo:
  description: >-
    Returns a paginated, filterable, and sortable grid of all employees in the…
    Reference for the GET /employees/grid endpoint in the Leadtime Public API
    API.
sidebar:
  badge: GET
  label: Get employees grid
title: Get employees grid
type: openapi-operation
---
Returns a paginated, filterable, and sortable grid of all employees in the workspace.

**What are Employees?**
Employees are internal team members from your own company. Each employee can have:
- A user account with login access (if `canLogin` is true)
- Team assignments for organizational structure
- Employment details (entry/exit dates, employment mode, tax class)
- Personal information (name, email, phone, address, birth date)
- Professional details (position, title, degree)

**What is returned:**
- Employee identification (ID, name)
- Contact information (email, phone, position, title, degree)
- Complete address details (street, city, ZIP, country, house number)
- Employment information (employment mode, entry date, exit date, income tax class)
- Status information (isActive, canLogin, roleId)
- Team assignments (teamIds array)
- Personal details (birth date, avatar)
- Timestamps (createdAt)

**Filtering and search:**
- Quick search across name, email, phone, position, and address fields
- Advanced filtering by active status, employment mode, position, role, teams, and many other fields
- Sorting by any sortable field (default: firstName ascending)
- Server-side pagination for large employee lists

**Note:** This endpoint requires the `Employees.manage` permission. The employees grid is separate from the contacts grid, which combines employees and organization members.

<Operation source="api-reference" id="employeescontroller-getemployeesgrid" />
