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

**What are Project Journals?**
Project journals are chronological records of important project events, observations, feedback, risks, and internal notes. They act as a timeline-based memory for projects, helping stakeholders track developments, assess communication, and prevent knowledge loss.

**What is returned:**
- Journal entry identification (ID, projectId)
- Content (body as HTML, mood indicator)
- Metadata (createdAt, createdBy, lastUpdated)
- Optional reminder date for follow-ups

**Journal Entry Features:**
- **Mood indicators**: Sad (negative reactions, problems), Neutral (factual observations), Happy (positive feedback, wins)
- **Rich text content**: Supports formatted text with paragraphs, highlighting, and structuring
- **Reminder function**: Optional date-based reminders for follow-ups or review points

**Filtering and search:**
- Filter by projectId to view entries for a specific project
- Filter by mood, creation date, creator, or reminder date
- Sort by any sortable field (default: createdAt descending)
- Server-side pagination for large journal lists

**Permissions:**
Automatically filters journal entries based on user permissions. Users without Projects.seeAnyProject permission will only see journal entries for projects they have access to.

<Operation source="api-reference" id="projectsjournalcontroller-listprojectjournals" />