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

**What are Contacts?**
The contacts grid provides a unified view of all people in your workspace:
- **Employees**: Internal team members from your own company
- **Organization Members**: External contacts from partner or customer organizations

This unified view allows you to search, filter, and manage all contacts in one place, regardless of whether they are internal employees or external contacts.

**What is returned:**
- Contact identification (ID, name, type)
- Contact information (email, phone, position, title, degree)
- Organization information (for organization members)
- Complete address details
- Employee-specific fields (employment mode, entry/exit dates, tax class)
- Organization member-specific fields (influence level, attitude, personality type)
- Status information (active, can login)
- Personal details (birth date, gender, avatar)

**Filtering and search:**
- Quick search across name, email, phone, position, organization, and address fields
- Advanced filtering by contact type, status, organization, and many other fields
- Sorting by any sortable field
- Server-side pagination for large contact lists

**Note:** This endpoint requires the `Contacts.canSeeContacts` permission. The contacts grid is the foundation for the Address Book feature, which can be synced via CardDAV or exported as vCard.

`GET /contacts/grid`