---
search:
  tags:
    - contacts
    - GET
seo:
  description: >-
    Returns a paginated, filterable, and sortable grid of all contacts in the…
    Reference for the GET /contacts/grid endpoint in the Leadtime Public API
    API.
sidebar:
  badge: GET
  label: Get contacts grid
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.

<Operation source="api-reference" id="contactscontroller-getcontactsgrid" />
