---
search:
  tags:
    - employees
    - GET
seo:
  description: >-
    Retrieves a paginated grid of employee journal entries with filtering and…
    Reference for the GET /employees/journal endpoint in the Leadtime Public API
    API.
sidebar:
  badge: GET
  label: List employee journal entries
title: List employee journal entries
type: openapi-operation
---
Retrieves a paginated grid of employee journal entries with filtering and sorting capabilities. Filterable fields: id, employeeId, createdAt, createdBy, mood, reminder. Sortable fields: id, employeeId, createdAt, createdBy, mood, reminder.

**What are Employee Journals?**
Employee journals are used to document notes, observations, conversations, and feedback about employees. They help track interactions, performance notes, and important information about team members.

**What is returned:**
- Journal entry ID and associated employee ID
- Rich text content (body) converted to HTML format
- Mood indicator (Happy, Neutral, or Sad)
- Optional reminder date for follow-ups
- Creation and update timestamps
- Creator user ID

**Permission-based filtering:**
- Users with `Employees.manage` permission: See all journal entries for all employees
- Users without `Employees.manage` permission: Only see entries for their own employee record where `visibleToSubject = true`
- Employees can create their own entries, which are automatically marked as visible to themselves

**Filtering options:**
- Filter by `employeeId` to view entries for a specific employee
- Filter by `mood` to find entries with specific emotional indicators
- Filter by `createdAt` or `lastUpdated` to find entries within date ranges
- Filter by `reminder` to find entries with upcoming or past reminders

**Use cases:**
- Track conversations and agreements with employees
- Document feedback and observations about team members
- Set reminders for follow-up actions
- Maintain a chronological record of interactions with employees

<Operation source="api-reference" id="employeesjournalcontroller-listemployeejournals" />
